Method: users.get

Ruft einen Nutzer ab

HTTP-Anfrage

GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
userKey

string

Identifiziert den Nutzer in der API-Anfrage. Der Wert kann die primäre E-Mail-Adresse, Alias-E-Mail-Adresse oder eindeutige Nutzer-ID des Nutzers sein.

Abfrageparameter

Parameter
customFieldMask

string

Eine durch Kommas getrennte Liste der Schemanamen. Alle Felder aus diesen Schemas werden abgerufen. Dieser Wert sollte nur festgelegt werden, wenn projection=custom.

projection

enum (Projection)

Welche Teilmenge der Felder für diesen Nutzer abzurufen ist.

viewType

enum (ViewType)

Gibt an, ob die öffentliche Ansicht mit Administratorzugriff oder die gesamte Domain des Nutzers abgerufen werden soll. Weitere Informationen finden Sie im Hilfeartikel Nutzer als Nicht-Administrator abrufen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

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

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/admin.directory.user
  • https://www.googleapis.com/auth/admin.directory.user.readonly

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

Projektion

Enums
BASIC Fügen Sie keine benutzerdefinierten Felder für den Nutzer ein.
CUSTOM Benutzerdefinierte Felder aus Schemas einschließen, die in customFieldMask angefordert wurden.
FULL Alle mit diesem Nutzer verknüpften Felder einschließen.

Ansichtstyp

Enums
admin_view Die Ergebnisse umfassen sowohl Felder, die nur für Administratoren und für öffentliche Domains verfügbar sind, für den Nutzer.
domain_public Die Ergebnisse enthalten nur Felder für den Nutzer, die für andere Nutzer in der Domain öffentlich sichtbar sind.