使用Google Search Console API导出数据时遇权限错误求助

问题背景 #

我是SEO自动化和Python领域的纯新手，现在要做一个自动导出Google Search Console指定URL数据的工具——手里有400多个URL，手动导出效率太低，而且这是重复性工作，不想三个月后再手动折腾。

我尝试用Google Search Console API写Python脚本，已经在Google Cloud创建了独立项目、生成了凭证、设置了桌面应用的OAuth同意屏幕，权限范围也选了/webmaster和/webmasters.readonly，Client ID和Secret也没问题，但每次运行都报错："User doesn’t have sufficient permission for this site…"。我本身是已验证的GSC站点所有者，Cloud配置看起来都对，但就是没法通过API导出数据。

核心问题排查与修正 #

1. 脚本中siteUrl参数错误（最可能的原因） #

GSC API的siteUrl参数要求传入站点的根验证地址，而不是单个页面URL。比如你的站点验证的是https://example.com/，就必须用这个作为siteUrl，而不是https://example.com/page1。

你的脚本里循环时把单个URL传给了siteUrl，这会导致API认为你要访问的是这个单页站点，而你并没有验证过单页作为独立站点，所以触发权限错误。

2. 修正后的完整脚本 #

import csv
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# 替换为你的实际信息
SCOPES = ['https://www.googleapis.com/auth/webmasters.readonly']
JSON_FILE_PATH = '你的凭证JSON文件路径.json'
# 这里填你在GSC中验证的站点根地址，比如https://example.com/
SITE_URL = 'https://你的站点域名.com/'

# 初始化认证流程
flow = InstalledAppFlow.from_client_secrets_file(JSON_FILE_PATH, SCOPES)
creds = flow.run_local_server(port=0)

# 构建GSC服务
service = build('webmasters', 'v3', credentials=creds)

# 要查询的URL列表
target_urls = [
    'https://你的站点域名.com/page1',
    'https://你的站点域名.com/page2',
    # 更多URL...
]

data = []

# 注意：这里只需要调用一次API，用过滤器筛选多个URL，比循环调用更高效
request = {
    'startDate': '2024-01-01',  # 替换为实际开始日期
    'endDate': '2024-01-31',    # 替换为实际结束日期
    'dimensions': ['page', 'query'],
    'rowLimit': 10000,  # 调高上限，确保能获取所有匹配数据
    'startRow': 0,
    'aggregationType': 'auto',
    'searchType': 'web',
    'dimensionFilterGroups': [
        {
            'filters': [
                {'dimension': 'page', 'operator': 'in', 'expression': ','.join(target_urls)}
            ]
        }
    ]
}

# 调用API，这里用站点根地址作为siteUrl
response = service.searchanalytics().query(siteUrl=SITE_URL, body=request).execute()

# 处理返回结果
for row in response.get('rows', []):
    page_url = row['keys'][0]
    keyword = row['keys'][1]
    clicks = row['clicks']
    impressions = row['impressions']
    ctr = round(row['ctr'] * 100, 2)  # 转成百分比格式更直观
    position = round(row['position'], 2)
    data.append((page_url, keyword, clicks, impressions, ctr, position))

# 按曝光量降序排序
sorted_data = sorted(data, key=lambda x: x[3], reverse=True)

# 导出到CSV
output_csv_file = 'search_console_data.csv'
with open(output_csv_file, 'w', newline='', encoding='utf-8') as csvfile:
    csv_writer = csv.writer(csvfile)
    csv_writer.writerow(['URL', '关键词', '点击量', '曝光量', '点击率(%)', '平均排名'])
    csv_writer.writerows(sorted_data)

print(f'数据已导出到 {output_csv_file}')

3. 额外验证步骤 #

• 确认你的Google账号在GSC中是站点所有者，而不是仅编辑权限
• 检查Google Cloud项目的OAuth同意屏幕中，已将你的测试账号添加为测试用户（如果应用还未发布到生产）
• 运行脚本时，确保选择的登录账号是GSC中拥有权限的那个账号

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