Method: registrations.create

建立 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

詳情請參閱授權指南。