您的用户是通过 Google Meet 使用 Google 课堂吗?请查看 Apps 脚本快速入门 - 了解如何在 Google Meet 课程中查看学生出席情况

Method: registrations.create

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

创建 Registration,让 Google 课堂开始将提供的 feed 中的通知发送到 cloudPubSubTopic 中提供的目的地。

返回已创建的 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

有关详情,请参阅 OAuth 2.0 概览