呼び出し元アプリのメンバーシップまたはアプリ メンバーシップを作成します。他のアプリのメンバーシップの作成はサポートされていません。例については、ユーザーまたは Google Chat アプリをスペースに招待または追加するをご覧ください。メンバーシップを作成する際に、指定したメンバーが自動承諾ポリシーを無効にしている場合、そのメンバーは招待されます。スペースに参加するには、スペースへの招待を承諾する必要があります。それ以外の場合、メンバーシップを作成すると、指定されたスペースにメンバーが直接追加されます。ユーザー認証が必要です。
追加するメンバーを指定するには、人間またはアプリのメンバーに membership.member.name
を設定するか、グループ メンバーに membership.group_member.name
を設定します。
2 人のユーザー間のスペースまたはダイレクト メッセージに通話アプリを追加するには、
users/app
を使用します。他のアプリをスペースに追加できません。人間のユーザーを追加するには、
users/{user}
を使用します。ここで、{user}
はユーザーのメールアドレスです。同じ Workspace 組織内のユーザーの場合、{user}
には People API のユーザーのid
や、Directory API のユーザーのid
を指定できます。たとえば、user@example.com
の People API ユーザー プロフィール ID が123456789
の場合、membership.member.name
をusers/user@example.com
またはusers/123456789
に設定することで、ユーザーをスペースに追加できます。名前付きスペースに Google グループを追加または招待するには、
groups/{group}
を使用します。ここで、{group}
は Cloud Identity Groups API からグループのid
です。たとえば、Cloud Identity Groups Lookup API を使用して、グループメールgroup@example.com
の ID123456789
を取得し、membership.group_member.name
をgroups/123456789
に設定することで、名前付きスペースにグループを追加したり、招待したりできます。グループのメールアドレスはサポートされていません。Google グループは名前付きスペースのメンバーとしてのみ追加できます。
HTTP リクエスト
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
parent |
必須。メンバーシップを作成するスペースのリソース名。 形式: spaces/{space} |
クエリ パラメータ
パラメータ | |
---|---|
useAdminAccess |
true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。発信ユーザーは、「Chat とスペースの会話の管理」権限を持つ Google Workspace 管理者である必要があります。
管理者アクセスを使用して、アプリのメンバーシップを作成したり、管理者の Google Workspace 組織外のユーザーのメンバーシップを作成したりすることはできません。 |
リクエスト本文
リクエストの本文には Membership
のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Membership
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
詳細については、承認ガイドをご覧ください。