Google Classroom API 错误结构

Classroom API 会返回错误信息，帮助开发者调试问题，并向最终用户提供实用可行的信息。本指南介绍了如何解析 API 返回的错误信息。

Classroom API 会返回两个级别的错误信息：

• 标头中的 HTTP 错误代码。
• 响应正文中的对象，包含其他详细信息。

错误消息结构

响应正文中返回的错误包括以下字段：

• code：数字 HTTP 错误代码。例如 403。
• message：有关错误的更多详细信息。如果错误消息可用，系统会在其前面添加 @ 和特定错误类型。例如 @ClassroomApiDisabled。
• status：HTTP 请求状态。例如 PERMISSION_DENIED 或 NOT_FOUND。

如果请求失败并显示 ClassroomApiDisabled 错误，则响应将如下所示：

{
  "error": {
    "code": 403,
    "message": "@ClassroomApiDisabled The user is not permitted to access the Classroom API.",
    "status": "PERMISSION_DENIED"
  }
}

您可以使用响应正文来帮助您调试错误原因，并向用户提供有用的信息。检查特定错误消息时，请添加尾随空格，以避免匹配以相同字符串开头的其他值。在提供的错误示例中，您可以检查 message 字段是否以 "@ClassroomApiDisabled " 开头，以便向用户显示相应的信息。

如需了解 Classroom API 可能会返回的一些错误，请参阅常见错误页面。