Configurar notificações do Pub/Sub

Observação: os parceiros de EMM existentes com ESAs criados de maneira programática precisam registrar o projeto do Cloud preferido com o Google antes de configurar notificações do Pub/Sub para a API Android Management. Para mais detalhes, consulte o guia para parceiros de EMM.

As notificações do Pub/Sub são uma maneira de receber alertas sobre dispositivos recém-registrados, relatórios de dispositivos e comandos emitidos recentemente.

Para configurar as notificações do Pub/Sub, você precisa ativar a API Pub/Sub e criar um tópico. Para receber as mensagens publicadas em um tópico, crie uma assinatura para ele. A assinatura conecta um tópico a um aplicativo do assinante, que recebe e processa as mensagens publicadas no tópico. Depois de criar uma assinatura, você precisa conceder permissão ao Android Device Policy para publicar no seu tópico.

1. Ativar a API Pub/Sub para seu projeto

Para instruções sobre como ativar a API Pub/Sub, consulte o guia de início rápido do console. Selecione o mesmo projeto em que a API Android Management está ativada.

2. Criar um tópico

Depois de ativar a API, você precisa criar um tópico em que o Android Device Policy possa publicar notificações. Há duas maneiras de criar um tópico:

a. Manualmente no console do Google Cloud.
b. Usando a API Pub/Sub (consulte o método de criação de tópicos).

Depois de criar um tópico, anote o nome dele.

3. Crie uma assinatura

Uma assinatura captura o stream de mensagens publicadas sobre determinado tópico. Há duas maneiras de criar uma assinatura:

a. Manualmente no console do Google Cloud.
b. Usando a API Pub/Sub (consulte criar o método de assinatura).

4. Conceder ao Android Device Policy o direito de publicar no seu tópico

É necessário conceder a [e-mail] permissão para publicar no seu tópico. Há duas maneiras de conceder direitos de publicação:

a. Manualmente no console do Google Cloud.

• Adicione [e-mail] como membro do tópico.
• Clique em Selecionar um papel > Pub/Sub > Editor do Pub/Sub.

b. Usar a API Pub/Sub (consulte Como controlar o acesso pela API IAM).

• serviceAccount:[e-mail] foi adicionado a members.
• Defina role como roles/pubsub.publisher.

5. Atualizar a empresa para oferecer suporte a notificações

Pule esta etapa se a notificação que você quer oferecer suporte for ENTERPRISE_UPGRADE, que sempre tem suporte.

Para conectar notificações sobre uma empresa ao tópico que você criou, chame enterprises.patch e especifique os seguintes parâmetros:

• pubsubTopic: o nome do tópico do Pub/Sub no formato projects/{project}/topics/{topic}.
• enabledNotificationTypes: inclua todos os tipos de notificação que você quer receber. Escolha entre ENROLLMENT, STATUS_REPORT e COMMAND.

6. Usar a API Pub/Sub para receber notificações

Uma inscrição pode usar o mecanismo de push ou pull para a entrega de mensagens. As diretrizes e instruções sobre como receber notificações por esses dois mecanismos estão disponíveis no Guia do assinante do Pub/Sub.

Formato de mensagem

As mensagens têm o formato de uma PubsubMessage. O campo attributes da mensagem contém um atributo com a chave notificationType e o valor definido como o tipo de notificação que acionou a mensagem (por exemplo, ENROLLMENT). O campo data da mensagem contém a representação JSON do recurso que foi atualizado, codificado como uma string UTF-8. As notificações e os tipos de recurso correspondentes são os seguintes:

• As notificações COMMAND usam o tipo de recurso Operação.
• As notificações USAGE_LOGS usam o tipo de recurso UsageLogEvent.
• As notificações ENROLLMENT e STATUS_REPORT usam o tipo de recurso Device.
• As notificações ENTERPRISE_UPGRADE usam o tipo de recurso EnterpriseUpgradeEvent.

Ao definir o pubsubTopic em uma empresa, uma mensagem inicial será publicada com notificationType definido como test. Esta mensagem é enviada para verificar se o Android Device Policy tem a permissão de publicação no tópico e deve ser ignorada.

Observação: ao usar a API REST do Pub/Sub, o campo data é codificado como uma string base64. Para receber o JSON do recurso, primeiro realize a decodificação base64 do conteúdo de data e interprete os bytes resultantes como uma string UTF-8.

Latência esperada

Os eventos de upgrade empresarial precisam ser enviados imediatamente.

Os eventos de dispositivos locais que ocorrem em sucessão rápida são agrupados e informados em uma única mensagem do Pub/Sub para EMMs.

Tipo de evento	Latência esperada entre o evento no dispositivo e a notificação EMM correspondente^1
Estados de app com chave de alta prioridade	Imediatamente, no máximo um relatório por minuto
Estados de app com chave de prioridade padrão	Em até um minuto
Eventos relacionados ao aplicativo durante o provisionamento, para apps com estados de instalação definidos pelo administrador de TI^2	Em um minuto, além de outros eventos de provisionamento relacionados
Eventos relacionados ao aplicativo após o provisionamento, para apps com estados de instalação definidos pelo administrador de TI.	Em até 5 minutos
Eventos relacionados ao aplicativo durante e após o provisionamento, para apps com estados de instalação definidos pelo funcionário^3	Em até 60 minutos
Outros eventos de apps no dispositivo	Em até 60 minutos

---

1. Metas de esforço máximo com base em circunstâncias controladas. A latência real pode variar de acordo com vários fatores de dispositivo e ambientais. ↩

2. InstallType de apps aplicados na política: FORCE_INSTALLED, BLOCKED, REQUIRED_FOR_SETUP, PREINSTALLED e KIOSK. ↩

3. InstallType de apps disponíveis: AVAILABLE, INSTALL_TYPE_UNSPECIFIED. ↩