Users

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Eine Nutzerressource stellt ein Konto dar, das mit einem Unternehmen verknüpft ist. Das Konto kann geräte- oder nutzerspezifisch sein. Der Nutzer kann das Konto dann auf mehreren Geräten verwenden. Je nach Identitätsmodell kann über das Konto nur auf den Managed Play Store oder auf andere Google-Dienste zugegriffen werden:

  • Das von Google verwaltete Identitätsmodell einer Domain erfordert eine Synchronisierung mit Google-Kontoquellen (über primaryEmail).
  • Das Identitätsmodell für verwaltete Google Play-Konten bietet Unternehmen die Möglichkeit, bei Bedarf Nutzer- oder Gerätekonten zu erstellen. Über diese Konten haben Sie Zugriff auf den Managed Play Store.

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}
Attributname Wert Beschreibung Hinweise
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“
displayName string Der Name, der in Benutzeroberflächen angezeigt wird. Das Festlegen dieser Property ist beim Erstellen von EMM-verwalteten Nutzern optional. Wenn Sie diese Property festlegen, verwenden Sie etwas allgemeines über die Organisation (z. B. „Beispiel GmbH“) oder Ihren Namen (als EMM). Wird nicht für von Google verwaltete Nutzerkonten verwendet. Bearbeitbar
id string Die eindeutige ID für den Nutzer.

kind string
managementType string Die Entität, die den Nutzer verwaltet. Bei googleManaged-Nutzern ist Google die verlässliche Datenquelle. Daher müssen EMM-Anbieter prüfen, ob für den Nutzer ein Google-Konto vorhanden ist. Bei emmManaged Nutzern ist das EMM verantwortlich.

Folgende Werte sind zulässig:
  • „emmManaged“
  • „googleManaged“
primaryEmail string Die primäre E-Mail-Adresse des Nutzers, z. B. „jschmidt@beispiel.de“. Wird immer für von Google verwaltete Nutzer festgelegt, nicht für verwaltete EMM-Nutzer.

Methoden

Delete
Einen vom EMM-Anbieter verwalteten Nutzer gelöscht.
generateAuthenticationToken (Authentifizierungstoken generieren)
Generiert ein Authentifizierungstoken, mit dem der Device Policy-Client das angegebene EMM-verwaltete Nutzerkonto auf einem Gerät bereitstellen kann. Das generierte Token kann nur einmal verwendet werden und läuft nach einigen Minuten ab.

Sie können maximal 10 Geräte pro Nutzer bereitstellen.

Dieser Anruf funktioniert nur bei über EMM verwalteten Konten.
erhalten
Ruft die Details eines Nutzers ab.
getAvailableProductSet
Ruft die Produkte ab, auf die ein Nutzer zugreifen kann. Hinweis: Dieses Element wurde eingestellt. Neue Integrationen können diese Methode nicht verwenden und können sich auf unsere neuen Empfehlungen beziehen.
Einfügen
Es wird ein neuer EMM-verwalteter Nutzer erstellt.

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.

list
Findet einen Nutzer anhand der primären E-Mail-Adresse. Dies wird nur für von Google verwaltete Nutzer unterstützt. Für EMM-verwaltete Nutzer ist keine Suche nach der ID erforderlich, da die ID bereits im Ergebnis des Users.insert-Aufrufs zurückgegeben wird.
revokeDeviceAccess festgelegt.
Widerruft den Zugriff auf alle Geräte, die dem Nutzer derzeit zur Verfügung gestellt werden. Der Nutzer kann den Managed Play Store auf keinem seiner verwalteten Geräte mehr verwenden.

Dieser Anruf funktioniert nur bei über EMM verwalteten Konten.
setAvailableProductSet
Damit wird die Gruppe von Produkten geändert, auf die ein Nutzer zugreifen kann (als Produkte auf der Zulassungsliste bezeichnet). Nur Produkte, die genehmigt wurden oder bereits genehmigt wurden (Produkte mit aufgehobener Genehmigung), können auf die Zulassungsliste gesetzt werden. Hinweis: Dieses Element wurde eingestellt. Neue Integrationen können diese Methode nicht verwenden und können sich auf unsere neuen Empfehlungen beziehen.
Aktualisieren
Aktualisiert die Details eines EMM-verwalteten Nutzers.

Kann nur von EMM-verwalteten Nutzern verwendet werden, nicht von Google-Nutzern. Übergeben Sie die neuen Details in der Ressource Users im Anfragetext. Nur das Feld displayName kann geändert werden. Andere Felder müssen entweder nicht festgelegt sein oder den derzeit aktiven Wert haben.