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, die Alias-E-Mail-Adresse oder die eindeutige Nutzer-ID des Nutzers sein.

Abfrageparameter

Parameter
customFieldMask

string

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

enum (Projection)

Welche Teilmenge von Feldern für diesen Nutzer abgerufen werden soll.
viewType

enum (ViewType)

Gibt an, ob die öffentliche Ansicht des Nutzers nur für Administratoren oder domainweit abgerufen werden soll. Weitere Informationen finden Sie im Hilfeartikel Nutzer als Nichtadministrator 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 hinzu.
CUSTOM Fügen Sie benutzerdefinierte Felder aus Schemas hinzu, die in customFieldMask angefordert wurden.
FULL Fügen Sie alle mit diesem Nutzer verknüpften Felder hinzu.

ViewType

Enums
admin_view Die Ergebnisse enthalten sowohl Felder, die nur für Administratoren sichtbar sind, als auch für alle Nutzer in der Domain.
domain_public Die Ergebnisse enthalten nur Felder für den Nutzer, die für andere Nutzer in der Domain öffentlich sichtbar sind.