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 的權限。