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 meios dinâmicos para as empresas criarem contas de usuário ou de dispositivo conforme necessário. Elas dão acesso ao Google Play gerenciado.
{ "kind": "androidenterprise#user", "id": string, "managementType": string, "accountType": string, "primaryEmail": string, "accountIdentifier": string, "displayName": string }
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
accountIdentifier |
string |
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:
|
|
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:
|
|
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. |
Métodos
- excluir
- Um usuário gerenciado por EMM foi excluído.
- generateAuthenticationToken
- Gera um token de autenticação que o cliente da política do dispositivo pode usar para
provisionar a conta de usuário gerenciada pelo EMM em um dispositivo.
O token gerado é de uso único e expira após alguns minutos.
Você pode provisionar até 10 dispositivos por usuário.
Esta chamada só funciona com contas gerenciadas por EMM. - get
- Recupera os detalhes de um usuário.
- getAvailableProductSet
- Recupera o conjunto de produtos que um usuário tem direito de acessar.
- inserir
- Cria um novo usuário gerenciado por EMM.
O recurso Usuários transmitido no corpo da solicitação precisa incluir umaccountIdentifier
e umaccountType
.Se já houver um usuário correspondente com o mesmo identificador de conta, o usuário será atualizado com o recurso. Nesse caso, apenas o campo
displayName
pode ser alterado. - list
- 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ária para usuários gerenciados pelo EMM porque o ID já foi retornado no resultado da chamada Users.insert.
- revokeDeviceAccess
- Revoga o acesso a todos os dispositivos atualmente provisionados ao usuário. O usuário
não poderá mais usar a Play Store gerenciada em nenhum dos
dispositivos gerenciados.
Esta chamada só funciona com contas gerenciadas por EMM. - setAvailableProductSet
- Modifica o conjunto de produtos que um usuário tem direito de acessar (chamados de produtos whitelisted). Somente produtos aprovados ou que foram aprovados anteriormente (produtos com aprovação revogada) podem ser incluídos na lista de permissões.
- update
- Atualiza os detalhes de um usuário gerenciado pelo EMM.
Só pode ser usado com usuários gerenciados por EMM (não com usuários gerenciados pelo Google). Transmita os novos detalhes no recurso Usuários no corpo da solicitação. Somente o campodisplayName
pode ser alterado. Outros campos precisam estar sem definição ou ter o valor ativo no momento.