Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档。
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
有关详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-04。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-09-04\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-09-04。"]]