Users

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Um recurso de usuários representa uma conta associada a uma empresa. A conta pode ser específica para um dispositivo ou usuário individual (que pode usar essa 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 de domínio gerenciado pelo Google exige a sincronização com as origens da Conta do Google (via primaryEmail).
  • O modelo de identidade de contas do Google Play gerenciado oferece às empresas um meio dinâmico para criar contas de usuário ou dispositivo conforme necessário. Essas contas 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 que você cria para este usuário, como "usuario342" ou "recurso#44418". Não use informações de identificação pessoal (PII) nesta propriedade. Precisa ser sempre definido para usuários gerenciados pelo EMM. Não definido para usuários gerenciados pelo Google.
accountType string O tipo de conta que este usuário representa. Um userAccount pode ser instalado em vários dispositivos, mas um deviceAccount é específico a um dispositivo. Um usuário gerenciado por EMM (emmManaged) pode ser de qualquer tipo (userAccount, 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 vai aparecer nas interfaces do usuário. A definição desta propriedade é opcional ao criar usuários gerenciados pelo 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 googleManaged usuários, a fonte da verdade é o Google. Portanto, os EMMs precisam verificar se existe uma Conta do Google para o usuário. Com emmManaged usuários, o EMM é responsável.

Os valores aceitáveis são os seguintes:
  • "emmManaged"
  • "googleManaged"
primaryEmail string 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 de EMM.

Métodos

delete
Um usuário gerenciado por EMM foi excluído.
generateAuthenticationToken
Gera um token de autenticação que o cliente de 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.

É possível provisionar no máximo 10 dispositivos por usuário.

Esta chamada só funciona com contas gerenciadas pelo EMM.
get
Recupera detalhes do usuário.
getAvailableProductSet (em inglês)
Recupera o conjunto de produtos que um usuário tem o direito de acessar. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
inserir
Cria um novo usuário gerenciado pelo EMM.

O recurso Users 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, ele 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 (em inglês)
Revoga o acesso a todos os dispositivos provisionados ao usuário no momento. O usuário não vai mais poder usar a Play Store gerenciada em nenhum dispositivo gerenciado.

Esta chamada só funciona com contas gerenciadas pelo EMM.
setAvailableProductSet (em inglês)
Modifica o conjunto de produtos que um usuário tem permissão para acessar, chamados de produtos autorizados. Somente produtos aprovados ou que foram aprovados anteriormente (produtos com aprovação revogada) podem ser permitidos. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
update
Atualiza os detalhes de um usuário gerenciado por EMM.

Pode ser usado apenas com usuários gerenciados pelo EMM, e não 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 não ser definidos ou ter o valor ativo no momento.