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#、Java、JavaScript、Perl、Python などの C 言語系のプログラマに馴染みのあるルールを使用しています。
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
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-29 UTC。
[null,null,["最終更新日 2025-08-29 UTC。"],[],[],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```"]]
