- permintaan HTTP
- Parameter jalur
- Parameter kueri
- Permintaan tubuh
- Badan respons
- Lingkup Otorisasi
- Data Pengiriman Android
- Tanggal
- Data
- Persentase Hasil Pesan
- Persentase Kinerja Pengiriman
- Persen MessageInsight
- Cobalah!
Cantumkan data pengiriman agregat untuk aplikasi Android tertentu.
permintaan HTTP
GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData
URL menggunakan sintaks Transcoding gRPC .
Parameter jalur
Parameter | |
---|---|
parent | Diperlukan. Aplikasi untuk membuat daftar data pengiriman. Format: |
Parameter kueri
Parameter | |
---|---|
pageSize | Jumlah maksimum entri yang akan dikembalikan. Layanan mungkin menghasilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, maksimal 1.000 entri akan dikembalikan. Nilai maksimumnya adalah 10.000; nilai di atas 10.000 akan dibatasi hingga 10.000. Default ini dapat berubah seiring waktu. |
pageToken | Token halaman, diterima dari panggilan |
Permintaan tubuh
Badan permintaan harus kosong.
Badan respons
Jika berhasil, isi respons berisi data dengan struktur berikut:
Pesan respons untuk deliveryData.list.
Representasi JSON |
---|
{
"androidDeliveryData": [
{
object ( |
bidang | |
---|---|
androidDeliveryData[] | Data pengiriman untuk aplikasi yang disediakan. Akan ada satu entri per kombinasi label aplikasi, tanggal, dan analitik. |
nextPageToken | Token, yang dapat dikirim sebagai |
Lingkup Otorisasi
Memerlukan cakupan OAuth berikut:
-
https://www.googleapis.com/auth/cloud-platform
Data Pengiriman Android
Data pengiriman pesan untuk kombinasi tanggal, aplikasi, dan label analitik tertentu.
Representasi JSON |
---|
{ "appId": string, "date": { object ( |
bidang | |
---|---|
appId | ID aplikasi tujuan pengiriman pesan. |
date | Tanggal diwakili oleh entri ini. |
analyticsLabel | Label analitik yang terkait dengan pesan yang dikirim. Semua pesan yang dikirim tanpa label analitik akan dikelompokkan menjadi satu entri. |
data | Data untuk |
Tanggal
Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggalnya relatif terhadap Kalender Gregorian. Ini dapat mewakili salah satu dari berikut ini:
- Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
- Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
- Satu tahun saja, tanpa bulan dan tanpa hari.
- Setahun dan bulan, dengan hari nol (misalnya tanggal habis masa berlaku kartu kredit).
Jenis terkait:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
Representasi JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
bidang | |
---|---|
year | Tahun tanggalnya. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun. |
month | Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari. |
day | Hari dalam sebulan. Harus dari 1 hingga 31 dan valid untuk tahun dan bulan, atau 0 untuk menentukan tahun tersendiri atau tahun dan bulan yang harinya tidak penting. |
Data
Data merinci pengiriman pesan
Representasi JSON |
---|
{ "countMessagesAccepted": string, "messageOutcomePercents": { object ( |
bidang | |
---|---|
countMessagesAccepted | Jumlah pesan yang diterima oleh FCM yang ditujukan untuk perangkat Android. Perangkat yang ditargetkan harus ikut serta dalam pengumpulan informasi penggunaan dan diagnostik. |
messageOutcomePercents | Perincian hasil pengiriman pesan yang saling eksklusif. |
deliveryPerformancePercents | Informasi tambahan tentang kinerja pengiriman untuk pesan yang berhasil terkirim. |
messageInsightPercents | Wawasan umum tambahan tentang pengiriman pesan. |
Persentase Hasil Pesan
Rincian persentase hasil pengiriman pesan. Kategori-kategori ini saling eksklusif. Semua persentase dihitung dengan countMessagesAccepted
sebagai penyebutnya. Kategori-kategori ini mungkin tidak memperhitungkan semua hasil pesan.
Representasi JSON |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
bidang | |
---|---|
delivered | Persentase semua pesan diterima yang berhasil terkirim ke perangkat. |
pending | Persentase pesan yang diterima pada hari ini yang tidak dibatalkan dan tidak terkirim, karena sambungan perangkat terputus (hingga akhir hari Amerika/Los_Angeles saat pesan dikirim ke FCM). Sebagian dari pesan ini akan dikirimkan keesokan harinya saat perangkat tersambung, namun pesan lainnya mungkin ditujukan ke perangkat yang pada akhirnya tidak pernah tersambung kembali. |
droppedTooManyPendingMessages | Persentase pesan diterima yang dibatalkan karena terlalu banyak pesan yang tidak terkirim dan tidak dapat diciutkan . Secara khusus, setiap instance aplikasi hanya dapat menyimpan 100 pesan tertunda di server kami untuk perangkat yang terputus. Saat perangkat itu terhubung kembali, pesan-pesan itu terkirim. Jika ada lebih dari jumlah maksimum pesan yang tertunda, kami memanggil OnDeletedMessages() di SDK kami alih-alih mengirimkan pesan. |
droppedAppForceStopped | Persentase pesan diterima yang dibatalkan karena aplikasi dihentikan paksa pada perangkat pada saat pengiriman dan percobaan ulang tidak berhasil. |
droppedDeviceInactive | Persentase pesan diterima yang dihapus karena perangkat target tidak aktif. FCM akan mengirimkan pesan jika perangkat target dianggap tidak aktif oleh server kami. Jika perangkat terhubung kembali, kami memanggil OnDeletedMessages() di SDK kami alih-alih mengirimkan pesan. |
Persentase Kinerja Pengiriman
Ikhtisar kinerja pengiriman untuk pesan yang berhasil terkirim. Semua persentase dihitung dengan countMessagesAccepted
sebagai penyebutnya. Kategori-kategori ini tidak saling eksklusif; sebuah pesan dapat tertunda karena berbagai alasan.
Representasi JSON |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
bidang | |
---|---|
deliveredNoDelay | Persentase pesan diterima yang dikirimkan ke perangkat tanpa penundaan dari sistem FCM. |
delayedDeviceOffline | Persentase pesan diterima yang tertunda karena perangkat target tidak terhubung pada saat pengiriman. Pesan-pesan ini akhirnya terkirim ketika perangkat terhubung kembali. |
delayedDeviceDoze | Persentase pesan yang diterima namun tertunda karena perangkat berada dalam mode istirahat. Hanya pesan prioritas normal yang harus ditunda karena mode istirahat. |
delayedMessageThrottled | Persentase pesan yang diterima namun tertunda karena pembatasan pesan, seperti pembatasan pesan yang dapat diciutkan atau pembatasan kecepatan pesan maksimum . |
delayedUserStopped | Persentase pesan yang diterima namun tertunda karena profil pengguna perangkat yang dituju dihentikan pada perangkat target pada saat pengiriman. Pesan-pesan tersebut akhirnya terkirim ketika profil pengguna dimulai kembali. |
Persen MessageInsight
Informasi tambahan tentang pengiriman pesan. Semua persentase dihitung dengan countMessagesAccepted
sebagai penyebutnya.
Representasi JSON |
---|
{ "priorityLowered": number } |
bidang | |
---|---|
priorityLowered | Persentase pesan diterima yang prioritasnya diturunkan dari tinggi ke normal. Lihat dokumentasi untuk mengatur prioritas pesan . |