このガイドでは、Google Chat API の Membership リソースで get() メソッドを使用して、スペースのメンバーシップの詳細を取得する方法について説明します。
Google Workspace 管理者は、get() メソッドを呼び出して、Google Workspace 組織のメンバーシップに関する詳細情報を取得できます。
Membership リソースは、ユーザーまたは Google Chat アプリがスペースに招待されているか、スペースに参加しているか、スペースに参加していないかを表します。
アプリ認証で認証すると、Chat 用アプリは Google Chat でアクセスできるスペース(メンバーになっているスペースなど)からメンバーシップを取得できますが、Chat 用アプリのメンバーシップ(アプリ自身のメンバーシップを含む)は除外されます。ユーザー認証で認証すると、認証されたユーザーがアクセスできるスペースのメンバーシップが返されます。
前提条件
Node.js
- Google Chat へのアクセス権を持つ Business または Enterprise の Google Workspace アカウント。
 
- 環境を設定します。
    
- Google Cloud プロジェクトを作成します。
 - OAuth 同意画面を構成する。
 - Chat 用アプリの名前、アイコン、説明を使用して、Google Chat API を有効にして構成します。
 - Node.js Cloud クライアント ライブラリをインストールします。
 - Google Chat API リクエストで認証を行う方法に基づいて、アクセス認証情報を作成します。
        
- Chat ユーザーとして認証するには、OAuth クライアント ID 認証情報を作成し、認証情報を 
credentials.jsonという名前の JSON ファイルとしてローカル ディレクトリに保存します。 - Chat 用アプリとして認証するには、サービス アカウントの認証情報を作成し、認証情報を 
credentials.jsonという名前の JSON ファイルとして保存します。 
 - Chat ユーザーとして認証するには、OAuth クライアント ID 認証情報を作成し、認証情報を 
 
 - ユーザーとして認証するか、Chat 用アプリとして認証するかに基づいて、 認証スコープを選択します。
 
- 認証済みユーザーまたは通話中の Chat 用アプリがメンバーである Google Chat スペース。Chat 用アプリとして認証するには、Chat 用アプリをスペースに追加します。
 
Python
- Google Chat へのアクセス権を持つ Business または Enterprise の Google Workspace アカウント。
 
- 環境を設定します。
    
- Google Cloud プロジェクトを作成します。
 - OAuth 同意画面を構成する。
 - Chat 用アプリの名前、アイコン、説明を使用して、Google Chat API を有効にして構成します。
 - Python Cloud クライアント ライブラリをインストールします。
 - Google Chat API リクエストで認証を行う方法に基づいて、アクセス認証情報を作成します。
        
- Chat ユーザーとして認証するには、OAuth クライアント ID 認証情報を作成し、認証情報を 
credentials.jsonという名前の JSON ファイルとしてローカル ディレクトリに保存します。 - Chat 用アプリとして認証するには、サービス アカウントの認証情報を作成し、認証情報を 
credentials.jsonという名前の JSON ファイルとして保存します。 
 - Chat ユーザーとして認証するには、OAuth クライアント ID 認証情報を作成し、認証情報を 
 
 - ユーザーとして認証するか、Chat 用アプリとして認証するかに基づいて、 認証スコープを選択します。
 
- 認証済みユーザーまたは通話中の Chat 用アプリがメンバーである Google Chat スペース。Chat 用アプリとして認証するには、Chat 用アプリをスペースに追加します。
 
Java
- Google Chat へのアクセス権を持つ Business または Enterprise の Google Workspace アカウント。
 
- 環境を設定します。
    
- Google Cloud プロジェクトを作成します。
 - OAuth 同意画面を構成する。
 - Chat 用アプリの名前、アイコン、説明を使用して、Google Chat API を有効にして構成します。
 - Java Cloud クライアント ライブラリをインストールします。
 - Google Chat API リクエストで認証を行う方法に基づいて、アクセス認証情報を作成します。
        
- Chat ユーザーとして認証するには、OAuth クライアント ID 認証情報を作成し、認証情報を 
credentials.jsonという名前の JSON ファイルとしてローカル ディレクトリに保存します。 - Chat 用アプリとして認証するには、サービス アカウントの認証情報を作成し、認証情報を 
credentials.jsonという名前の JSON ファイルとして保存します。 
 - Chat ユーザーとして認証するには、OAuth クライアント ID 認証情報を作成し、認証情報を 
 
 - ユーザーとして認証するか、Chat 用アプリとして認証するかに基づいて、 認証スコープを選択します。
 
- 認証済みユーザーまたは通話中の Chat 用アプリがメンバーである Google Chat スペース。Chat 用アプリとして認証するには、Chat 用アプリをスペースに追加します。
 
Apps Script
- Google Chat へのアクセス権を持つ Business または Enterprise の Google Workspace アカウント。
 
- 環境を設定します。
    
- Google Cloud プロジェクトを作成します。
 - OAuth 同意画面を構成する。
 - Chat 用アプリの名前、アイコン、説明を使用して、Google Chat API を有効にして構成します。
 - スタンドアロンの Apps Script プロジェクトを作成し、高度な Chat サービスを有効にします。
 - このガイドでは、ユーザー認証またはアプリ認証のいずれかを使用する必要があります。Chat 用アプリとして認証するには、サービス アカウントの認証情報を作成します。手順については、Google Chat アプリとして認証と認可を行うをご覧ください。
 
 - ユーザーとして認証するか、Chat 用アプリとして認証するかに基づいて、 認証スコープを選択します。
 
- 認証済みユーザーまたは通話中の Chat 用アプリがメンバーである Google Chat スペース。Chat 用アプリとして認証するには、Chat 用アプリをスペースに追加します。
 
メンバーシップの詳細を取得する
Google Chat のメンバーシップの詳細を取得するには、リクエストで次の情報を渡します。
- アプリ認証では、
chat.bot認証スコープを指定します。ユーザー認証では、chat.memberships.readonlyまたはchat.memberships認可スコープを指定します。ベスト プラクティスとして、アプリが機能する範囲で最も制限の大きいスコープを選択します。 GetMembership()メソッドを呼び出します。- 取得するメンバーシップの 
nameを渡します。Google Chat のメンバーシップ リソースからメンバーシップ名を取得します。 
ユーザー認証でメンバーシップを取得する
ユーザー認証でメンバーシップを取得する方法は次のとおりです。
Node.js
Python
Java
Apps Script
このサンプルを実行するには、次の値を置き換えます。
SPACE_NAME: スペースのnameからの ID。ID は、ListSpaces()メソッドを呼び出すか、スペースの URL から取得できます。MEMBER_NAME: メンバーのnameからの ID。ID を取得するには、ListMemberships()メソッドを呼び出します。
Chat API は、指定されたメンバーシップの詳細を示す Membership のインスタンスを返します。
アプリ認証でメンバーシップを取得する
アプリ認証でメンバーシップを取得する方法は次のとおりです。
Node.js
Python
Java
Apps Script
このサンプルを実行するには、次の値を置き換えます。
SPACE_NAME: スペースのnameからの ID。ID は、ListSpaces()メソッドを呼び出すか、スペースの URL から取得できます。MEMBER_NAME: メンバーのnameからの ID。ID を取得するには、ListMemberships()メソッドを呼び出します。
Chat API は、指定されたメンバーシップの詳細を示す Membership のインスタンスを返します。
Google Workspace 管理者としてメンバーシップの詳細を取得する
Google Workspace 管理者は、GetMembership() メソッドを呼び出して、Google Workspace 組織内の任意のユーザーのメンバーシップの詳細を取得できます。
Google Workspace 管理者としてこのメソッドを呼び出すには、次の操作を行います。
- ユーザー認証を使用してメソッドを呼び出し、管理者権限を使用してメソッドを呼び出すことをサポートする認可スコープを指定します。
 - リクエストで、クエリ パラメータ 
useAdminAccessをtrueに指定します。 
詳細と例については、Google Workspace 管理者として Google Chat スペースを管理するをご覧ください。
関連トピック
- スペースのメンバーを一覧表示する。
 - ユーザーまたは Chat 用アプリをスペースに招待または追加する。
 - Google Chat スペースでユーザーのメンバーシップを更新する。
 - スペースからユーザーまたは Chat 用アプリを削除する。