Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para ver uma lista de métodos desse recurso, consulte o final desta página.
Representações de recursos
O recurso Usuários representa uma conta associada a uma empresa. A conta pode ser específica para um dispositivo ou para um usuário individual, que pode usar a conta em vários dispositivos. A conta pode fornecer acesso somente ao Google Play gerenciado ou a outros Serviços do Google, dependendo do modelo de identidade:
O modelo de identidade do domínio gerenciado pelo Google requer sincronização com as origens da Conta do Google (via primaryEmail).
O modelo de identidade de contas do Google Play gerenciado oferece uma forma dinâmica para as empresas criarem contas de usuário ou de dispositivo conforme necessário. Elas dão acesso ao Google Play gerenciado.
Um identificador exclusivo criado para esse usuário, como "user342" ou "asset#44418". Não use informações de identificação pessoal (PII) para essa propriedade. Precisa ser sempre definido para usuários gerenciados por EMM. Não definido para usuários gerenciados pelo Google.
accountType
string
O tipo de conta que esse usuário representa. Um userAccount pode ser instalado em vários dispositivos, mas um deviceAccount é específico para um único dispositivo. Um usuário gerenciado pelo EMM (emmManaged) pode ser dos dois tipos (userAccount ou deviceAccount), mas um usuário gerenciado pelo Google (googleManaged) é sempre um userAccount.
Os valores aceitáveis são os seguintes:
"deviceAccount"
"userAccount"
displayName
string
O nome que aparecerá nas interfaces do usuário. A configuração dessa propriedade é opcional ao criar usuários gerenciados por EMM. Se você definir essa propriedade, use algo genérico sobre a organização (como "Exemplo LTDA") ou seu nome (como EMM). Não é usado para contas de usuário gerenciadas pelo Google.
gravável
id
string
O ID exclusivo do usuário.
kind
string
managementType
string
A entidade que gerencia o usuário. Com os usuários do googleManaged, a fonte da verdade é o Google. Por isso, os EMMs precisam garantir que existe uma Conta do Google para o usuário. Com emmManaged usuários, o EMM fica no comando.
Os valores aceitáveis são os seguintes:
"emmManaged"
"googleManaged"
primaryEmail
string
O endereço de e-mail principal do usuário, por exemplo, "jsilva@example.com". Sempre será definido para usuários gerenciados pelo Google e não para usuários gerenciados pelo EMM.
Gera um token de autenticação que o cliente do Device Policy pode usar para
provisionar uma determinada conta de usuário gerenciada por EMM em um dispositivo;
O token gerado é de uso único e expira após alguns minutos.
É possível provisionar até 10 dispositivos por usuário.
Esta chamada só funciona com contas gerenciadas por EMM.
O recurso Users
passado no corpo da solicitação deve incluir um
accountIdentifier e um accountType.
Se já existir um usuário correspondente com o mesmo identificador de conta,
o usuário será atualizado com o recurso. Nesse caso, apenas o
O campo displayName pode ser alterado.
Procura um usuário pelo endereço de e-mail principal.
Isso só é compatível com usuários gerenciados pelo Google. A pesquisa do ID não é
necessário para usuários gerenciados por EMM porque o ID já foi retornado na
resultado da chamada Users.insert.
Revoga o acesso a todos os dispositivos atualmente provisionados ao usuário. O usuário
não poderão mais usar a Play Store gerenciada
e dispositivos gerenciados.
Esta chamada só funciona com contas gerenciadas por EMM.
Modifica o conjunto de produtos aos quais um usuário tem direito de acesso (referido
como produtos incluídos na lista de permissões). Somente produtos que são
aprovado
ou produtos que foram aprovados anteriormente (produtos com aprovação revogada)
podem ser colocados na lista de permissões.
Atualiza os detalhes de um usuário gerenciado pelo EMM.
Pode ser usado apenas com usuários gerenciados pelo EMM (não com usuários gerenciados pelo Google).
Transmita os novos detalhes no
Usuários
no corpo da solicitação. Apenas o campo displayName
podem ser alteradas. Outros campos precisam estar sem definição ou ter a
valor ativo no momento.
[null,null,["Última atualização 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."]]
