Configurar notificações de EMM

O Google Play gera notificações, chamadas de notificações de EMM, em resposta a vários eventos que afetam uma empresa. Por exemplo, quando um app é aprovado, o sistema envia uma notificação ProductApprovalEvent.

As notificações de EMM estão associadas a uma conta de serviço empresarial (ESA, na sigla em inglês) específica. Como um EMM, é possível configurar seu console para exibir alertas ou mensagens para administradores de TI corporativos com base nas notificações recebidas.

As notificações de EMM são enviadas usando o Google Cloud Pub/Sub. Para informações detalhadas sobre como configurar notificações do Pub/Sub, consulte a Visão geral do assinante e o Guia do assinante de pull.

Para confirmar que você configurou o sistema para receber notificações de EMM do Google Play e recuperar o nome do tópico do Cloud Pub/Sub a que você precisa se conectar à assinatura, chame Enterprises.sendTestPushNotification.

O envio de uma notificação de teste valida sua integração de EMM com o serviço Google Cloud Pub/Sub para a empresa. Se as notificações de EMM estiverem configuradas corretamente, a API vai retornar o seguinte:

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

Notificações pull

O Google Cloud Pub/Sub é compatível com dois mecanismos de notificação diferentes: pull e push. No entanto, somente as notificações pull são recomendadas. A abordagem de pull não requer configuração de servidor externo e funciona com ESAs criado de modo programático e manual. Outra vantagem das notificações pull é que elas exigem pouca ou nenhuma configuração ou manutenção extra por parte dos clientes. Use Enterprises.pullNotificationSet e Enterprises.acknowledgeNotificationSet para receber e confirmar notificações de EMM em conexões de saída de longa duração.

Ao chamar Enterprises.pullNotificationSet, recomendamos deixar o requestMode com o valor padrão (waitForNotifications). Isso faz com que a solicitação aguarde até que uma ou mais notificações estejam presentes antes de retornar uma resposta. Se nenhuma notificação aparecer após algum tempo, a solicitação retornará uma lista de notificações vazia. Depois disso, será possível enviar a solicitação novamente.

Depois de receber notificações, chame Enterprises.acknowledgeNotificationSet para garantir que as mesmas notificações não sejam retornadas na próxima vez que você chamar Enterprises.pullNotificationSet.

Você também tem a opção de definir requestMode como returnImmediately ao chamar Enterprises.pullNotificationSet. Você receberá uma resposta à solicitação imediatamente, contendo todas as notificações pendentes ou uma lista vazia se não houver notificações. Essa opção requestMode pode ser útil quando você testa a implementação de notificações pela primeira vez.

Exemplos de notificações de EMM

Veja alguns exemplos de eventos e os tipos de notificação que eles geram:

Observação:os seguintes tipos de notificação foram descontinuados: ProductApprovalEvent, AppUpdateEvent, NewPermissionsEvent, AppRestrictionsSchemaChangeEvent, ProductAvailabilityChangeEvent e NewDeviceEvent. Para AppUpdateEvent, use o modo de atualização de alta prioridade , de acordo com nossas recomendações.

DescriçãoNotificação
Uma notificação de teste é solicitada pela API Google Play EMM. Você precisa enviar uma notificação de teste para confirmar se o sistema pode receber as notificações publicadas pelo Google Play e para saber o nome do tópico usado para todas as notificações associadas ao Google Play. TestPushNotification
Um dispositivo recém-provisionado está pronto para ser gerenciado pela API Google Play EMM. Agora você pode chamar APIs que exigem o método deviceId do dispositivo (Instalações, por exemplo) e APIs que retornam um recurso Devices. Essa notificação só é enviada depois que a primeira conta é provisionada em um dispositivo gerenciado. Descontinuado NewDeviceEvent
Um administrador marca um aplicativo como aprovado ou não aprovado no Google Play Console gerenciado. Descontinuado ProductApprovalEvent
Uma instalação pendente em um dispositivo expira. Por exemplo, uma solicitação de instalação por push é aceita, mas o dispositivo não pode ser acessado por vários dias. Portanto, a instalação não pode ser confirmada. O sistema envia uma notificação de tempo limite da instalação.InstallFailureEvent
A nova versão de um app é publicada. A atualização está disponível para um ou mais dispositivos, mas não necessariamente todos. Descontinuado AppUpdateEvent
Uma atualização de app requer que uma nova permissão seja aprovada pelo administrador para que uma atualização ou uma nova instalação possa ocorrer. Essa notificação é enviada quando o conjunto de permissões aceitas pelo aplicativo é diferente do definido. Descontinuado NewPermissionsEvent
Uma nova versão de um app é publicada, incluindo um esquema de configurações gerenciadas novo ou modificado. Quando um desenvolvedor faz upload de um novo APK, o Google Play compara o esquema no manifesto com o esquema da versão anterior do app. Se o esquema tiver sido alterado, as empresas que aprovaram o app serão notificadas. Descontinuado AppRestrictionsSchemaChangeEvent
Um app disponível fica indisponível ou um app indisponível é adicionado novamente ao Google Play. A disponibilidade do app muda se um desenvolvedor cancelar a publicação ou ele for removido do Google Play. A disponibilidade também muda se um app indisponível for adicionado novamente ao Google Play. Descontinuado ProductAvailabilityChangeEvent