Method: spaces.members.get

Gibt Details zu einer Mitgliedschaft zurück. Ein Beispiel finden Sie unter Details zur Mitgliedschaft eines Nutzers oder einer Google Chat-App abrufen.

Unterstützt die folgenden Arten der Authentifizierung:

  • App-Authentifizierung mit einem der folgenden Autorisierungsbereiche:

    • https://www.googleapis.com/auth/chat.bot
    • https://www.googleapis.com/auth/chat.app.memberships (erfordert Administratorgenehmigung)

  • Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships
    • Bei der Nutzerauthentifizierung werden Administratorberechtigungen gewährt, wenn ein Administratorkonto authentifiziert wird, useAdminAccess gleich true ist und einer der folgenden Autorisierungsbereiche verwendet wird:
      • https://www.googleapis.com/auth/chat.admin.memberships.readonly
      • https://www.googleapis.com/auth/chat.admin.memberships

HTTP-Anfrage

GET https://chat.googleapis.com/v1/{name=spaces/*/members/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Ressourcenname der abzurufenden Mitgliedschaft.

Wenn Sie die eigene Mitgliedschaft der App mithilfe der Nutzerauthentifizierung abrufen möchten, können Sie optional spaces/{space}/members/app verwenden.

Format: spaces/{space}/members/{member} oder spaces/{space}/members/app

Sie können die E-Mail-Adresse des Nutzers als Alias für {member} verwenden. Beispiel: spaces/{space}/members/example@gmail.com, wobei example@gmail.com die E‑Mail-Adresse des Google Chat-Nutzers ist.

Abfrageparameter

Parameter
useAdminAccess

boolean

Optional. Wenn true, wird die Methode mit den Administratorberechtigungen des Google Workspace-Nutzers ausgeführt.

Der anrufende Nutzer muss ein Google Workspace-Administrator mit der Berechtigung Unterhaltungen in Chats und Gruppenbereichen verwalten sein.

Erfordert die OAuth 2.0-Bereiche chat.admin.memberships oder chat.admin.memberships.readonly.

Die Nutzung von Administratorzugriff wird nicht unterstützt, wenn Sie App-Mitgliedschaften in einem Bereich erwerben möchten.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Membership.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Autorisierungsleitfaden.