Mengambil dan menampilkan notifikasi yang disetel untuk perusahaan yang terkait dengan akun layanan yang diautentikasi untuk permintaan tersebut. Kumpulan notifikasi mungkin kosong jika tidak ada notifikasi yang tertunda.
Set notifikasi yang ditampilkan harus dikonfirmasi dalam waktu 20 detik
dengan memanggil Enterprises.AcknowledgeNotificationSet, kecuali jika
set notifikasi kosong.
Notifikasi yang tidak dikonfirmasi dalam 20 detik pada akhirnya akan
disertakan lagi sebagai respons terhadap permintaan PullNotificationSet
lainnya, dan notifikasi yang tidak pernah dikonfirmasi akan dihapus sesuai dengan
kebijakan sistem Pub/Sub Google Cloud Platform.
Beberapa permintaan dapat dilakukan secara bersamaan untuk mengambil
notifikasi, dalam hal ini notifikasi yang tertunda (jika ada) akan
dibagi di antara setiap pemanggil, jika ada yang tertunda.
Jika tidak ada notifikasi, daftar notifikasi kosong akan ditampilkan.
Permintaan berikutnya dapat menampilkan lebih banyak notifikasi setelah
tersedia.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/pullNotificationSet
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter kueri opsional | ||
requestMode |
string |
Mode permintaan untuk menarik notifikasi.
Menentukan waitForNotifications akan menyebabkan permintaan
memblokir dan menunggu hingga satu atau beberapa notifikasi ada, atau menampilkan
daftar notifikasi kosong jika tidak ada notifikasi setelah beberapa saat.
Menentukan returnImmediately akan menyebabkan permintaan
segera menampilkan notifikasi yang tertunda, atau daftar kosong jika tidak ada
notifikasi.
Jika dihilangkan, setelan defaultnya adalah waitForNotifications .
Nilai yang dapat diterima adalah:
|
Otorisasi
Permintaan ini memerlukan otorisasi dengan cakupan berikut:
Cakupan |
---|
https://www.googleapis.com/auth/androidenterprise |
Untuk informasi selengkapnya, lihat halaman autentikasi dan otorisasi.
Isi permintaan
Jangan berikan isi permintaan dengan metode ini.
Tanggapan
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{ "kind": "androidenterprise#notificationSet", "notificationSetId": string, "notification": [ { "enterpriseId": string, "timestampMillis": long, "notificationType": string, "productApprovalEvent": { "productId": string, "approved": string }, "installFailureEvent": { "productId": string, "deviceId": string, "userId": string, "failureReason": string, "failureDetails": string }, "appUpdateEvent": { "productId": string }, "newPermissionsEvent": { "productId": string, "requestedPermissions": [ string ], "approvedPermissions": [ string ] }, "appRestrictionsSchemaChangeEvent": { "productId": string }, "productAvailabilityChangeEvent": { "productId": string, "availabilityStatus": string }, "newDeviceEvent": { "userId": string, "deviceId": string, "managementType": string, "dpcPackageName": string }, "deviceReportUpdateEvent": { "userId": string, "deviceId": string, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] } } } ] }
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
notificationSetId |
string |
ID kumpulan notifikasi, diperlukan untuk menandai notifikasi sebagai diterima dengan Enterprises.AcknowledgeNotification API. Ini akan dihilangkan jika tidak ada notifikasi. | |
notification[] |
list |
Notifikasi diterima, atau kosong jika tidak ada notifikasi. | |
notification[].enterpriseId |
string |
ID perusahaan yang akan dikirimi notifikasi. Hal ini akan selalu ada. | |
notification[].timestampMillis |
long |
Waktu saat notifikasi dipublikasikan dalam milidetik sejak 1970-01-01T00:00:00Z. Hal ini akan selalu ada. | |
notification[].productApprovalEvent |
nested object |
Notifikasi tentang perubahan pada status persetujuan produk. | |
notification[].productApprovalEvent.productId |
string |
ID produk (mis., "app:com.google.android.gm") yang status persetujuannya telah berubah. Kolom ini akan selalu ada. | |
notification[].productApprovalEvent.approved |
string |
Apakah produk disetujui atau tidak disetujui. Kolom ini akan selalu ada.
Nilai yang dapat diterima adalah:
|
|
notification[].installFailureEvent |
nested object |
Notifikasi tentang kegagalan penginstalan aplikasi. | |
notification[].installFailureEvent.productId |
string |
ID produk (mis. "app:com.google.android.gm") yang menjadi tempat terjadinya peristiwa kegagalan penginstalan. Kolom ini akan selalu ada. | |
notification[].installFailureEvent.deviceId |
string |
ID Android perangkat. Kolom ini akan selalu ada. | |
notification[].installFailureEvent.userId |
string |
ID pengguna. Kolom ini akan selalu ada. | |
notification[].installFailureEvent.failureReason |
string |
Alasan kegagalan penginstalan. Kolom ini akan selalu ada.
Nilai yang dapat diterima adalah:
|
|
notification[].installFailureEvent.failureDetails |
string |
Detail tambahan tentang kegagalan jika berlaku. | |
notification[].appUpdateEvent |
nested object |
Notifikasi tentang update aplikasi. | |
notification[].appUpdateEvent.productId |
string |
ID produk (mis. "app:com.google.android.gm") yang diperbarui. Kolom ini akan selalu ada. | |
notification[].newPermissionsEvent |
nested object |
Notifikasi tentang izin aplikasi baru. | |
notification[].newPermissionsEvent.productId |
string |
ID produk (mis. "app:com.google.android.gm") yang izin barunya telah ditambahkan. Kolom ini akan selalu ada. | |
notification[].newPermissionsEvent.requestedPermissions[] |
list |
Kumpulan izin yang saat ini diminta aplikasi. Gunakan Permissions.Get on EMM API untuk mengambil detail tentang izin ini. | |
notification[].newPermissionsEvent.approvedPermissions[] |
list |
Kumpulan izin yang telah disetujui oleh admin perusahaan untuk aplikasi ini. Gunakan Permissions.Get on EMM API untuk mengambil detail tentang izin ini. | |
notification[].appRestrictionsSchemaChangeEvent |
nested object |
Notifikasi tentang perubahan skema batasan aplikasi baru. | |
notification[].appRestrictionsSchemaChangeEvent.productId |
string |
ID produk (mis. "app:com.google.android.gm") yang skema batasan aplikasinya diubah. Kolom ini akan selalu ada. | |
notification[].productAvailabilityChangeEvent |
nested object |
Notifikasi tentang perubahan ketersediaan produk. | |
notification[].productAvailabilityChangeEvent.productId |
string |
ID produk (mis., "app:com.google.android.gm") yang ketersediaan produknya berubah. Kolom ini akan selalu ada. | |
notification[].productAvailabilityChangeEvent.availabilityStatus |
string |
Status baru produk. Kolom ini akan selalu ada.
Nilai yang dapat diterima adalah:
|
|
notification[].newDeviceEvent |
nested object |
Notifikasi tentang perangkat baru. | |
notification[].newDeviceEvent.userId |
string |
ID pengguna. Kolom ini akan selalu ada. | |
notification[].newDeviceEvent.deviceId |
string |
ID Android perangkat. Kolom ini akan selalu ada. | |
notification[].newDeviceEvent.managementType |
string |
Mengidentifikasi sejauh mana perangkat dikontrol oleh EMM Android dalam berbagai konfigurasi deployment. Nilai yang memungkinkan mencakup:
Nilai yang dapat diterima adalah:
|
|
notification[].notificationType |
string |
Jenis notifikasi.
Nilai yang dapat diterima adalah:
|
|
notification[].newDeviceEvent.dpcPackageName |
string |
Aplikasi kebijakan di perangkat. | |
notification[].deviceReportUpdateEvent |
nested object |
Notifikasi tentang pembaruan laporan perangkat. | |
notification[].deviceReportUpdateEvent.userId |
string |
ID pengguna. Kolom ini akan selalu ada. | |
notification[].deviceReportUpdateEvent.deviceId |
string |
ID Android perangkat. Kolom ini akan selalu ada. | |
notification[].deviceReportUpdateEvent.report |
nested object |
Laporan perangkat diperbarui dengan status aplikasi terbaru. Kolom ini akan selalu ada. | |
notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis |
long |
Stempel waktu pembaruan laporan terakhir dalam milidetik sejak epoch. Kolom ini akan selalu ada. | |
notification[].deviceReportUpdateEvent.report.appState[] |
list |
Daftar status aplikasi yang ditetapkan oleh aplikasi terkelola di perangkat. Status aplikasi ditentukan oleh developer aplikasi. Kolom ini akan selalu ada. | |
notification[].deviceReportUpdateEvent.report.appState[].packageName |
string |
Nama paket aplikasi. Kolom ini akan selalu ada. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[] |
list |
Daftar status aplikasi dengan kunci. Kolom ini akan selalu ada. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key |
string |
Kunci yang menunjukkan fungsi aplikasi yang menyediakan status. Konten kunci ditetapkan oleh developer aplikasi. Untuk mencegah XSS, sebaiknya hapus semua HTML dari kunci sebelum menampilkannya. Kolom ini akan selalu ada. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis |
long |
Stempel waktu saat aplikasi menetapkan status dalam milidetik sejak epoch. Kolom ini akan selalu ada. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity |
string |
Keparahan status aplikasi. Kolom ini akan selalu ada.
Nilai yang dapat diterima adalah:
|
|
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message |
string |
Pesan bentuk bebas yang dapat dibaca manusia yang menjelaskan status aplikasi. Misalnya, pesan error. Untuk mencegah XSS, sebaiknya hapus semua HTML dari pesan sebelum menampilkannya. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data |
string |
Kolom tambahan yang ditujukan untuk data yang dapat dibaca mesin. Misalnya, angka atau objek JSON. Untuk mencegah XSS, sebaiknya hapus semua HTML dari data sebelum menampilkannya. | |
kind |
string |