Attiva le notifiche push EMM

Questa guida presuppone che tu abbia già un'ESA creata manualmente e mostra come configurarlo per l'utilizzo con le notifiche push EMM. Le attività sono state completate dal proprietario dell'ESA (tu, in qualità di fornitore di soluzioni EMM, o il tuo cliente) utilizzando Console API di Google:

1. Abilita l'accesso API Google Cloud Pub/Sub nella console API di Google per un progetto cloud.

2. Concedi le autorizzazioni di Editor all'ESA.

3. Configura un progetto per ricevere notifiche EMM.

4. Invia una notifica EMM di prova.

5. Iscriviti all'argomento.

Questi passaggi sono descritti in modo più dettagliato nelle sezioni di seguito.

1. Abilita l'accesso all'API Cloud Pub/Sub per un progetto

Per attivare l'API Cloud Pub/Sub per il tuo progetto:

  1. Nella console API, apri la libreria API. Seleziona il progetto (o crearne uno nuovo, se necessario). Nella Libreria API sono elencate tutte le API disponibili, raggruppate per famiglia di prodotti e popolarità.
  2. In API Google Cloud, individua l'API Cloud Pub/Sub. (In caso contrario visibile nell'elenco, utilizza la ricerca per trovarla).
  3. Seleziona API Cloud Pub/Sub e fai clic su Abilita.

Dopo aver abilitato un'API, dalla scheda API e Servizi, fai clic su Dashboard per visualizzare un elenco di tutte le API abilitate. Prima del cloud L'API Pub/Sub può essere utilizzata per i messaggi inviati al cliente. Devi concedere l'autorizzazione Editor le autorizzazioni all'account di servizio del cliente (la relativa ESA).

2. Concedi le autorizzazioni di Editor all'ESA

Dalla console API, concedi le autorizzazioni necessarie:

  1. Dalla sezione API e nel menu Servizi, fai clic su Credenziali. Dovresti l'ESA del cliente in Chiavi dell'account di servizio.
  2. Fai clic su Gestisci account di servizio per aprire tutti gli account di servizio. associati al progetto.
  3. Dall'elenco, seleziona l'account ESA appropriato, quindi fai clic su Autorizzazioni.
  4. Nel campo Aggiungi membri:
      .
    • Inserisci l'indirizzo email associato all'ESA.
    • Dal selettore a discesa, scegli Editor (accanto al ).
  5. Fai clic su Aggiungi per salvare le autorizzazioni.

3. Configura un progetto per ricevere notifiche EMM

Con l'API Cloud Pub/Sub abilitata e un'ESA configurata con Editor autorizzazioni, puoi configurare un progetto per ricevere notifiche EMM descritti in Impostare le notifiche push EMM. In breve, il processo di configurazione prevede a un endpoint server HTTP per inviare notifiche push agli abbonati.

Le notifiche EMM vengono inviate come protobufs (buffer di protocollo, un formato semplice per la serializzazione dei dati strutturati) Messaggi di array di byte con codifica byte64 all'interno di pacchetti JSON. Nel codice, devi analizzare questo JSON e decodificare il contenuto del buffer di protocollo. Ecco un esempio di un protobuf codificato con sicurezza per URL base64 per un NewPermissionsEvent notifica:


CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF

Decodifica per:


{
 enterprise_id: "C12345678"
 event_notification_sent_timestamp_millis: 1461316528000 # 1.33Ti;
    [as milliseconds]: 2016-04-22 10:15:28 +0100
 new_permissions_event: {
   product_id: "app:com.fakeapp.example"
   requested_permissions: [ "android.permission.WRITE_EXTERNAL_STORAGE" ]
   approved_permissions : [ "android.permission.READ_EXTERNAL_STORAGE",
    "android.permission.VIBRATE" ]
  }
}

Per decodificare le notifiche EMM in formato protobuf, puoi utilizzare il metodo emm_pubsub.proto file situato in repository google/play-work su GitHub. Quando vengono visualizzati nuovi tipi di notifiche aggiunto, il file viene esteso con il nuovo tipo e il codice campione viene aggiornato. Queste modifiche dovrebbero essere compatibili con le versioni precedenti, ma assicurati che il codice sia in grado di far fronte la ricezione di notifiche di tipi sconosciuti, oltre a quelle elencato nel file .proto.

4. Invia una notifica EMM di prova

L'invio di una notifica di prova ti consente di confermare che hai configurare il sistema per ricevere notifiche EMM da Google Play. ti permette anche di imparare il nome dell'argomento (lo stesso nome viene utilizzato per tutte le notifiche EMM di Google Play).

Utilizzando l'API Play EMM, chiama il metodo sendTestPushNotification sulla risorsa Enterprise.

La chiamata di questa operazione comporta l'invio di una notifica EMM di prova. Se EMM se le notifiche sono configurate correttamente, l'API restituisce quanto segue:

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

5. Iscriviti all'argomento

Utilizzo del codice campione fornito in Esegui il codice di test del publisher (nella sezione Configura push EMM notifiche), iscriviti all'argomento specificato. Dovresti ricevere la notifica EMM di prova, insieme a eventuali notifiche reali che erano generati dall'avvio del processo di configurazione.