Method: spaces.members.create

呼び出し元アプリのメンバーシップまたはアプリ メンバーシップを作成します。他のアプリのメンバーシップの作成はサポートされていません。例については、ユーザーまたは 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 の ID 123456789 を取得し、membership.group_member.name を groups/123456789 に設定することで、名前付きスペースにグループを追加したり、招待したりできます。グループのメールアドレスはサポートされていません。Google グループは名前付きスペースのメンバーとしてのみ追加できます。

HTTP リクエスト

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。メンバーシップを作成するスペースのリソース名。

形式: spaces/{space}

クエリ パラメータ

パラメータ
useAdminAccess

boolean

true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

発信ユーザーは、「Chat とスペースの会話の管理」権限を持つ Google Workspace 管理者である必要があります。

chat.admin.memberships OAuth 2.0 スコープが必要です。

管理者アクセスを使用して、アプリのメンバーシップを作成したり、管理者の 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

詳細については、承認ガイドをご覧ください。