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ätespezifisch oder für einen einzelnen Nutzer sein, der das Konto dann auf mehreren Geräten verwenden kann. Je nach Identitätsmodell kann über das Konto möglicherweise nur auf Managed Google Play oder auf andere Google-Dienste zugegriffen werden:

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

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}
Property-Name 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 für von EMM verwaltete Nutzer immer 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, aber ein deviceAccount gilt nur für ein einzelnes Gerät. Ein durch EMM verwalteter Nutzer (emmManaged) kann entweder vom Typ (userAccount, deviceAccount) sein, aber ein von Google verwalteter Nutzer (googleManaged) ist immer ein userAccount.

Zulässige Werte sind:
  • "deviceAccount"
  • "userAccount"
displayName string Der Name, der auf Benutzeroberflächen angezeigt wird. Das Festlegen dieses Attributs ist beim Erstellen von EMM-verwalteten Nutzern optional. Wenn Sie diese Eigenschaft festlegen, verwenden Sie einen generischen Namen zur Organisation (z. B. „Beispiel GmbH“) oder Ihren Namen (als EMM-Anbieter). Wird nicht für von Google verwaltete Nutzerkonten verwendet. Bearbeitbar
id string Die eindeutige ID des Nutzers.

kind string
managementType string Die Entität, die den Nutzer verwaltet. Bei googleManaged-Nutzern ist Google die wichtigste Quelle. Daher müssen EMMs darauf achten, dass für den Nutzer ein Google-Konto vorhanden ist. Bei emmManaged Nutzern ist der EMM-Anbieter zuständig.

Zulässige Werte sind:
  • "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 und nicht für von EMM verwaltete Nutzer.

Methoden

delete
Ein von einem EMM-Anbieter verwalteter Nutzer wurde gelöscht.
generateAuthenticationToken
Generiert ein Authentifizierungstoken, mit dem der Geräterichtlinienclient 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 von EMM verwalteten Konten.
get
Ruft die Details eines Nutzers ab.
getAvailableProductSet
Ruft die Produkte ab, auf die ein Nutzer zugreifen darf.
insert
Ein neuer, von EMM verwalteter Nutzer wird erstellt.

Die Ressource Users, die im Text der Anfrage übergeben wird, muss eine accountIdentifier und eine accountType enthalten.

Wenn bereits ein entsprechender Nutzer mit dieser Konto-ID vorhanden ist, wird der Nutzer mit der Ressource aktualisiert. In diesem Fall kann nur das Feld displayName geändert werden.

list
Sucht anhand der primären E-Mail-Adresse nach einem Nutzer. Diese Option wird nur für Nutzer unterstützt, die von Google verwaltet werden. Für EMM-verwaltete Nutzer ist kein Lookup der ID erforderlich, da die ID bereits im Ergebnis des Users.insert-Aufrufs zurückgegeben wird.
revokeDeviceAccess
Widerruft den Zugriff auf alle Geräte, die derzeit für den Nutzer bereitgestellt sind. Der Nutzer kann den Managed Play Store auf keinem seiner verwalteten Geräte mehr verwenden.

Dieser Anruf funktioniert nur bei von EMM verwalteten Konten.
setAvailableProductSet
Ändert die Gruppe von Produkten, auf die ein Nutzer zugreifen darf. Diese werden als Produkte auf der whitelisted bezeichnet. Nur Produkte, die genehmigt sind, oder Produkte, die zuvor genehmigt wurden (also Produkte mit aufgehobener Genehmigung), können auf die weiße Liste gesetzt werden. Hinweis: Dieses Element wurde eingestellt. Für neue Integrationen kann diese Methode nicht verwendet werden. Sie können sich auf unsere neuen Empfehlungen beziehen.
Update
Aktualisiert die Details eines EMM-verwalteten Nutzers.

Kann nur für von EMM verwaltete Nutzer verwendet werden, nicht für von Google verwaltete Nutzer. Ü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 aktuell aktiven Wert enthalten.