如何使用Python获取Google Drive文件夹中所有图片的正确image_id？

我之前也碰到过一模一样的问题！别着急，咱们一步步排查原因，找到解决办法：

1. 先排除「快捷方式」的干扰 #

如果你的文件夹里存在快捷方式文件（不是原图片文件），API默认返回的是快捷方式本身的ID，而不是它指向的真实图片ID。这是最常见的原因。

解决办法： #

• 方法一：直接在查询中排除快捷方式，只获取真实图片文件：

# 过滤掉快捷方式，同时只筛选图片类型（可选但推荐）
query = f"parents = '{folder_id}' and mimeType != 'application/vnd.google-apps.shortcut' and mimeType contains 'image/'"
# 指定返回字段，确保拿到准确的文件ID
files = service.files().list(q=query, fields='files(id, name, mimeType)').execute()

# 遍历输出结果
for file in files.get('files', []):
    print(f"图片名称: {file['name']}, 真实ID: {file['id']}")

• 方法二：如果需要保留快捷方式并获取真实ID，要在请求中指定获取shortcutDetails字段：

query = f"parents = '{folder_id}' and (mimeType contains 'image/' or mimeType = 'application/vnd.google-apps.shortcut')"
# 必须在fields里包含shortcutDetails才能拿到目标ID
response = service.files().list(q=query, fields='files(id, name, mimeType, shortcutDetails)').execute()

for file in response.get('files', []):
    if file['mimeType'] == 'application/vnd.google-apps.shortcut':
        # 提取快捷方式指向的真实图片ID
        real_image_id = file['shortcutDetails']['targetId']
        print(f"快捷方式: {file['name']}, 对应真实图片ID: {real_image_id}")
    else:
        print(f"图片文件: {file['name']}, ID: {file['id']}")

2. 确认API调用账号与Drive界面账号一致 #

这是很容易忽略的点：如果你的Python代码使用的服务账号/登录账号，和你在浏览器Drive界面登录的不是同一个账号，那返回的文件集合完全不同，ID自然对不上。

检查方式： #

• 查看代码中认证环节使用的账号信息，确保和你手动登录Drive的账号一致；
• 如果用的是服务账号，需要确认该服务账号已经被共享了目标文件夹的访问权限。

3. 处理分页问题，确保获取所有文件 #

Google Drive API的files().list()接口默认只返回最多100个文件，如果你的文件夹里图片超过100张，只调用一次只能拿到第一页的结果，你可能误以为后面的文件ID不对。

解决办法：通过pageToken分页获取所有文件 #

all_images = []
page_token = None

while True:
    query = f"parents = '{folder_id}' and mimeType contains 'image/'"
    response = service.files().list(
        q=query,
        fields='nextPageToken, files(id, name)',
        pageToken=page_token,
        pageSize=100  # 可以指定每页最多返回100个（上限）
    ).execute()
    
    all_images.extend(response.get('files', []))
    page_token = response.get('nextPageToken')
    
    if not page_token:
        break  # 没有下一页时停止循环

# 现在all_images包含文件夹里所有图片的ID
for img in all_images:
    print(f"图片ID: {img['id']}, 名称: {img['name']}")

最后验证ID是否正确 #

你可以把API返回的ID放到Drive的访问链接里测试：https://drive.google.com/file/d/[API返回的ID]/view，如果能打开对应的图片，说明ID是正确的。

内容的提问来源于stack exchange，提问作者Sasha Casas