Importante: não aceitamos mais novos registros para a API Play EMM. Saiba mais.

Esta página foi traduzida pela API Cloud Translation.

Enterprises

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

Representações de recursos

Um recurso Enterprise representa a vinculação entre um EMM e uma organização específica. Essa vinculação pode ser instanciada de duas maneiras diferentes usando essa API, como mostrado a seguir:

Para clientes do domínio gerenciado pelo Google, o processo envolve o uso de Enterprises.enroll e Enterprises.setAccount (com artefatos coletados do Admin Console e do Console de APIs do Google) e enviados ao EMM por meio de um processo manual mais ou menos.
Para clientes de contas do Google Play gerenciado, o processo envolve o uso de Enterprises.generateSignupUrl e Enterprises.completeSignup com a interface de inscrição do Google Play gerenciado (mecanismo fornecido pelo Google) para criar a vinculação sem etapas manuais.

Como EMM, você pode oferecer suporte a uma ou ambas as abordagens no console. Consulte Criar uma empresa para mais detalhes.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ]
}

Nome da propriedade	Valor	Descrição
`administrator[]`	`list`	Administradores da empresa. Isso só é possível para empresas criadas pelo fluxo iniciado pelo EMM.
`administrator[].email`	`string`	O endereço de e-mail do administrador.
`id`	`string`	O ID exclusivo da empresa.
`kind`	`string`
`name`	`string`	O nome da empresa, por exemplo, "Example, Inc".
`primaryDomain`	`string`	O domínio principal da empresa, como "example.com".

Métodos

acknowledgeNotificationSet: Reconhece as notificações recebidas de Enterprises.PullNotificationSet para evitar que chamadas subsequentes sejam retornadas as mesmas notificações.
completeSignup: Conclui o fluxo de inscrição especificando o token de conclusão e Token empresarial. Esta solicitação não pode ser chamada várias vezes para uma determinada empresa Token.
createWebToken: Retorna um token exclusivo para acessar uma interface incorporável. Para gerar um da IU da Web, transmita o token gerado ao JavaScript do Google Play gerenciado. API. 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: Registra uma empresa no EMM de chamada.
generateSignupUrl: Gera um URL de inscrição.
get: Recupera o nome e o domínio de uma empresa.
getServiceAccount: Retorna uma conta de serviço e credenciais. A conta de serviço pode ser vinculado à empresa chamando setAccount. A conta de serviço é exclusivo para esta empresa e EMM e será excluído se a não tem vínculo. As credenciais contêm dados de chave privada e não são armazenadas lado do servidor.

Esse método só pode ser chamado depois de Enterprises.Inscrição ou Enterprises.CompleteInscrição e antes Enterprises.SetAccount; Outras vezes, retornará um erro.

As chamadas subsequentes após a primeira vão gerar um conjunto novo e exclusivo de credenciais e invalida as que já foram geradas.

Depois que a conta de serviço é vinculada à empresa, ela pode ser gerenciada usando o recurso serviceAccountKeys.
getStoreLayout: Retorna o layout da loja da empresa. Se o layout da loja não foi definido, retorna "básico" como o tipo de layout da loja e página inicial.
list: Procura uma empresa pelo nome de domínio. Isso só é possível em empresas criadas por meio de campanhas fluxo de criação. A pesquisa do ID não é necessária para empresas criadas via o fluxo iniciado pelo EMM, porque ele aprende o ID da empresa na de retorno especificado na chamada Enterprises.generateenrollUrl.
pullNotificationSet: Extrai e retorna uma notificação definida para as empresas associadas a a conta de serviço autenticada para a solicitação. O conjunto de notificações pode vazio se nenhuma notificação estiver pendente.
Um conjunto de notificações retornado precisa ser confirmado em 20 segundos chamando Enterprises.AcceptNotificationSet, a menos que o o conjunto de notificações está vazio.
As notificações que não forem confirmadas dentro de 20 segundos serão ser incluído novamente na resposta a outro objeto PullNotificationSet solicitação, e aqueles que nunca forem confirmados serão excluídos de acordo com a política do sistema do Pub/Sub do Google Cloud Platform.
Várias solicitações podem ser realizadas simultaneamente para recuperar notificações. Nesse caso, as notificações pendentes (se houver) serão divididos entre cada autor da chamada, se houver algum pendente.
Se nenhuma notificação estiver presente, uma lista de notificações vazia será retornada. As solicitações subsequentes podem retornar mais notificações quando se tornarem disponíveis.
sendTestPushNotification: Envia uma notificação de teste para validar a integração do EMM com o o serviço do Google Cloud Pub/Sub para esta empresa.
setAccount: Define a conta que será usada para autenticação na API como a em uma empresa.
setStoreLayout: Define o layout da loja para empresas. Por padrão, storeLayoutType está definido como "básico" e o layout básico da loja está ativado. O básico layout contém apenas apps aprovados pelo administrador e que tenham foram adicionados ao conjunto de produtos disponível para um usuário (usando o setAvailableProductSet). Os aplicativos na página estão classificados o valor do ID do produto. Se você criar um layout de loja personalizado definindo storeLayoutType = "custom" e configurando uma página inicial), a página inicial o layout está desativado.
cancelar inscrição: Cancela a inscrição de uma empresa no EMM de chamada.