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. Bei dem Wert kann es sich um die primäre E-Mail-Adresse, die Alias-E-Mail-Adresse oder die eindeutige Nutzer-ID des Nutzers handeln.

Abfrageparameter

Parameter
customFieldMask

string

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

projection

enum (Projection)

Teilmenge von Feldern, die für diesen Nutzer abgerufen werden sollen.

viewType

enum (ViewType)

Gibt an, ob die nur für Administratoren oder die domainweite öffentliche Ansicht des Nutzers abgerufen werden soll. Weitere Informationen finden Sie unter 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 Geben Sie keine benutzerdefinierten Felder für den Nutzer an.
CUSTOM Benutzerdefinierte Felder aus Schemas einschließen, die in customFieldMask angefordert wurden.
FULL Alle mit diesem Nutzer verknüpften Felder einschließen.

ViewType

Enums
admin_view Die Ergebnisse umfassen sowohl nur für den Administrator zugängliche Felder als auch für die Domain öffentlich zugängliche Felder 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.