Method: registrations.create

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

傳回建立的 Registration。目前這與引數相同，但已填入伺服器指派的欄位 (例如 expiryTime 和 id)。

請注意，系統會忽略 expiryTime 或 id 欄位指定的任何值。

雖然 Classroom 會盡可能驗證 cloudPubSubTopic 並傳回錯誤，但呼叫者必須負責確保該工具確實存在，且 Classroom 具備發布內容的權限。

這個方法可能會傳回下列錯誤代碼：

  • 如果符合以下情況，則為 PERMISSION_DENIED：
    • 已驗證使用者無權接收來自要求欄位的通知；或
    • 目前的使用者未針對所要求動態饋給的適當範圍，授予目前 Cloud 專案存取權。請注意，目前不支援網域層級授權委派。如果要求包含適當的範圍，但沒有任何授權，系統會傳回 [要求錯誤][@MissingGrant 錯誤]。
    • 另一個存取錯誤。
  • 如果符合以下情況，則為 INVALID_ARGUMENT：
    • 未指定 cloudPubsubTopic，或指定的 cloudPubsubTopic 無效；或
    • 未指定 feed，或指定的 feed 無效。
  • 如果符合以下情況，則為 NOT_FOUND：
    • 找不到指定的feed找不到，或是要求的使用者沒有判斷是否存在的權限；或
    • 找不到指定的cloudPubsubTopic，或是 Classroom 尚未取得發布權限。

HTTP 要求

POST https://classroom.googleapis.com/v1/registrations

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體包含 Registration 的例項。

回應主體

如果成功，回應主體會包含新建立的 Registration 例項。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/classroom.push-notifications

詳情請參閱授權指南。