Method: spaces.members.create

呼び出し元の Chat アプリ、ユーザー、Google グループのメンバーシップを作成します。他の Chat アプリのメンバーシップの作成はサポートされていません。メンバーシップを作成するときに、指定したメンバーの自動承認ポリシーがオフになっている場合、そのメンバーは招待された後、スペースへの招待を承諾してから参加する必要があります。それ以外の場合は、メンバーシップを作成すると、指定したスペースにメンバーが直接追加されます。

次のタイプの認証をサポートしています。

  • デベロッパー プレビューの管理者承認によるアプリ認証と、次の承認スコープ:

    • https://www.googleapis.com/auth/chat.app.memberships

  • 次のいずれかの認可スコープを使用したユーザー認証:

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app（呼び出し元のアプリをスペースに追加）
    • https://www.googleapis.com/auth/chat.import（インポート モードのスペースのみ）
    • ユーザー認証では、管理者アカウントが認証され、useAdminAccess が true で、次の認可スコープが使用されている場合に、管理者権限が付与されます。
      • https://www.googleapis.com/auth/chat.admin.memberships

使用例については、以下をご覧ください。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
parent

string

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

形式: 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.app.memberships
  • 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

詳しくは、認可ガイドをご覧ください。