Enterprises: pullNotificationSet

Menarik dan menampilkan set notifikasi untuk perusahaan yang terkait dengan akun layanan yang diotentikasi untuk permintaan. 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 kumpulan notifikasi kosong.
Notifikasi yang tidak dikonfirmasi dalam waktu 20 detik pada akhirnya akan disertakan lagi dalam respons terhadap permintaan PullNotificationSet lain, dan notifikasi yang tidak pernah dikonfirmasi pada akhirnya akan dihapus sesuai dengan kebijakan sistem Pub/Sub Google Cloud Platform.
Beberapa permintaan dapat dilakukan secara serentak untuk mengambil notifikasi, dalam hal ini pemberitahuan 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 menjadi yang 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 mengambil notifikasi.
Menentukan waitForNotifications akan menyebabkan permintaan memblokir dan menunggu hingga ada satu atau beberapa notifikasi, atau menampilkan daftar notifikasi kosong jika tidak ada notifikasi setelah beberapa waktu.
Menentukan returnImmediately akan menyebabkan permintaan segera mengembalikan notifikasi yang tertunda, atau daftar kosong jika tidak ada notifikasi.
Jika dihilangkan, setelan defaultnya adalah waitForNotifications.

Nilai yang dapat diterima:
  • "returnImmediately"
  • "waitForNotifications"

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut:

Cakupan
https://www.googleapis.com/auth/androidenterprise

Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Jangan berikan isi permintaan dengan metode ini.

Respons

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. Kolom ini akan dihilangkan jika tidak ada notifikasi.
notification[] list Notifikasi diterima, atau kosong jika tidak ada notifikasi.
notification[].enterpriseId string ID perusahaan yang menerima notifikasi. Ini akan selalu ada.
notification[].timestampMillis long Waktu saat notifikasi dipublikasikan dalam milidetik sejak 1970-01-01T00:00:00Z. 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:
  • "approved"
  • "unapproved"
  • "unknown"
notification[].installFailureEvent nested object Notifikasi tentang kegagalan penginstalan aplikasi.
notification[].installFailureEvent.productId string ID produk (mis., "app:com.google.android.gm") yang mengalami 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:
  • "timeout"
  • "unknown"
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 telah 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 telah ditambahi izin baru. Kolom ini akan selalu ada.
notification[].newPermissionsEvent.requestedPermissions[] list Kumpulan izin yang saat ini diminta aplikasi. Gunakan Izin.Dapatkan di EMM API untuk mengambil detail tentang izin ini.
notification[].newPermissionsEvent.approvedPermissions[] list Kumpulan izin yang telah disetujui oleh admin perusahaan untuk aplikasi ini. Gunakan Izin.Dapatkan di EMM API untuk mengambil detail tentang izin ini.
notification[].appRestrictionsSchemaChangeEvent nested object Notifikasi tentang perubahan skema pembatasan aplikasi baru.
notification[].appRestrictionsSchemaChangeEvent.productId string ID produk (mis. "app:com.google.android.gm") yang skema pembatasan 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 diubah. Kolom ini akan selalu ada.
notification[].productAvailabilityChangeEvent.availabilityStatus string Status baru produk. Kolom ini akan selalu ada.

Nilai yang dapat diterima:
  • "available"
  • "removed"
  • "unknown"
  • "unpublished"
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:
  • "managedDevice", perangkat tempat DPC ditetapkan sebagai pemilik perangkat,
  • "managedProfile", perangkat tempat DPC ditetapkan sebagai pemilik profil.


Nilai yang dapat diterima adalah:
  • "managedDevice"
  • "managedProfile"
notification[].notificationType string Jenis notifikasi.

Nilai yang dapat diterima:
  • "appRestricionsSchemaChange"
  • "appUpdate"
  • "deviceReportUpdate"
  • "installFailure"
  • "newDevice"
  • "newPermissions"
  • "productApproval"
  • "productAvailabilityChange"
  • "testNotification"
  • "unknown"
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 laporan terakhir diperbarui 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 status untuk apa aplikasi. Konten kunci ditetapkan oleh developer aplikasi. Untuk mencegah XSS, sebaiknya hapus HTML apa pun 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 Tingkat keparahan status aplikasi. Kolom ini akan selalu ada.

Nilai yang dapat diterima:
  • "severityError"
  • "severityInfo"
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 HTML apa pun 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 HTML dari data sebelum menampilkannya.
kind string