Consulta l'elenco dei metodi per questa risorsa alla fine di questa pagina.
Rappresentazioni delle risorse
Una risorsa Utenti rappresenta un account associato a un'azienda. L'account può essere specifico per un dispositivo o per un singolo utente (che può quindi utilizzarlo su più dispositivi). L'account potrebbe fornire accesso solo alla versione gestita di Google Play o ad altri servizi Google, a seconda del modello di identità:
- Il modello di identità del dominio gestito da Google richiede la sincronizzazione con le origini dell'Account Google (tramite
primaryEmail
). - Il modello di identità degli account Google Play gestito rappresenta un mezzo dinamico con cui le aziende possono creare account utente o dispositivo in base alle necessità. Questi account forniscono l'accesso alla versione gestita di Google Play.
{ "kind": "androidenterprise#user", "id": string, "managementType": string, "accountType": string, "primaryEmail": string, "accountIdentifier": string, "displayName": string }
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
accountIdentifier |
string |
Un identificatore univoco creato per questo utente, ad esempio "utente342" o "asset#44418". Non utilizzare informazioni che consentono l'identificazione personale (PII) per questa proprietà. Deve sempre essere impostato per gli utenti gestiti da EMM. Non impostato per gli utenti gestiti da Google. | |
accountType |
string |
Il tipo di account rappresentato da questo utente. userAccount può essere installato su più dispositivi, ma deviceAccount è specifico per un singolo dispositivo. Un utente gestito da EMM (emmManaged ) può essere di entrambi i tipi (userAccount , deviceAccount ), ma un utente gestito da Google (googleManaged ) è sempre un userAccount .
I valori accettati sono:
|
|
displayName |
string |
Il nome che verrà visualizzato nelle interfacce utente. L'impostazione di questa proprietà è facoltativa durante la creazione di utenti gestiti da EMM. Se imposti questa proprietà, utilizza qualcosa di generico sull'organizzazione (ad esempio "Example, Inc.") o sul tuo nome (come EMM). Non utilizzato per account utente gestiti da Google. | scrivibile |
id |
string |
L'ID univoco dell'utente. |
|
kind |
string |
||
managementType |
string |
L'entità che gestisce l'utente. Con gli utenti di googleManaged , la fonte di riferimento è Google, quindi i provider EMM devono assicurarsi che esista un Account Google per l'utente. Il provider EMM è a carico di emmManaged utenti.
I valori accettati sono:
|
|
primaryEmail |
string |
L'indirizzo email principale dell'utente, ad esempio "gbianchi@example.com". Verrà sempre impostata per gli utenti gestiti da Google e non per gli utenti gestiti da EMM. |
Metodi
- elimina
- Un utente gestito da EMM è stato eliminato.
- generateAuthenticationToken
- Genera un token di autenticazione che il client dei criteri dei dispositivi può utilizzare per eseguire il provisioning dell'account utente gestito da EMM su un dispositivo.
Il token generato è monouso e scade dopo alcuni minuti.
Puoi eseguire il provisioning di un massimo di 10 dispositivi per utente.
Questa chiamata funziona solo con gli account gestiti da EMM. - ricevi
- Recupera i dettagli di un utente.
- SetDisponibileDisponibileProdotto
- Recupera l'insieme di prodotti a cui l'utente può accedere. Nota: questo elemento è deprecato. Le nuove integrazioni non possono utilizzare questo metodo e possono fare riferimento ai nostri nuovi consigli.
- inserire
- Crea un nuovo utente gestito da EMM.
La risorsa Utenti trasferita nel corpo della richiesta deve includere un elementoaccountIdentifier
e un elementoaccountType
.Se un utente corrispondente esiste già con lo stesso identificatore account, verrà aggiornato con la risorsa. In questo caso solo il campo
displayName
può essere modificato. - list
- Cerca un utente in base all'indirizzo email principale. Questa opzione è supportata solo per gli utenti gestiti da Google. La ricerca dell'ID non è necessaria per gli utenti gestiti da EMM perché l'ID viene già restituito nel risultato della chiamata Users.insert.
- revokeDeviceAccess
- Revoca l'accesso a tutti i dispositivi attualmente forniti all'utente. L'utente non potrà più utilizzare la versione gestita del Play Store sui suoi dispositivi gestiti.
Questa chiamata funziona solo con gli account gestiti da EMM. - SetDisponibileProdottoSet
- Modifica l'insieme di prodotti a cui l'utente ha accesso (i prodotti autorizzati). Solo i prodotti approvati o quelli precedentemente approvati (prodotti con approvazione revocata) possono essere autorizzati. Nota: questo elemento è deprecato. Le nuove integrazioni non possono utilizzare questo metodo e possono fare riferimento ai nostri nuovi consigli.
- Aggiorna
- Aggiorna i dettagli di un utente gestito da EMM.
Può essere utilizzato solo con gli utenti gestiti da EMM (non da quelli gestiti da Google). Passa i nuovi dettagli nella risorsa Utenti nel corpo della richiesta. È possibile modificare solo il campodisplayName
. Gli altri campi devono essere non impostati o avere il valore attualmente attivo.