Per un elenco di metodi per questa risorsa, vai 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 potrà quindi utilizzare l'account 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 gestiti fornisce alle aziende un mezzo dinamico per creare account utente o dispositivo in base alle esigenze. Questi account forniscono 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 l'utente, ad esempio "user342" o "risorsa n. 44418". Non utilizzare informazioni che consentono l'identificazione personale (PII) per questa proprietà. Deve sempre essere impostata per gli utenti gestiti da EMM. Non impostato per gli utenti gestiti da Google. | |
accountType |
string |
Il tipo di account rappresentato da questo utente. Un userAccount può essere installato su più dispositivi, ma un 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 quando crei utenti gestiti da EMM. Se imposti questa proprietà, utilizza un nome generico sull'organizzazione (come "Esempio, S.p.A.") o il tuo nome (come EMM). Non vengono utilizzati per gli account utente gestiti da Google. | accessibile in scrittura |
id |
string |
L'ID univoco dell'utente. |
|
kind |
string |
||
managementType |
string |
L'entità che gestisce l'utente. Per gli utenti di googleManaged , la fonte di riferimento è Google, quindi i provider EMM devono assicurarsi che l'utente disponga di un Account Google. Con emmManaged utenti, l'EMM è responsabile.
I valori accettati sono:
|
|
primaryEmail |
string |
L'indirizzo email principale dell'utente, ad esempio "jsmith@example.com". Verrà sempre impostata per gli utenti gestiti da Google e non per gli utenti gestiti EMM. |
Metodi
- elimina
- È stato eliminato un utente gestito da EMM.
- generateAuthenticationToken
- Genera un token di autenticazione che il client dei criteri dei dispositivi può utilizzare per
eseguire il provisioning dell'account utente gestito dall'EMM specificato su un dispositivo.
Il token generato è monouso e scade dopo qualche minuto.
Puoi eseguire il provisioning di un massimo di 10 dispositivi per utente.
Questa chiamata funziona solo con gli account gestiti da EMM. - trova
- Recupera i dettagli di un utente.
- getAvailableProductSet
- Consente di recuperare l'insieme di prodotti a cui un utente ha il diritto di accedere.
- inserisci
- Crea un nuovo utente gestito da EMM.
La risorsa Utenti passati nel corpo della richiesta devono includere unaccountIdentifier
eaccountType
.Se esiste già un utente corrispondente con lo stesso identificatore di account, l'utente 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. Questo attributo è supportato solo per gli utenti gestiti da Google. La ricerca dell'ID non è necessaria per gli utenti gestiti da EMM perché l'ID è già restituito nella il risultato della chiamata Users.insert.
- revokeDeviceAccess
- Revoca l'accesso a tutti i dispositivi di cui è stato eseguito il provisioning per l'utente. L'utente
non potrà più usare la versione gestita del Play Store sui suoi
dispositivi gestiti.
Questa chiamata funziona solo con gli account gestiti da EMM. - setAvailableProductSet
- Modifica l'insieme di prodotti a cui un utente può accedere (indicati come prodotti autorizzati). Solo i prodotti che approvato o prodotti precedentemente approvati (prodotti con approvazione revocata) possono essere inclusi nella lista consentita.
- aggiorna
- Aggiorna i dettagli di un utente gestito da EMM.
Può essere utilizzato solo con gli utenti gestiti da EMM (non con gli utenti gestiti da Google). Trasmetti i nuovi dettagli nel Utenti risorsa nel corpo della richiesta. Solo il campodisplayName
possono essere modificate. Gli altri campi non devono essere impostati o devono presentare valore attualmente attivo.