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 中呼叫群組設定方法,如下表所述:

Operation 說明 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