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 speziell 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: <ph type="x-smartling-placeholder">
    </ph>
  • „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 über die 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: <ph type="x-smartling-placeholder">
    </ph>
  • „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, das der Geräterichtlinienclient für Folgendes verwenden kann Das angegebene EMM-verwaltete Nutzerkonto auf einem Gerät bereitstellen. 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 mit 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.

Ressource Users , die im Text der Anfrage übergeben werden, sollte ein accountIdentifier und accountType.

Wenn bereits ein entsprechender Nutzer mit dieser Konto-ID vorhanden ist, wird der Nutzer mit der Ressource aktualisiert. In diesem Fall ist nur das Tag Das Feld „displayName“ kann 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. Suche der ID ist nicht für EMM-verwaltete Nutzer erforderlich, da die ID bereits im Ergebnis des Aufrufs Users.insert.
revokeDeviceAccess
Widerruft den Zugriff auf alle Geräte, die derzeit für den Nutzer bereitgestellt sind. Der Nutzer können den Managed Play Store in keinem ihrer verwaltete Geräte.

Dieser Anruf funktioniert nur mit von EMM verwalteten Konten.
setAvailableProductSet
Ändert die Produkte, auf die ein Nutzer zugreifen darf (bezeichnet als als Produkte auf der weißen Liste. Nur Produkte, die genehmigt oder Produkte, die bereits freigegeben wurden (Produkte mit aufgehobener Genehmigung) auf die Zulassungsliste gesetzt werden.
Update
Aktualisiert die Details eines EMM-verwalteten Nutzers.

Kann nur für Nutzer verwendet werden, die vom EMM-Anbieter verwaltet werden, nicht für Nutzer, die von Google verwaltet werden. Übergeben Sie die neuen Details in der Nutzer Ressource im Anfragetext. Nur das Feld displayName geändert werden kann. Andere Felder müssen entweder nicht festgelegt werden oder den Parameter derzeit aktiver Wert.