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:
|
|
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:
|
|
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 eineaccountIdentifier
und eineaccountType
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 (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.
- 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 FelddisplayName
kann geändert werden. Andere Felder müssen entweder nicht festgelegt sein oder den aktuell aktiven Wert enthalten.