如何理解 People API 的响应？答案

【问题标题】：how to make sense of People APIs responses?如何理解 People API 的响应？
【发布时间】：2021-06-23 09:31:03
【问题描述】：

在调用 People API 的端点时，尤其是在批处理请求中，我们会收到许多不同类型的错误响应。

错误信息中有一些有用的解释，例如：

配额指标“每日联系写入”（批量请求）超出配额成本 200 配额）'并限制'每日联系写入（批量请求成本服务“people.googleapis.com”的每位用户每天 200 个配额）消费者 'project_number:XXX'。

您可以检测到并正确处理，例如在重试该请求之前等待 24 小时，但有些更神秘，例如：

资源已用尽（例如检查配额）。

这确实提到了速率限制，但是针对哪个配额？是每个用户还是每个 GCP 项目？我们什么时候可以重试？

请注意，在同步用户帐户时，我们会在第一批调用中获得此信息，因此我猜这不是每个用户的配额，但文档中没有提及此类速率限制。

具体来说，有问题处理：

【问题讨论】：

您提出了哪些要求来获取这些错误？
Resource has been exhausted 发生在 batchCreateContacts 和 batchUpdateContacts 上，它可能发生在同步特定用户帐户时的第一个此类调用中，所以我猜它与声明的配额之一无关-per-user-account
这看起来可能是一个错误（特别是MY_CONTACTS_OVERFLOW_COUNT）。我会在Google Issue Tracker 上创建一个问题。如果您为 Workspace 帐户付费，也可以联系support。

【解决方案1】：

这是我到目前为止的内容，请随时编辑此答案以添加更多见解：

身份验证或 Google 后端问题：

配额和速率限制：

错误请求：

【讨论】：

贡献者@Ddorrance90 对their answer 中的MY_CONTACTS_OVERFLOW_COUNT 提出了解释。我认为作为对您的答案的更新，这将更有意义。但是，由于我对 API 不熟悉，因此我想让您有机会查看它，而不是仅仅编辑您的答案来填补这个空白。

【解决方案2】：

“MY_CONTACTS_OVERFLOW_COUNT”发生在您尝试将联系人插入 Google 帐户时，但他们的联系人数量已达到上限。

我不是 100% 确定，但对于“普通”/“免费”谷歌帐户，这个限制似乎约为 20,000。

【讨论】：