Method: registrations.create

创建 Registration，使 Google 课堂开始从提供的 feed 向 cloudPubSubTopic 中提供的目标位置发送通知。

返回创建的 Registration。目前，此属性与该参数相同，但其中填充了服务器分配的字段，例如 expiryTime 和 id。

请注意，为 expiryTime 或 id 字段指定的任何值都将被忽略。

虽然 Google 课堂可能会尽最大努力验证cloudPubSubTopic并返回错误，但调用者有责任确保相应信息存在，并且 Google 课堂有权向其中发布错误。

此方法可能会返回以下错误代码：

  • 如果满足以下条件，则为 PERMISSION_DENIED：
    • 经过身份验证的用户无权接收来自所请求字段的通知；或
    • 当前用户尚未授权访问当前 Cloud 项目并向其提供请求的 Feed 的适当范围。请注意，全网域授权功能目前不支持用于此用途。如果请求具有适当的范围，但不存在授权，则会返回 [Request Errors][@MissingGrant error]。
    • 再次发生访问错误。
  • 如果满足以下条件，则为 INVALID_ARGUMENT：
    • 未指定 cloudPubsubTopic，或者指定的 cloudPubsubTopic 无效；或
    • 未指定 feed，或者指定的 feed 无效。
  • 如果满足以下条件，则为 NOT_FOUND：
    • 找不到指定的feed，或者发出请求的用户无权确定它是否存在；或者
    • 无法找到指定的“cloudPubsubTopic”，或“课堂”尚未获得向其发布作业的权限。

HTTP 请求

POST https://classroom.googleapis.com/v1/registrations

网址采用 gRPC 转码语法。

请求正文

请求正文包含一个 Registration 实例。

响应正文

如果成功，响应正文将包含一个新创建的 Registration 实例。

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/classroom.push-notifications

有关详情，请参阅授权指南。