Method: registrations.create

创建 Registration,使 Google 课堂开始从所提供的 feedcloudPubSubTopic 中提供的目标发送通知。

返回创建的 Registration。目前,此值与参数相同,但会填充服务器分配的字段(例如 expiryTimeid)。

请注意,系统会忽略为 expiryTimeid 字段指定的任何值。

虽然 Google 课堂可能会尽最大努力验证 cloudPubSubTopic 并返回错误,但调用方有责任确保该文件存在且 Google 课堂有权向其发布内容。

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

  • PERMISSION_DENIED(如果):
    • 已通过身份验证的用户无权接收来自请求字段的通知;或者
    • 当前用户未向请求的 Feed 授予对当前 Cloud 项目的适当范围的访问权限。请注意,目前不支持出于此目的进行全网域授权。如果请求具有适当的范围,但不存在授予,则会返回 [请求错误][@MissingGrant 错误]。
    • 遇到了另一个访问权限错误
  • INVALID_ARGUMENT(如果):
    • 未指定 cloudPubsubTopic,或指定的 cloudPubsubTopic 无效;或者
    • 未指定 feed,或者指定的 feed 无效。
  • NOT_FOUND(如果):
    • 找不到指定的 feed,或者请求用户无权确定其是否存在;或者
    • 找不到指定的 cloudPubsubTopic,或者 Google 课堂未获授权向其发布内容。

HTTP 请求

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

网址采用 gRPC 转码语法。

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 范围:

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

如需了解详情,请参阅授权指南