建立 Registration
,讓 Classroom 開始傳送通知,從提供的 feed
傳送至 cloudPubSubTopic
中提供的目的地。
傳回已建立的 Registration
。目前,這會與引數相同,但會填入伺服器指派的欄位,例如 expiryTime
和 id
。
請注意,系統會忽略 expiryTime
或 id
欄位中指定的任何值。
雖然 Classroom 會盡力驗證 cloudPubSubTopic
並傳回錯誤,但呼叫端有責任確保 cloudPubSubTopic
存在,且 Classroom 有權發布至該位置。
這個方法可能會傳回以下錯誤代碼:
PERMISSION_DENIED
如果:- 已驗證的使用者沒有權限接收所要求欄位的通知。
- 目前的使用者未授予目前 Cloud 專案的存取權,且該專案的範圍不符合要求的動態饋給。請注意,系統目前不支援全網域委派權限的功能。如果要求具有適當的範圍,但沒有授權,系統會傳回 [要求錯誤][
@MissingGrant
錯誤]。 - 發生其他存取錯誤。
INVALID_ARGUMENT
如果:- 未指定
cloudPubsubTopic
,或指定的cloudPubsubTopic
無效;或 - 未指定
feed
,或是指定的feed
無效。
- 未指定
NOT_FOUND
如果:- 無法找到指定的
feed
,或是要求使用者沒有權限判斷該feed
是否存在; - 無法找到指定的
cloudPubsubTopic
,或是 Classroom 未獲得發布至該cloudPubsubTopic
的權限。
- 無法找到指定的
HTTP 要求
POST https://classroom.googleapis.com/v1/registrations
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體包含 Registration
的例項。
回應主體
如果成功,回應主體會包含新建立的 Registration
例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/classroom.push-notifications
詳情請參閱授權指南。