Method: registrations.create

建立 Registration,讓 Classroom 開始傳送通知,從提供的 feed 傳送至 cloudPubSubTopic 中提供的目的地。

傳回已建立的 Registration。目前,這會與引數相同,但會填入伺服器指派的欄位,例如 expiryTimeid

請注意,系統會忽略 expiryTimeid 欄位中指定的任何值。

雖然 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

詳情請參閱授權指南