Google People API遇Sync Quota Exceeded：同步配额与提额咨询

核心配额规则 #

• 你之前在文档里看到的「携带同步令牌的请求享有独立配额」的规则是完全正确的，现在这条说明没有在公开文档的公开目录里展示，所以很难直接搜到原文。
• 两类请求的配额统计完全独立、互不挤占：
  • 不带syncToken的普通联系人读写请求，走的就是你在IAM和Admin页面能看到的那4类按分钟计数的配额：单用户每分钟临界读、单用户每分钟临界写、单用户每分钟普通写、单用户每分钟普通读
  • 携带syncToken的增量同步请求，走单独的「联系人同步配额」，这个配额是按单用户、滚动24小时周期累计计数的，不是按分钟计算，默认阈值是每24小时3000次/单用户。
• 你当前每5秒发1次请求的频率，连续跑一整夜的话，单天累计的请求数会超过1.7万次，远高于默认的3000次阈值，这也是你碰到Sync Quota Exceeded报错的核心原因。

同步配额的查询方式 #

• 这个独立的同步配额目前没有在控制台做展示：不管是IAM的配额管理页，还是People API的用量统计面板，都不会单独列出来这个配额的阈值和用量，所以你翻遍现有控制台页面找不到相关说明是正常的。
• 实时的同步配额数据不需要在控制台查询，直接看你发出的同步请求的HTTP响应头就行：
  • x-ratelimit-limit 字段返回当前周期的总配额额度
  • x-ratelimit-remaining 字段返回当前周期还能用多少次同步请求
  • 碰到配额超限报错时，错误响应里会直接告诉你配额要等多久才会重置，不用自己计算周期。

配额提额方式 #

• 这个同步配额是可以申请提升的，但没有自助申请入口，不能在IAM的配额列表里直接点申请，需要走Google Cloud的支持工单渠道提交申请。
• 申请的时候别上来就说“我要提高配额”，要按审核要求把信息写全，不然大概率被驳回：
  • 明确说明你的场景是做联系人增量同步，不是做批量的联系人读写操作
  • 算清楚你的业务实际需要的单用户24小时累计同步请求量，说清楚你为什么不能靠优化同步逻辑（比如拉长无变更时的同步间隔）把请求量压到默认阈值以内
  • 附上你触发Sync Quota Exceeded错误的具体时间、对应的请求和响应样例
• 提醒一句：别想着把频率拉得很高去申请提额，官方审核的时候会要求你把无效的同步请求砍掉再批额度。默认3000次/天的额度，如果你把同步间隔从5秒拉到1分钟，一天也才1440次请求，完全在默认阈值范围内，根本不需要提额。

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