Groups Settings API 總覽

Groups Settings API 會更新並擷取現有 Google 群組的設定。您可以透過 API 執行以下操作：

  • 修改群組的內部和外部存取權設定。
  • 編輯群組通知。
  • 設定討論封存和訊息審核功能。
  • 自訂帳戶的使用者群組。

如要進一步瞭解如何使用 Google 群組或管理其他類型的群組，請參閱 Cloud Identity 說明文件。

Groups Settings API 資料模型

Groups Settings API 會在 Groups 資源上運作，這類資源代表帳戶使用者如何與其他使用者群組進行通訊和協作。每個群組都會以群組的電子郵件地址識別。

API 資料模型會根據帳戶群組的 Groups 集合。每個群組都有一組專屬的設定。

Groups Settings API 作業

您可以在 Groups Settings API 中呼叫群組設定方法，如下表所述：

作業 說明 REST HTTP 對應
get 取得客戶帳戶的群組設定。所有 get 作業都必須由已驗證的使用者授權。 群組 URI 上的 GET。
update 更新客戶帳戶的群組設定。所有更新作業都必須由已驗證的使用者授權。 群組 URI 上的 PUT。

JSON 和 Atom 資料格式

根據預設，Groups Settings API 會傳回 JSON 格式的資料。Atom 標記法是替代資料格式。JSON 和 Atom 資料格式都支援完整的讀寫功能。

JSON 是常見的網路格式，可用來表示任意資料結構。根據 json.org 的說明，JSON 是一種完全不依賴語言的文字格式，但會使用 C 系列語言 (包括 C、C++、C#、Java、JavaScript、Perl 和 Python) 程式設計師熟悉的慣例。

如要變更 API 的資料格式，請在要求的 URI 中加入 alt 查詢字串，例如：

JSON

GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json

Atom

GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom