API Reference

Esta referência da API está organizada por tipo de recurso. Cada tipo de recurso tem uma ou mais representações de dados e um ou mais métodos.

Tipos de recurso

  1. Dispositivos
  2. Empresas
  3. Direitos
  4. Grouplicenses
  5. Grouplicenseusers
  6. Instalações
  7. Managedconfigurationsfordevice
  8. Configurações gerenciadas para usuário
  9. Managedconfigurationssettings
  10. Permissões
  11. Produtos
  12. Chaves de conta de serviço
  13. Storelayoutclusters
  14. Storelayoutpages
  15. Usuários
  16. Apps da Web

Dispositivos

Para saber mais sobre o recurso Devices, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
forceReportUpload POST  /enterprises/enterpriseId/users/userId/devices/deviceId/forceReportUpload Faz upload de um relatório que contém todas as mudanças nos estados do app no dispositivo desde a geração do último relatório. É possível chamar esse método até três vezes a cada 24 horas em um determinado dispositivo.
get GET  /enterprises/enterpriseId/users/userId/devices/deviceId Recupera os detalhes de um dispositivo.
getState GET  /enterprises/enterpriseId/users/userId/devices/deviceId/state Recupera se o acesso de um dispositivo aos serviços do Google está ativado ou desativado. O estado do dispositivo só entra em vigor se a aplicação de políticas de EMM a dispositivos Android estiver ativada no Google Admin Console. Caso contrário, o estado do dispositivo será ignorado, e todos os dispositivos terão acesso aos Serviços do Google. Isso só é possível para usuários gerenciados pelo Google.
list GET  /enterprises/enterpriseId/users/userId/devices Recupera os IDs de todos os dispositivos de um usuário.
setState PUT  /enterprises/enterpriseId/users/userId/devices/deviceId/state Define se o acesso de um dispositivo aos serviços do Google está ativado ou desativado. O estado do dispositivo só entra em vigor se a aplicação de políticas de EMM a dispositivos Android estiver ativada no Google Admin Console. Caso contrário, o estado do dispositivo será ignorado, e todos os dispositivos terão acesso aos Serviços do Google. Isso só é possível para usuários gerenciados pelo Google.
update PUT  /enterprises/enterpriseId/users/userId/devices/deviceId Atualiza a política do dispositivo.

Para garantir que a política seja aplicada corretamente, é necessário impedir que contas não gerenciadas acessem o Google Play. Para isso, defina allowed_accounts na configuração gerenciada do pacote do Google Play. Consulte como restringir contas no Google Play.

Empresas

Para saber mais sobre o recurso Enterprises, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
acknowledgeNotificationSet POST  /enterprises/acknowledgeNotificationSet Confirma as notificações recebidas de Enterprises.PullNotificationSet para evitar que chamadas subsequentes retornem as mesmas notificações.
completeSignup POST  /enterprises/completeSignup conclui o fluxo de inscrição especificando os tokens de conclusão e Enterprise. Esta solicitação não pode ser chamada várias vezes para um determinado token do Enterprise.
createWebToken POST  /enterprises/enterpriseId/createWebToken Retorna um token exclusivo para acessar uma interface incorporável. Para gerar uma interface da Web, transmita o token gerado para a API JavaScript do Google Play gerenciado. Cada token só pode ser usado para iniciar uma sessão de interface. Consulte a documentação da API JavaScript para mais informações.
inscrever-se POST  /enterprises/enroll Registra uma empresa no EMM de chamada.

Parâmetros de consulta obrigatórios: token

generateSignupUrl POST  /enterprises/signupUrl Gera um URL de inscrição.
get GET  /enterprises/enterpriseId Recupera o nome e o domínio de uma empresa.
getServiceAccount GET  /enterprises/enterpriseId/serviceAccount Retorna uma conta de serviço e credenciais. A conta de serviço pode ser vinculada à empresa chamando setAccount. A conta de serviço é exclusiva para essa empresa e para o EMM e será excluída se a empresa estiver desvinculada. As credenciais contêm dados da chave privada e não são armazenadas no lado do servidor.

Esse método só pode ser chamado depois de chamar Enterprises.enroll ou Enterprises.CompleteEnrollment e antes de Enterprises.SetAccount. Outras vezes, ele retorna um erro.

As chamadas seguintes após a primeira vão gerar um novo conjunto exclusivo de credenciais e invalidar as que foram geradas anteriormente.

Quando a conta de serviço estiver vinculada à empresa, ela poderá ser gerenciada usando o recurso serviceAccountKeys.
getStoreLayout GET  /enterprises/enterpriseId/storeLayout Retorna o layout de loja da empresa. Se o layout da loja não tiver sido definido, será retornado "básico" como o tipo de layout da loja e nenhuma página inicial.
list GET  /enterprises Procura uma empresa pelo nome de domínio. Isso só é possível para empresas criadas pelo fluxo de criação iniciado pelo Google. A pesquisa do ID não é necessária para empresas criadas pelo fluxo iniciado por EMM porque ele aprende o ID empresarial no callback especificado na chamada Enterprises.generateEnrollmentUrl.

Parâmetros de consulta obrigatórios: domain

pullNotificationSet POST  /enterprises/pullNotificationSet Extrai e retorna uma notificação definida para as empresas associadas à conta de serviço autenticada para a solicitação. O conjunto de notificações poderá estar vazio se nenhuma notificação estiver pendente.
Um conjunto de notificações retornado precisa ser confirmado em 20 segundos chamando Enterprises.RecognitionNotificationSet, a menos que o conjunto de notificações esteja vazio.
As notificações que não forem confirmadas em 20 segundos serão incluídas novamente na resposta a outra solicitação PullNotificationSet e aquelas que nunca forem confirmadas serão excluídas de acordo com a política do sistema Pub/Sub do Google Cloud Platform.
Várias solicitações podem ser realizadas ao mesmo tempo para extrair notificações. Nesse caso, as notificações pendentes (se houver) serão divididas entre cada autor da chamada, se houver alguma pendente.
Se nenhuma notificação estiver presente, uma lista de notificações vazia será retornada. As solicitações seguintes poderão retornar mais notificações assim que estiverem disponíveis.
sendTestPushNotification POST  /enterprises/enterpriseId/sendTestPushNotification Envia uma notificação de teste para validar a integração do EMM com o serviço do Google Cloud Pub/Sub para esta empresa.
setAccount PUT  /enterprises/enterpriseId/account Define a conta que será usada para autenticação na API como a empresa.
setStoreLayout PUT  /enterprises/enterpriseId/storeLayout Define o layout da loja para a empresa. Por padrão, storeLayoutType é definida como "básica" e o layout de armazenamento básico é ativado. O layout básico contém apenas apps aprovados pelo administrador e que foram adicionados ao conjunto de produtos disponível para um usuário (usando a chamada setAvailableProductSet). Os aplicativos na página são classificados em ordem de valor de ID do produto. Se você criar um layout de loja personalizado (definindo storeLayoutType = "custom" e definindo uma página inicial), o layout de armazenamento básico será desativado.
cancelar inscrição POST  /enterprises/enterpriseId/unenroll Cancela a inscrição de uma empresa no EMM de chamada.

Direitos

Para saber mais sobre o recurso Entitlements, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
excluir DELETE  /enterprises/enterpriseId/users/userId/entitlements/entitlementId Remove um direito de um usuário para um app. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
get GET  /enterprises/enterpriseId/users/userId/entitlements/entitlementId Recupera detalhes de um direito. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
list GET  /enterprises/enterpriseId/users/userId/entitlements Lista todos os direitos do usuário especificado. Somente o ID é definido. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
update PUT  /enterprises/enterpriseId/users/userId/entitlements/entitlementId Adiciona ou atualiza um direito a um app para um usuário. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

Licenças de grupo

Para saber mais sobre o recurso Grouplicenses, consulte a página de representação de recursos.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
get GET  /enterprises/enterpriseId/groupLicenses/groupLicenseId Recupera detalhes da licença de grupo de uma empresa para um produto. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
list GET  /enterprises/enterpriseId/groupLicenses Recupera IDs de todos os produtos para os quais a empresa tem uma licença de grupo. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

Usuários de licença de grupo

Para saber mais sobre o recurso Grouplicenseusers, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
list GET  /enterprises/enterpriseId/groupLicenses/groupLicenseId/users Recupera os IDs dos usuários que receberam direitos sob a licença. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

Instalações

Para detalhes do recurso "Installs", consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
excluir DELETE  /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId Pedidos para remover um app de um dispositivo Uma chamada para get ou list ainda vai mostrar o app como instalado no dispositivo até que ele seja realmente removido.
get GET  /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId Recupera detalhes da instalação de um app em um dispositivo.
list GET  /enterprises/enterpriseId/users/userId/devices/deviceId/installs Recupera os detalhes de todos os apps instalados no dispositivo especificado.
update PUT  /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId Solicita a instalação da versão mais recente de um app em um dispositivo. Se o app já estiver instalado, ele será atualizado para a versão mais recente, se necessário.

Configurações gerenciadas para dispositivo

Para detalhes do recurso Managedconfigurationsfordevice, consulte a página representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
excluir DELETE  /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId Remove uma configuração gerenciada por dispositivo de um app para o dispositivo especificado.
get GET  /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId Recupera detalhes de uma configuração gerenciada por dispositivo.
list GET  /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice Lista todas as configurações gerenciadas por dispositivo para o dispositivo especificado. Somente o ID é definido.
update PUT  /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId Adiciona ou atualiza uma configuração gerenciada por dispositivo em um app para o dispositivo especificado.

Configurações gerenciadas para usuário

Para detalhes do recurso Managedconfigurationsforuser, consulte a página representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
excluir DELETE  /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId Remove uma configuração gerenciada por usuário de um aplicativo para o usuário especificado.
get GET  /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId Recupera detalhes de uma configuração gerenciada por usuário para um aplicativo para o usuário especificado.
list GET  /enterprises/enterpriseId/users/userId/managedConfigurationsForUser Lista todas as configurações gerenciadas por usuário do usuário especificado. Somente o ID é definido.
update PUT  /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId Adiciona ou atualiza as definições de configuração gerenciadas de um app para o usuário especificado. Se você oferecer suporte ao iframe de configurações gerenciadas, poderá aplicar configurações gerenciadas a um usuário especificando um mcmId e as variáveis de configuração associadas (se houver) na solicitação. Como alternativa, todos os EMMs podem aplicar configurações gerenciadas transmitindo uma lista de propriedades gerenciadas.

Configurações gerenciadas

Para saber mais sobre o recurso Managedconfigurationssettings, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
list GET  /enterprises/enterpriseId/products/productId/managedConfigurationsSettings Lista todas as definições de configurações gerenciadas do app especificado.

Permissões

Para detalhes sobre o recurso Permissions, consulte a página Representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
get GET  /permissions/permissionId Recupera detalhes de uma permissão de app Android para exibição a um administrador empresarial.

Produtos

Para saber mais sobre o recurso Products, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
aprovar POST  /enterprises/enterpriseId/products/productId/approve

Aprova o produto especificado e as permissões do app relevantes, se houver. O número máximo de produtos que podem ser aprovados por cliente corporativo é de 1.000.

Para aprender a usar o Google Play gerenciado para projetar e criar um layout de loja e exibir produtos aprovados para seus usuários, consulte Design do layout da loja.

Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
generateApprovalUrl POST  /enterprises/enterpriseId/products/productId/generateApprovalUrl Gera um URL que pode ser renderizado em um iframe para mostrar as permissões (se houver) de um produto. Um administrador corporativo precisa visualizar essas permissões e aceitá-las em nome da organização para aprovar o produto.

Os administradores precisam aceitar as permissões exibidas interagindo com um elemento da interface separado no console de EMM, o que, por sua vez, aciona o uso desse URL como a propriedade approvalUrlInfo.approvalUrl em uma chamada Products.approve para aprovar o produto. Este URL só pode ser usado para exibir permissões por até um dia. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
get GET  /enterprises/enterpriseId/products/productId Recupera detalhes de um produto para exibição a um administrador empresarial.
getAppRestrictionsSchema GET  /enterprises/enterpriseId/products/productId/appRestrictionsSchema Recupera o esquema que define as propriedades configuráveis desse produto. Todos os produtos têm um esquema, mas ele pode ficar vazio se nenhuma configuração gerenciada tiver sido definida. Esse esquema pode ser usado para preencher uma interface que permita que um administrador configure o produto. Para aplicar uma configuração gerenciada com base no esquema gerado usando essa API, consulte Configurações gerenciadas pelo Google Play.
getPermissions GET  /enterprises/enterpriseId/products/productId/permissions Recupera as permissões do app Android exigidas pelo app.
list GET  /enterprises/enterpriseId/products Encontra produtos aprovados que correspondem a uma consulta ou todos os produtos aprovados, se não houver consulta. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
reprovar POST  /enterprises/enterpriseId/products/productId/unapprove Reprova o produto especificado (e as permissões do app relevantes, se houver). Observação: o uso deste item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

Chaves de conta de serviço

Para saber mais sobre o recurso Serviceaccountkeys, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
excluir DELETE  /enterprises/enterpriseId/serviceAccountKeys/keyId Remove e invalida as credenciais especificadas da conta de serviço associada a esta empresa. A conta de serviço da chamada precisa ter sido recuperada chamando Enterprises.GetServiceAccount e definida como a conta de serviço empresarial chamando Enterprises.SetAccount.
inserir POST  /enterprises/enterpriseId/serviceAccountKeys Gera novas credenciais para a conta de serviço associada a essa empresa. É preciso que a conta de serviço da chamada tenha sido recuperada chamando Enterprises.GetServiceAccount e definida como a conta de serviço da empresa chamando Enterprises.SetAccount.

Somente o tipo da chave precisa ser preenchido no recurso a ser inserido.
list GET  /enterprises/enterpriseId/serviceAccountKeys Lista todas as credenciais ativas da conta de serviço associada a essa empresa. Somente o ID e o tipo de chave são retornados. A conta de serviço de chamada precisa ter sido recuperada chamando Enterprises.GetServiceAccount e ter sido definida como a conta de serviço empresarial chamando Enterprises.SetAccount.

StorelayoutClusters

Para saber mais sobre o recurso Storelayoutclusters, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
excluir DELETE  /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId Exclui um cluster.

Observação:esse item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
get GET  /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId Recupera detalhes de um cluster.

Observação:esse item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
inserir POST  /enterprises/enterpriseId/storeLayout/pages/pageId/clusters Insere um novo cluster em uma página.

Observação:esse item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
list GET  /enterprises/enterpriseId/storeLayout/pages/pageId/clusters Recupera os detalhes de todos os clusters na página especificada.

Observação:esse item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
update PUT  /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId Atualiza um cluster.

Observação:esse item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

Páginas de layout da loja

Para saber mais sobre o recurso Storelayoutpages, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
excluir DELETE  /enterprises/enterpriseId/storeLayout/pages/pageId Exclui uma página de loja.

Observação:esse item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
get GET  /enterprises/enterpriseId/storeLayout/pages/pageId Recupera detalhes de uma página de loja.

Observação:esse item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
inserir POST  /enterprises/enterpriseId/storeLayout/pages Insere uma nova página da loja.

Observação:esse item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
list GET  /enterprises/enterpriseId/storeLayout/pages Recupera os detalhes de todas as páginas da loja.

Observação:esse item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
update PUT  /enterprises/enterpriseId/storeLayout/pages/pageId Atualiza o conteúdo de uma página de loja.

Observação:esse item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.

Usuários

Para saber mais sobre o recurso Users, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
excluir DELETE  /enterprises/enterpriseId/users/userId Excluiu um usuário gerenciado por EMM.
generateAuthenticationToken POST  /enterprises/enterpriseId/users/userId/authenticationToken Gera um token de autenticação que o cliente do Device Policy 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 por EMM.
get GET  /enterprises/enterpriseId/users/userId Recupera detalhes de um usuário.
getAvailableProductSet GET  /enterprises/enterpriseId/users/userId/availableProductSet 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 POST  /enterprises/enterpriseId/users Cria um novo usuário gerenciado por EMM.

O recurso de 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 GET  /enterprises/enterpriseId/users Procura um usuário pelo endereço de e-mail principal. Isso só é possível para usuários gerenciados pelo Google. A pesquisa do ID não é necessária para usuários gerenciados por EMM porque o ID já foi retornado no resultado da chamada Users.insert.

Parâmetros de consulta obrigatórios: email

revokeDeviceAccess DELETE  /enterprises/enterpriseId/users/userId/deviceAccess 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 PUT  /enterprises/enterpriseId/users/userId/availableProductSet Modifica o conjunto de produtos a que um usuário tem direito de acesso (chamados de produtos whitelisted). Somente produtos aprovados ou produtos que foram aprovados anteriormente (produtos com aprovação revogada) podem ser colocados na lista de permissões. Observação: este item foi descontinuado. Novas integrações não podem usar esse método e podem consultar nossas novas recomendações.
update PUT  /enterprises/enterpriseId/users/userId Atualiza os detalhes de um usuário gerenciado por EMM.

Só pode ser usado com usuários gerenciados por EMM, e 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. Os outros campos precisam ser não definidos ou ter o valor ativo no momento.

Apps da Web

Para saber mais sobre o recurso Webapps, consulte a página de representação do recurso.

Método Solicitação HTTP Descrição
URIs relacionados a https://www.googleapis.com/androidenterprise/v1, salvo indicação em contrário
excluir DELETE  /enterprises/enterpriseId/webApps/webAppId Exclui um app da Web existente.
get GET  /enterprises/enterpriseId/webApps/webAppId Recebe um app da Web existente.
inserir POST  /enterprises/enterpriseId/webApps Cria um novo app da Web para a empresa.
list GET  /enterprises/enterpriseId/webApps Recupera os detalhes de todos os apps da Web de uma determinada empresa.
update PUT  /enterprises/enterpriseId/webApps/webAppId Atualiza um app da Web existente.