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。 |
根據預設，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
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-29 (世界標準時間)。
[null,null,["上次更新時間：2025-08-29 (世界標準時間)。"],[],[],null,["# Groups Settings API overview\n\nThe Groups Settings API updates and retrieves settings for an existing\n[Google Group](https://support.google.com/a/topic/25838?&ref_topic=9197). Through\nthe API, you can do the following:\n\n- Modify a group's settings for internal and external group access.\n- Edit the group's notifications.\n- Configure discussion archiving and message moderation.\n- Customize your account's user groups.\n\nFor more ways to work with Google Groups, or manage other types of groups, see the\n[Cloud Identity documentation](https://cloud.google.com/identity/docs).\n\n### Groups Settings API data model\n\nThe Groups Settings API operates on a `Groups` resource which represents how users\nwithin an account communicate and collaborate with groups of other people. Each group is identified\nby the group's email address.\n\nThe API data model is based on the `Groups` collection of the account's groups. Each\ngroup has a unique set of configuration settings.\n\n### Groups Settings API operations\n\nYou can call group settings methods in the Groups Settings API, as described in the following\ntable:\n\n| Operation | Description | REST HTTP mappings |\n|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------|\n| `get` | Gets a group's settings for a customer's account. All get operations must be authorized by an [authenticated](/workspace/guides/auth-overview) user. | `GET` on a group URI. |\n| `update` | Updates a group's settings for a customer's account. All update operations must be authorized by an [authenticated](/workspace/guides/auth-overview) user. | `PUT` on a group URI. |\n\nJSON and Atom data formats\n--------------------------\n\nBy default, the Groups Settings API returns data in JSON format. The Atom notation is an alternate\ndata format. Both the JSON and Atom data formats support full read-write capabilities.\n\nJSON is a common\ninternet format that provides a method of representing arbitrary data structures. According to\n[json.org](http://www.json.org), JSON is a text format\nthat is completely language-independent but uses conventions that are familiar to programmers of\nthe C-family of languages, including C, C++, C#, Java, JavaScript, Perl, and Python.\n\n\u003cbr /\u003e\n\nTo change the API's data format, include the `alt` query string in your request's\nURI---for example:\n\n### JSON\n\n```\nGET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json\n```\n\n### Atom\n\n```\nGET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom\n```"]]
