REST Resource: spaces.members | Google Chat | Google for Developers (original ) (raw )
リソース: Membershipユーザーまたは Chat 用アプリがスペースに招待されているか、スペースに参加しているか、スペースから退出しているかなど、Google Chat のメンバーシップ関係を表します。
JSON 表現
{ "name": string, "state": enum (MembershipState ), "role": enum (MembershipRole ), "createTime": string, "deleteTime": string, // Union field memberType can be only one of the following: "member": { object (User ) }, "groupMember": { object (Group ) } // End of list of possible types for union field memberType. }
フィールド
name
string ID。サーバーによって割り当てられたメンバーシップのリソース名。形式: spaces/{space}/members/{member}
state
enum (MembershipState ) 出力専用。メンバーシップの状態。
role
enum (MembershipRole ) 省略可。Chat スペース内のユーザーのロール。スペースで許可されるアクションを決定します。このフィールドは、members.patch の入力としてのみ使用できます。
createTime
string (Timestamp format) 省略可。変更不可。メンバーシップの作成時間(メンバーがスペースに参加したときや、スペースへの参加を招待されたときなど)。このフィールドは、インポート モードのスペースで過去のメンバーシップをインポートする場合を除き、出力専用です。
deleteTime
string (Timestamp format) 省略可。変更不可。メンバーシップの削除時間(メンバーがスペースから退出した、または削除された日時など)。このフィールドは、インポート モードのスペースで過去のメンバーシップをインポートする場合を除き、出力専用です。
共用体フィールド memberType。このメンバーシップに関連付けられているメンバー。今後、他のメンバー タイプがサポートされる可能性があります。memberType は次のいずれかになります。
member
object (User ) 省略可。メンバーシップに対応する Google Chat ユーザーまたはアプリ。Chat 用アプリがユーザーとして認証 されると、出力には user の name と type が入力されます。
groupMember
object (Group ) 省略可。メンバーシップが対応する Google グループ。Google グループのメンバーシップの読み取りまたは変更には、ユーザー認証 が必要です。
MembershipStateメンバーと Space の関係を指定します。今後、他のメンバーシップの状態もサポートされる可能性があります。
列挙型
MEMBERSHIP_STATE_UNSPECIFIED
デフォルト値。使用しないでください。
JOINED
ユーザーがスペースに追加され、スペースに参加できるようになります。
INVITED
ユーザーはスペースへの参加を招待されていますが、まだ参加していません。
NOT_A_MEMBER
ユーザーがスペースに属しておらず、スペースに参加するための招待が保留されていない。
MembershipRoleChat スペースでユーザーが許可されているアクションを表します。今後、列挙値が追加される可能性があります。
列挙型
MEMBERSHIP_ROLE_UNSPECIFIED
デフォルト値。users の場合: スペースのメンバーではありませんが、招待できます。Google Groups の場合: 常にこのロールが割り当てられます(他の列挙値が今後使用される可能性があります)。
ROLE_MEMBER
スペースのメンバー。Chat の UI では、このロールはメンバーと呼ばれます。ユーザーには、スペースにメッセージを送信するなどの基本的な権限があります。管理者とオーナーは、スペースでメンバーに追加の権限を付与できます。たとえば、次のような権限があります。 メンバーを追加または削除します。 スペースの詳細を変更します。 履歴をオンまたはオフにします。 @all を使用して、スペースのメンバー全員にメンションします。 スペースにインストールされている Chat 用アプリと Webhook を管理します。 ダイレクト メッセージと名前のないグループ会話では、全員にこの役割が割り当てられます。
ROLE_MANAGER
スペースのオーナー。Chat の UI では、このロールはオーナーと呼ばれます。ユーザーは、スペースを管理するためのスペース権限をすべて持っています。具体的には、次の権限があります。 スペース内の他のメンバーのロールをメンバー、マネージャー、オーナーに変更します。 スペースを削除します。 SpaceType.SPACE (名前付きスペース)でのみサポートされています。詳しくは、スペースのオーナーまたは管理者の役割について をご覧ください。
ROLE_ASSISTANT_MANAGER
スペースの管理者。Chat UI では、このロールは「管理者」と呼ばれます。ユーザーは ROLE_MEMBER のすべての基本権限を持ち、オーナーによって管理者権限のサブセットを付与されることがあります。デフォルトでは、マネージャーにはオーナーと同じ権限がありますが、以下の操作は行えません。 スペースを削除します。 他のスペース メンバーをオーナーにする。 オーナーの役割を変更する。 デフォルトでは、管理者の権限には以下が含まれます(ただしこれらに限定されません)。 他のメンバーをマネージャーにする。 スペースでメッセージを削除する。 スペースの権限を管理します。 スペースの設定で管理者が「メンバーを管理」権限を持っている場合、スペースへの参加リクエストの通知を受け取ります。 スペースを検索可能にします。 SpaceType.SPACE (名前付きスペース)でのみサポートされています。詳しくは、スペースの設定を管理する をご覧ください。
グループGoogle Chat の Google グループ。
JSON 表現
{ "name": string }
フィールド
name
string Google グループのリソース名。Cloud Identity Groups API のグループ を表します。形式: groups/{group}
メソッド
create
呼び出し元の Chat 用アプリ、ユーザー、または Google グループのメンバーシップを作成します。
delete
メンバーシップを削除します。
get
メンバーシップの詳細を返します。
list
スペースのメンバーシップを一覧表示します。
patch
メンバーシップを更新します。