Users

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 "asset#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 dall'utente. 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:
  • "deviceAccount"
  • "userAccount"
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:
  • "emmManaged"
  • "googleManaged"
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 relativi ai dispositivi può utilizzare per eseguire il provisioning dell'account utente gestito da EMM 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
Recupera l'insieme di prodotti a cui un utente ha il diritto di accedere.
inserisci
Crea un nuovo utente gestito da EMM.

La risorsa Utenti passata nel corpo della richiesta deve includere accountIdentifier e accountType.

Se esiste già un utente corrispondente con lo stesso identificatore di account, l'utente verrà aggiornato con la risorsa. In questo caso è possibile modificare solo il campo displayName.

list
Cerca un utente in base all'indirizzo email principale. Questo attributo è supportato solo per gli utenti gestiti da Google. Non è necessaria la ricerca dell'ID per gli utenti gestiti da EMM, perché l'ID è già restituito nel 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ù utilizzare la versione gestita del Play Store su nessuno dei suoi dispositivi gestiti.

Questa chiamata funziona solo con gli account gestiti da EMM.
setAvailableProductSet
Modifica l'insieme di prodotti a cui un utente ha accesso (chiamati prodotti whitelisted). Solo i prodotti approvati o i prodotti precedentemente approvati (prodotti con approvazione revocata) possono essere autorizzati.
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). Passa i nuovi dettagli nella risorsa Utenti nel corpo della richiesta. È possibile modificare solo il campo displayName. Gli altri campi non devono essere impostati o devono avere il valore attualmente attivo.