Ativar notificações push de EMM

Este guia presume que você já tenha um ESA criado manualmente e mostra como configurá-lo para uso com notificações push de EMM. As tarefas foram concluídas pelo proprietário da ESA (você, como provedor de soluções de EMM ou seu cliente) usando o Console de APIs do Google:

1. Ativar o acesso à API Google Cloud Pub/Sub no Console de APIs do Google para um em um projeto de nuvem.

2. Conceder permissões de editor à ESA.

3. Configure um projeto para receber notificações de EMM.

4. Enviar uma notificação de EMM de teste.

5. Assine o tópico.

Essas etapas são descritas mais detalhadamente nas seções abaixo.

1. Ativar o acesso de um projeto à API Cloud Pub/Sub

Para ativar a API Cloud Pub/Sub no projeto:

  1. No Console de APIs, abra a Biblioteca de APIs. Selecionar o projeto (ou criar um novo, se necessário). A Biblioteca de APIs lista todas APIs disponíveis, agrupadas por família de produtos e popularidade.
  2. Em "APIs do Google Cloud", encontre a API Cloud Pub/Sub. Se não for visível na lista, use a pesquisa para encontrá-lo.
  3. Selecione API Cloud Pub/Sub e clique em Ativar.

Depois de ativar uma API, na página APIs e Serviços, clique no Painel para ver uma lista de todas as APIs ativadas. Antes da nuvem A API Pub/Sub pode ser usada para mensagens ao seu cliente, você precisa conceder acesso Editor permissões à conta de serviço desse cliente (a ESA).

2. Conceder permissões de editor à ESA

No Console de APIs, conceda as permissões necessárias:

  1. Na página APIs e Serviços, clique em Credenciais. Você deve consulte o ESA do cliente listado em "Chaves da conta de serviço".
  2. Clique em Gerenciar contas de serviço para abrir todas elas. associadas ao projeto.
  3. Na lista, selecione a conta apropriada da ESA e clique em Permissões.
  4. No campo Adicionar membros:
    • Insira o endereço de e-mail associado à ESA.
    • No seletor suspenso, escolha Editor (ao lado do entrada).
  5. Clique em Adicionar para salvar as permissões.

3. Configurar um projeto para receber notificações de EMM

Com a API Cloud Pub/Sub ativada e um ESA configurado com o Editor é possível configurar um projeto para receber notificações de EMM como detalhadas em Definir configurar notificações push de EMM. Em resumo, o processo de configuração envolve definir um endpoint de servidor HTTP para enviar notificações push aos assinantes.

As notificações de EMM são entregues como protobufs (buffers de protocolo, um formato simples para serialização de dados estruturados) empacotados como mensagens de matriz de bytes codificadas em bytes64 dentro de pacotes JSON. No seu código, é preciso analisar esse JSON e decodificar o conteúdo do buffer de protocolo. Aqui está um exemplo de um protobuf codificado com URL base64 seguro para um NewPermissionsEvent notificação:


CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF

Ele é decodificado como:


{
 enterprise_id: "C12345678"
 event_notification_sent_timestamp_millis: 1461316528000 # 1.33Ti;
    [as milliseconds]: 2016-04-22 10:15:28 +0100
 new_permissions_event: {
   product_id: "app:com.fakeapp.example"
   requested_permissions: [ "android.permission.WRITE_EXTERNAL_STORAGE" ]
   approved_permissions : [ "android.permission.READ_EXTERNAL_STORAGE",
    "android.permission.VIBRATE" ]
  }
}

Para decodificar as notificações de EMM formatadas em protobuf, é possível usar emm_pubsub.proto arquivo localizado em repositório google/play-work no GitHub. Quando novos tipos de notificação são adicionado, esse arquivo é estendido com o novo tipo e o exemplo de código é atualizado. Essas alterações devem ser compatíveis com versões anteriores, mas confira se o código é compatível com o recebimento de notificações de tipos desconhecidos, além das listados no arquivo .proto.

4. Enviar uma notificação de EMM de teste

O envio de uma notificação de teste permite confirmar que você Configurar seu sistema para receber notificações de EMM do Google Play. também permite que você aprenda o nome do tópico (o mesmo nome é usado para entregar todas as notificações de EMM do Google Play).

Usando a API Play EMM, chame o método sendTestPushNotification no recurso Enterprises.

Invocar essa operação faz com que uma notificação de EMM de teste seja enviada. Se o EMM forem configuradas corretamente, a API retornará o seguinte:

    {
        topic_name: "/projects/project-name/topics/play-work-012345",
        message_id: "128976912439"
    }

5. Inscrever-se no tópico

Use o exemplo de código fornecido em Executar o código de teste do editor (no tópico Configurar push de EMM guia de notificações, inscreva-se no tópico especificado. Você receberá a notificação de EMM de teste, além das notificações reais que foram gerados desde o início do processo de configuração.