Configurare le notifiche EMM

Google Play genera notifiche, chiamate notifiche EMM, in risposta a vari eventi che interessano un'azienda. Ad esempio, quando un'app viene approvata, il sistema invia una notifica ProductApprovalEvent.

Le notifiche EMM sono associate a un account di servizio enterprise (ESA) specifico. In qualità di fornitore EMM, puoi configurare la console in modo da mostrare avvisi o messaggi agli amministratori IT aziendali in base alle notifiche che ricevi.

Le notifiche EMM vengono inviate utilizzando Google Cloud Pub/Sub. Per informazioni dettagliate su come configurare le notifiche Pub/Sub, consulta la Panoramica degli abbonati e la Guida per gli abbonati pull.

Per verificare di aver configurato correttamente il sistema per ricevere le notifiche EMM da Google Play e per recuperare il nome dell'argomento Cloud Pub/Sub a cui devi collegare l'abbonamento, chiama Enterprises.sendTestPushNotification.

L'invio di una notifica di prova convalida l'integrazione EMM con il servizio Pub/Sub di Google Cloud per l'azienda. Se le notifiche EMM sono configurate correttamente, l'API restituisce quanto segue:

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

Notifiche pull

Google Cloud Pub/Sub supporta due diversi meccanismi di notifica: pull e push. Tuttavia, sono consigliate solo le notifiche pull. L'approccio pull non richiede la configurazione di un server esterno e funziona sia con gli ESA creati programmaticamente sia con quelli creati manualmente. Un altro vantaggio delle notifiche pull è che richiedono poca o nessuna configurazione o manutenzione aggiuntiva da parte dei clienti. Utilizza Enterprises.pullNotificationSet e Enterprises.acknowledgeNotificationSet per ricevere e confermare le notifiche EMM tramite connessioni in uscita di lunga durata.

Quando chiami Enterprises.pullNotificationSet, consigliamo di lasciare requestMode sul valore predefinito (waitForNotifications). In questo modo, la richiesta attende fino a quando non sono presenti una o più notifiche prima di restituire una risposta. Se dopo un po' di tempo non sono presenti notifiche, la richiesta restituisce un elenco di notifiche vuoto, dopodiché puoi riprovare.

Dopo aver ricevuto le notifiche, chiama Enterprises.acknowledgeNotificationSet per assicurarti che le stesse notifiche non vengano restituite la prossima volta che chiami Enterprises.pullNotificationSet.

Hai anche la possibilità di impostare requestMode su returnImmediately quando chiami Enterprises.pullNotificationSet. Riceverai immediatamente una risposta alla richiesta, contenente eventuali notifiche in attesa o un elenco vuoto se non sono presenti notifiche. Questa opzione requestMode può essere utile quando testare inizialmente l'implementazione delle notifiche.

Esempi di notifiche EMM

Di seguito sono riportati alcuni esempi di eventi e dei tipi di notifiche che generano:

Nota: i seguenti tipi di notifiche sono stati ritirati: ProductApprovalEvent, AppUpdateEvent, NewPermissionsEvent, AppRestrictionsSchemaChangeEvent, ProductAvailabilityChangeEvent e NewDeviceEvent. Per AppUpdateEvent, devi utilizzare la modalità di aggiornamento con priorità elevata , come indicato dai nostri consigli.

DescrizioneNotifica
Viene richiesta una notifica di test tramite l' API EMM di Google Play. Devi inviare una notifica di prova per confermare che il tuo sistema può ricevere le notifiche pubblicate da Google Play e per conoscere il nome dell'argomento utilizzato per tutte le notifiche associate a Google Play. TestPushNotification
Un dispositivo di cui è stato eseguito il provisioning di recente è pronto per essere gestito dall'API Google Play EMM. Ora puoi chiamare API che richiedono il deviceId del dispositivo (ad esempio Installs) e API che restituiscono una risorsa Devices. Questa notifica viene inviata solo dopo il provisioning del primo account su un dispositivo gestito. OBSOLETO NewDeviceEvent
Un amministratore contrassegna un'applicazione come approvata o non approvata nella Console di Google Play gestita. OBSOLETO ProductApprovalEvent
Un'installazione in attesa su un dispositivo scade. Ad esempio, una richiesta di installazione push viene accettata, ma il dispositivo non è raggiungibile per diversi giorni, pertanto l'installazione non può essere confermata. Il sistema invia una notifica di timeout dell'installazione.InstallFailureEvent
Viene pubblicata una nuova versione di un'app. L'aggiornamento è disponibile per uno o più dispositivi, ma non necessariamente per tutti. OBSOLETO AppUpdateEvent
Un aggiornamento dell'app richiede l'approvazione di una nuova autorizzazione da parte dell'amministratore, in modo che possa essere eseguito un aggiornamento o una nuova installazione. Questa notifica viene inviata quando l'insieme di autorizzazioni accettate dell'applicazione è diverso dall'insieme di autorizzazioni richieste. OBSOLETO NewPermissionsEvent
Viene pubblicata una nuova versione di un'app che include un schema di configurazioni gestite nuovo o modificato. Quando uno sviluppatore carica un nuovo APK, Google Play confronta lo schema nel file manifest con lo schema nella versione precedente dell'app. Se lo schema è cambiato, viene inviata una notifica alle aziende che hanno approvato l'app. OBSOLETO AppRestrictionsSchemaChangeEvent
Un'app disponibile diventa non disponibile o un'app non disponibile viene aggiunta nuovamente a Google Play. La disponibilità dell'app cambia se uno sviluppatore la annulla o se viene rimossa da Google Play. La disponibilità cambia anche se un'app non disponibile viene aggiunta di nuovo a Google Play. OBSOLETO ProductAvailabilityChangeEvent
Una notifica relativa a un upgrade aziendale. Un upgrade aziendale è un processo che esegue l'upgrade di un account Google Play gestito per l'azienda a un dominio Google gestito. EnterpriseUpgradeEvent