Aktifkan notifikasi push EMM

Panduan ini mengasumsikan bahwa Anda sudah memiliki ESA yang dibuat secara manual dan menunjukkan cara mengonfigurasinya untuk digunakan dengan notifikasi push EMM. Tugas selesai oleh pemilik ESA (Anda, sebagai penyedia solusi EMM, atau pelanggan) menggunakan Konsol API Google:

1. Aktifkan akses Google Cloud Pub/Sub API di Konsol API Google untuk project cloud Anda.

2. Memberikan izin Editor ke ESA.

3. Siapkan project untuk menerima notifikasi EMM.

4. Kirim notifikasi EMM pengujian.

5. Berlangganan topik.

Langkah-langkah ini diuraikan secara lebih lengkap di bagian di bawah.

1. Mengaktifkan akses Cloud Pub/Sub API untuk project

Untuk mengaktifkan Cloud Pub/Sub API pada project Anda:

  1. Di Konsol API, buka Library API. Pilih proyek (atau membuat proyek baru, jika perlu). Library API mencantumkan semua API yang tersedia, yang dikelompokkan berdasarkan kelompok produk dan popularitas.
  2. Di bagian Google Cloud API, temukan Cloud Pub/Sub API. (Jika bukan terlihat dalam daftar, gunakan penelusuran untuk menemukannya.)
  3. Pilih Cloud Pub/Sub API, lalu klik Enable.

Setelah Anda mengaktifkan API, dari menu API & menu Services, klik Dashboard untuk melihat daftar semua API yang diaktifkan. Sebelum {i>Cloud<i} Pub/Sub API dapat digunakan untuk mengirim pesan kepada pelanggan, Anda harus memberikan izin kepada Editor ke akun layanan pelanggan tersebut (ESA-nya).

2. Memberikan izin Editor ke ESA

Dari Konsol API, berikan izin yang diperlukan:

  1. Dari menu API & Services, klik Credentials. Anda seharusnya melihat ESA pelanggan Anda yang tercantum di bagian Kunci akun layanan.
  2. Klik Kelola akun layanan untuk membuka semua akun layanan yang terkait dengan proyek.
  3. Dari daftar, pilih akun ESA yang sesuai, lalu klik Izin.
  4. Di kolom Tambahkan anggota:
    • Masukkan alamat email yang terkait dengan ESA.
    • Dari pemilih drop-down, pilih Editor (di samping entri).
  5. Klik Add untuk menyimpan Izin.

3. Menyiapkan project untuk menerima notifikasi EMM

Dengan Cloud Pub/Sub API yang diaktifkan dan ESA yang dikonfigurasi dengan Editor Anda dapat mengonfigurasi proyek untuk menerima notifikasi EMM sebagai dijelaskan dalam Set notifikasi push EMM. Secara singkat, proses penyiapan melibatkan konfigurasi endpoint server HTTP untuk mengirim notifikasi kepada pelanggan.

Notifikasi EMM dikirim sebagai protobufs (buffering protokol, format sederhana untuk serialisasi data terstruktur) yang dikemas sebagai pesan array byte64 yang dienkode di dalam paket JSON. Di kode, Anda harus mengurai JSON ini dan mendekode konten buffering protokol. Berikut ini contohnya protobuf yang dienkode dengan aman URL base64 untuk NewPermissionsEvent notifikasi:


CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF

Didekode menjadi:


{
 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" ]
  }
}

Untuk mendekode notifikasi EMM berformat protobuf, Anda dapat menggunakan emm_pubsub.proto file berada di repositori google/play-work di GitHub. Ketika jenis notifikasi baru ditambahkan, file tersebut diperluas dengan tipe baru dan kode contoh diperbarui. Perubahan ini harus kompatibel dengan versi lama, tetapi pastikan kode Anda dapat mengatasinya dengan baik dalam menerima notifikasi dari jenis yang tidak diketahui selain yang yang tercantum di file .proto.

4. Mengirim notifikasi EMM pengujian

Mengirim notifikasi pengujian memungkinkan Anda mengonfirmasi bahwa Anda telah berhasil menyiapkan sistem untuk menerima notifikasi EMM dari Google Play, dan juga memungkinkan Anda mempelajari nama topik (nama topik yang sama digunakan untuk mengirimkan semua notifikasi EMM Google Play).

Dengan Play EMM API, panggil metode sendTestPushNotification di resource Perusahaan.

Memanggil operasi ini akan menyebabkan notifikasi EMM pengujian dikirim. Jika EMM dikonfigurasi dengan benar, API mengembalikan hal berikut:

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

5. Berlangganan topik

Menggunakan kode contoh yang disediakan di Run kode pengujian penayang (di Siapkan push EMM notifikasi), berlangganan topik yang ditentukan. Anda akan menerima notifikasi EMM pengujian, bersama dengan notifikasi nyata apa pun yang buat sejak Anda memulai proses konfigurasi.