Users

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:
  • "deviceAccount"
  • "userAccount"
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:
  • "emmManaged"
  • "googleManaged"
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 elemento accountIdentifier e un elemento accountType.

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 campo displayName. Gli altri campi devono essere non impostati o avere il valore attualmente attivo.