REST Resource: groups

リソース: Group

Google グループでは、グループのメールアドレスを使用して特定のグループにメッセージを送信できます。一般的なタスクの詳細については、デベロッパー ガイドをご覧ください。

他の種類のグループについては、Cloud Identity Groups API のドキュメントをご覧ください。

注: API を呼び出すユーザー（またはサービス アカウントによる権限借用を受けている）には、特権管理者やグループ管理者などの管理 API グループ権限を含むロールを割り当てる必要があります。

JSON 表現 
{
  "id": string,
  "email": string,
  "name": string,
  "description": string,
  "adminCreated": boolean,
  "directMembersCount": string,
  "kind": string,
  "etag": string,
  "aliases": [
    string
  ],
  "nonEditableAliases": [
    string
  ]
}
フィールド
id

string

読み取り専用。グループの一意の ID。グループ id は、グループ リクエスト URI の groupKey として使用できます。
email

string

グループのメールアドレス。アカウントに複数のドメインがある場合は、メールアドレスに適切なドメインを選択します。email は一意である必要があります。グループの作成時にこのプロパティは必須です。グループのメールアドレスには、ユーザー名と同じ文字の使用ルールが適用されます。詳しくは、ヘルプセンターをご覧ください。
name

string

グループの表示名。
description

string

ユーザーがグループの目的を判断する際に役立つ詳細な説明。たとえば、グループに参加する必要があるユーザー、グループに送信するメッセージの種類、グループに関するよくある質問へのリンク、関連グループに関する情報を含めることができます。最大長は 4,096 文字です。
adminCreated

boolean

読み取り専用。このグループがユーザーではなく管理者によって作成された場合、値は true です。
directMembersCount

string (int64 format)

グループの直接メンバーであるユーザーの数。グループがこのグループのメンバー（親）である場合、子グループのメンバーは親グループの directMembersCount プロパティではカウントされません。
kind

string

API リソースのタイプ。グループ リソースの場合、値は admin#directory#group です。
etag

string

リソースの ETag。
aliases[]

string

読み取り専用。グループのエイリアス メールアドレスのリスト。グループのエイリアスを追加、更新、削除するには、groups.aliases メソッドを使用します。グループの POST または PUT リクエスト内で編集された場合、編集は無視されます。
nonEditableAliases[]

string

読み取り専用。アカウントのプライマリ ドメインまたはサブドメインに含まれない、グループの編集不可のエイリアス メールアドレスのリスト。グループで使用されている有効なメールアドレスです。これは、グループに対する API のレスポンスで返される読み取り専用のプロパティです。グループの POST または PUT リクエスト内で編集された場合、編集は無視されます。

Methods

delete

 グループを削除します。

get

 グループのプロパティを取得します。

insert

 グループを作成する。

list

 ドメインのグループ、または userKey で指定されたユーザーのすべてのグループを取得します（ページ分けされます）。

patch

 グループのプロパティを更新します。

update

 グループのプロパティを更新します。