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

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 um accountIdentifier e um accountType.

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 campo displayName pode ser alterado. Outros campos precisam estar sem definição ou ter o valor ativo no momento.