Configurare le notifiche EMM

Google Play genera notifiche, note come 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 uno specifico account di servizio aziendale (ESA). In qualità di EMM, puoi configurare la tua console in modo che mostri 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 per gli abbonati e la Guida per gli iscritti Pull.

Per verificare di aver configurato correttamente il sistema per ricevere 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 Google Cloud Pub/Sub 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 alcuna configurazione di server esterni e funziona sia con le ESA create in modo programmatico sia manualmente. Un altro vantaggio delle notifiche pull è che richiedono una configurazione o manutenzione aggiuntiva minima o nulla da parte dei clienti. Utilizza Enterprises.pullNotificationSet e Enterprises.acknowledgeNotificationSet per ricevere e confermare le notifiche EMM su connessioni in uscita a lunga esecuzione.

Quando chiami Enterprises.pullNotificationSet, ti consigliamo di lasciare il valore predefinito di requestMode (waitForNotifications). In questo modo la richiesta attende che siano 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 a inviare la richiesta.

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

Puoi anche 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 testi inizialmente l'implementazione delle notifiche.

Esempi di notifiche EMM

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

Nota: i seguenti tipi di notifica sono stati deprecati: ProductApprovalEvent, AppUpdateEvent, NewPermissionsEvent, AppRestrictionsSchemaChangeEvent, ProductAvailabilityChangeEvent e NewDeviceEvent. Per AppUpdateEvent, devi utilizzare la modalità di aggiornamento con priorità elevata in base ai nostri consigli.

Descrizione	Notifica
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 appena eseguito il provisioning è pronto per essere gestito dall'API EMM di Google Play. Ora puoi chiamare le API che richiedono deviceId del dispositivo (ad esempio le installazioni) e le API che restituiscono una risorsa Dispositivi. Questa notifica viene inviata solo dopo che è stato eseguito il provisioning del primo account su un dispositivo gestito. OBSOLETO	NewDeviceEvent
Un amministratore contrassegna un'applicazione come approvata o non approvata nella versione gestita di Google Play Console. OBSOLETO	ProductApprovalEvent
Timeout di un'installazione in attesa su un dispositivo. Ad esempio, una richiesta di installazione push è 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
È stata pubblicata una nuova versione di un'app. L'aggiornamento è disponibile per uno o più dispositivi, ma non necessariamente per tutti. OBSOLETO	AppUpdateEvent
L'aggiornamento di un'app richiede che l'amministratore approvi una nuova autorizzazione affinché possa avvenire un aggiornamento o una nuova installazione. Questa notifica viene inviata quando il set di autorizzazioni accettato dall'applicazione è diverso dal set di autorizzazioni richieste per l'applicazione. OBSOLETO	NewPermissionsEvent
È stata pubblicata una nuova versione di un'app che include uno schema delle configurazioni gestite nuovo o modificato. Quando uno sviluppatore carica un nuovo APK, Google Play confronta lo schema nel file manifest con quello della versione precedente dell'app. Se lo schema è cambiato, invia una notifica alle aziende che hanno approvato l'app. OBSOLETO	AppRestrictionsSchemaChangeEvent
Un'app disponibile non è più disponibile oppure un'app non disponibile viene nuovamente aggiunta a Google Play. La disponibilità dell'app cambia se uno sviluppatore annulla la pubblicazione o se l'app viene rimossa da Google Play. La disponibilità cambia anche nel caso in cui un'app non disponibile venga nuovamente aggiunta a Google Play. OBSOLETO	ProductAvailabilityChangeEvent