Users: insert

Erstellt einen neuen EMM-verwalteten Nutzer.

Die im Text der Anfrage übergebene Ressource Users sollte eine accountIdentifier und eine accountType enthalten.

Wenn ein entsprechender Nutzer mit derselben Kontokennung bereits vorhanden ist, wird er mit der Ressource aktualisiert. In diesem Fall kann nur das Feld displayName geändert werden.

Anfragen

HTTP-Anfrage

POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users

Parameter

Parametername Wert Beschreibung
Pfadparameter
enterpriseId string Die ID des Unternehmens.

Autorisierung

Für diese Anfrage ist eine Autorisierung in folgendem Umfang erforderlich:

Umfang
https://www.googleapis.com/auth/androidenterprise

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie im Anfragetext eine Ressource vom Typ Users mit den folgenden Attributen an:

Attributname Wert Beschreibung Hinweise
Erforderliche Properties
accountIdentifier string Eine eindeutige Kennung, die Sie für diesen Nutzer erstellen, z. B. „user342“ oder „asset#44418“. Verwenden Sie für diese Property keine personenidentifizierbaren Informationen. Muss immer für EMM-verwaltete Nutzer festgelegt werden. Nicht für von Google verwaltete Nutzer festgelegt.
accountType string Der Kontotyp, den dieser Nutzer repräsentiert. Ein userAccount kann auf mehreren Geräten installiert werden, ein deviceAccount ist jedoch gerätespezifisch. Ein EMM-verwalteter Nutzer (emmManaged) kann entweder vom Typ (userAccount, deviceAccount) sein, aber von Google verwaltete Nutzer (googleManaged) sind immer userAccount.

Folgende Werte sind zulässig:
  • deviceAccount
  • userAccount

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Nutzerressource im Antworttext zurückgegeben.