Method: registrations.create

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

返回创建的 Registration。目前，此值与参数相同，但会填充服务器分配的字段（例如 expiryTime 和 id）。

请注意，系统会忽略为 expiryTime 或 id 字段指定的任何值。

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

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

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