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ção | Notificaçã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 |