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#、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