创建 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 课堂未获授权向其发布内容。
- 找不到指定的
HTTP 请求
POST https://classroom.googleapis.com/v1/registrations
网址采用 gRPC 转码语法。
请求正文
请求正文包含一个 Registration
实例。
响应正文
如果成功,响应正文将包含一个新创建的 Registration
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/classroom.push-notifications
如需了解详情,请参阅授权指南。