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 for aprovado, o sistema enviará uma notificação ProductApprovalEvent.

As notificações de EMM são associadas a uma conta de serviço empresarial específica (ESA) (em inglês). Como EMM, você pode configurar para exibir alertas ou mensagens para administradores de TI da empresa com base no das notificações que recebe.

As notificações de EMM são enviadas usando o Google Cloud Pub/Sub. Para informações detalhadas sobre como configure notificações do Pub/Sub, consulte a seção Assinante Overview e Pull Subscriber Guia (em inglês).

Confirmar se o sistema foi configurado para receber o EMM do Google Play e para recuperar o nome do bucket do Cloud Pub/Sub para conectar sua assinatura, chame Enterprises.sendTestPushNotification

O envio de uma notificação de teste valida sua integração do EMM com o Google Cloud Serviço do Pub/Sub para empresas. Se as notificações de EMM estiverem funcionando, configurado, 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 oferece suporte a dois mecanismos de notificação diferentes: pull e empurrar. No entanto, apenas notificações pull são recomendadas. A abordagem pull não requer nenhuma configuração de servidor externo e funciona com ambos e ESAs criadas manualmente. Outra vantagem das notificações pull é que elas exigem pouca ou nenhuma configuração ou manutenção adicional por parte dos clientes. usam Enterprises.pullNotificationSet e Enterprises.acknowledgeNotificationSet receber e confirmar as notificações de EMM de mensagens de saída de longa duração. conexões de rede.

Ao ligar Enterprises.pullNotificationSet, recomendamos deixar requestMode com o valor padrão (waitForNotifications). Isso faz com que a solicitação aguarde até que um ou mais notificações estão presentes antes de retornar uma resposta. Se nenhuma notificação for presente após algum tempo, a solicitação retorna uma lista de notificação vazia, depois para fazer a solicitação novamente.

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

Você também tem a opção de definir requestMode como returnImmediately quando chamando Enterprises.pullNotificationSet. Você vai receber uma resposta imediatamente, contendo todas as notificações pendentes ou uma lista vazia se não houver notificações estejam presentes. A opção requestMode pode ser útil quando você testar inicialmente a implementação das notificações.

Exemplos de notificações de EMM

Confira 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 e NewPermissionsEvent. AppRestrictionsSchemaChangeEvent, ProductAvailabilityChangeEvent e NewDeviceEvent. Para AppUpdateEvent, use modo de atualização de alta prioridade como de acordo com nossas recomendações.

Descrição	Notificação
Uma notificação de teste é solicitada pelo API Google Play EMM. Você precisa enviar uma notificação de teste para confirmar que possa receber as notificações que o Google Play publica, e saber qual 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 pelo API Google Play EMM. Agora é possível chamar APIs que exigem o deviceId do dispositivo (Instalações, por exemplo) e APIs que retornam uma classe Devices recurso. Esta notificação é enviada somente após o provisionamento da primeira conta em um dispositivo gerenciado. USO SUSPENSO	NewDeviceEvent
Um administrador marca um aplicativo como aprovado ou não aprovado no Google Play Console gerenciado. USO SUSPENSO	ProductApprovalEvent
Uma instalação pendente em um dispositivo expira. Por exemplo, um envio solicitação de instalação é aceita, mas o dispositivo está inacessível por vários dias, portanto a instalação não pode ser confirmada. O sistema envia um tempo limite de instalação notificação.	InstallFailureEvent
Uma nova versão de um app é publicada. A atualização está disponível para um ou mais dispositivos, mas não necessariamente todos. USO SUSPENSO	AppUpdateEvent
A atualização de um app exige que uma nova permissão seja aprovada pelo administrador. Portanto, que uma atualização ou nova instalação pode ocorrer. Essa notificação é enviada quando o O conjunto de permissões aceitas do aplicativo é diferente do conjunto de permissões do aplicativo permissões solicitadas definidas. USO SUSPENSO	NewPermissionsEvent
Uma nova versão de um app é publicada e inclui uma versão nova ou modificada esquema de configurações gerenciadas. Quando um desenvolvedor fizer o upload de um novo APK, o Google Play vai comparar o esquema no manifesto com o o esquema na versão anterior do app. Se o esquema foi alterado, notifica as empresas que aprovaram o aplicativo. USO SUSPENSO	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 removido do Google Play. A disponibilidade também muda se app indisponível será adicionado novamente ao Google Play. USO SUSPENSO	ProductAvailabilityChangeEvent