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 尚未取得發布權限。