Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
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:
"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.
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.
La risorsa Utenti
passati nel corpo della richiesta devono includere un
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 solo
Il campo displayName può essere modificato.
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.
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.
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.
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 campo displayName
possono essere modificate. Gli altri campi non devono essere impostati o devono presentare
valore attualmente attivo.
[null,null,["Ultimo aggiornamento 2024-08-19 UTC."],[[["\u003cp\u003eA Users resource represents an enterprise account that can be device- or individual-specific, granting access to managed Google Play and potentially other Google services based on the chosen identity model.\u003c/p\u003e\n"],["\u003cp\u003eTwo identity models are available: Google-managed domain identity (requiring synchronization with Google accounts) and managed Google Play Accounts (allowing dynamic creation of user/device accounts for Play access).\u003c/p\u003e\n"],["\u003cp\u003eEMM-managed users have unique identifiers and account types, while Google-managed users rely on primary email addresses for identification.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can manage users using various methods like creating, deleting, retrieving details, and controlling device access, with options varying based on management type.\u003c/p\u003e\n"],["\u003cp\u003eSome methods, like \u003ccode\u003egetAvailableProductSet\u003c/code\u003e and \u003ccode\u003esetAvailableProductSet\u003c/code\u003e, are deprecated and will be inaccessible after September 30, 2025, with alternative recommendations available.\u003c/p\u003e\n"]]],[],null,["# Users\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\nA Users resource represents an account associated with an enterprise. The account may be specific to a device or to an individual user (who can then use the account across multiple devices). The account may provide access to managed Google Play only, or to other Google services, depending on the identity model:\n\n- The Google managed domain identity model requires synchronization to Google account sources (via `primaryEmail`).\n- The managed Google Play Accounts identity model provides a dynamic means for enterprises to create user or device accounts as needed. These accounts provide access to managed Google Play.\n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"androidenterprise#user\",\n \"id\": string,\n \"managementType\": string,\n \"accountType\": string,\n \"primaryEmail\": string,\n \"accountIdentifier\": string,\n \"displayName\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `accountIdentifier` | `string` | A unique identifier you create for this user, such as \"user342\" or \"asset#44418\". Do not use personally identifiable information (PII) for this property. Must always be set for EMM-managed users. Not set for Google-managed users. | |\n| `accountType` | `string` | The type of account that this user represents. A `userAccount` can be installed on multiple devices, but a `deviceAccount` is specific to a single device. An EMM-managed user (`emmManaged`) can be either type (`userAccount`, `deviceAccount`), but a Google-managed user (`googleManaged`) is always a `userAccount`. \u003cbr /\u003e Acceptable values are: - \"`deviceAccount`\" - \"`userAccount`\" | |\n| `displayName` | `string` | The name that will appear in user interfaces. Setting this property is optional when creating EMM-managed users. If you do set this property, use something generic about the organization (such as \"Example, Inc.\") or your name (as EMM). Not used for Google-managed user accounts. | writable |\n| `id` | `string` | The unique ID for the user. | |\n| `kind` | `string` | | |\n| `managementType` | `string` | The entity that manages the user. With `googleManaged` users, the source of truth is Google so EMMs have to make sure a Google Account exists for the user. With `emmManaged` users, the EMM is in charge. \u003cbr /\u003e Acceptable values are: - \"`emmManaged`\" - \"`googleManaged`\" | |\n| `primaryEmail` | `string` | The user's primary email address, for example, \"jsmith@example.com\". Will always be set for Google managed users and not set for EMM managed users. | |\n\nMethods\n-------\n\n[delete](/android/work/play/emm-api/v1/users/delete)\n: Deleted an EMM-managed user.\n\n[generateAuthenticationToken](/android/work/play/emm-api/v1/users/generateAuthenticationToken)\n: Generates an authentication token which the device policy client can use to\n provision the given EMM-managed user account on a device.\n The generated token is single-use and expires after a few minutes.\n\n \u003cbr /\u003e\n\n\n You can provision a maximum of 10 devices per user.\n\n \u003cbr /\u003e\n\n\n This call only works with EMM-managed accounts.\n\n[get](/android/work/play/emm-api/v1/users/get)\n: Retrieves a user's details.\n\n[getAvailableProductSet](/android/work/play/emm-api/v1/users/getAvailableProductSet)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Retrieves the set of products a user is entitled to access.\n\n[insert](/android/work/play/emm-api/v1/users/insert)\n: Creates a new EMM-managed user.\n\n \u003cbr /\u003e\n\n\n The [Users](/android/work/play/emm-api/v1/users) resource\n passed in the body of the request should include an\n `accountIdentifier` and an `accountType`.\n\n If a corresponding user already exists with the same account identifier,\n the user will be updated with the resource. In this case only the\n `displayName` field can be changed.\n\n[list](/android/work/play/emm-api/v1/users/list)\n: Looks up a user by primary email address.\n This is only supported for Google-managed users. Lookup of the id is not\n needed for EMM-managed users because the id is already returned in the\n result of the Users.insert call.\n\n[revokeDeviceAccess](/android/work/play/emm-api/v1/users/revokeDeviceAccess)\n: Revokes access to all devices currently provisioned to the user. The user\n will no longer be able to use the managed Play store on any of their\n managed devices.\n\n \u003cbr /\u003e\n\n\n This call only works with EMM-managed accounts.\n\n[setAvailableProductSet](/android/work/play/emm-api/v1/users/setAvailableProductSet)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Modifies the set of products that a user is entitled to access (referred to\n as *whitelisted* products). Only products that are\n [approved](/android/work/play/emm-api/v1/products/approve)\n or products that were previously approved (products with revoked approval)\n can be whitelisted.\n\n[update](/android/work/play/emm-api/v1/users/update)\n: Updates the details of an EMM-managed user.\n\n \u003cbr /\u003e\n\n\n Can be used with EMM-managed users only (not Google managed users).\n Pass the new details in the\n [Users](/android/work/play/emm-api/v1/users)\n resource in the request body. Only the `displayName` field\n can be changed. Other fields must either be unset or have the\n currently active value."]]
