Users

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.

{
  "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:
  • "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.

Métodos

delete
Um usuário gerenciado por EMM foi excluído.
generateAuthenticationToken
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.
get
Recupera os detalhes de um usuário.
getAvailableProductSet
Recupera o conjunto de produtos a que um usuário tem direito de acesso.
inserir
Cria um novo usuário gerenciado 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.

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ário para usuários gerenciados por EMM porque o ID já foi retornado na resultado da chamada Users.insert.
revokeDeviceAccess
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.
setAvailableProductSet
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.
update
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.