Method: projects.androidApps.deliveryData.list

Mencantumkan data pengiriman gabungan untuk aplikasi Android tertentu.

Permintaan HTTP

GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib diisi. Aplikasi yang akan mencantumkan data pengiriman. Format: projects/{projectId}/androidApps/{appId}

Parameter kueri

Parameter
pageSize

integer

Jumlah maksimum entri yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, maksimal 1.000 entri akan ditampilkan. Nilai maksimumnya adalah 10.000; nilai di atas 10.000 akan dibatasi menjadi 10.000. Setelan default ini dapat berubah dari waktu ke waktu.

pageToken

string

Token halaman, diterima dari panggilan ListAndroidDeliveryDataRequest sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya. Saat memberi nomor halaman, semua parameter lain yang diberikan ke ListAndroidDeliveryDataRequest harus cocok dengan panggilan yang menyediakan token halaman.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Pesan respons untuk deliveryData.list.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
Kolom
androidDeliveryData[]

object (AndroidDeliveryData)

Data pengiriman untuk aplikasi yang disediakan. Akan ada satu entri per kombinasi label aplikasi, tanggal, dan analisis.

nextPageToken

string

Token, yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak ada halaman berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

DataPengirimanAndroid

Data pengiriman pesan untuk kombinasi tanggal, aplikasi, dan label analisis tertentu.

Representasi JSON
{
  "appId": string,
  "date": {
    object (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
Kolom
appId

string

ID aplikasi tempat pesan dikirim.

date

object (Date)

Tanggal yang diwakili oleh entri ini.

analyticsLabel

string

Label analisis yang terkait dengan pesan yang dikirim. Semua pesan yang dikirim tanpa label analisis akan dikelompokkan bersama dalam satu entri.

data

object (Data)

Data untuk appId, date, dan analyticsLabel yang ditentukan.

Tanggal

Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal ini relatif terhadap Kalender Gregorian. ID ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.

month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.

day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

Data

Data yang memerinci pengiriman pesan

Representasi JSON
{
  "countMessagesAccepted": string,
  "countNotificationsAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  },
  "proxyNotificationInsightPercents": {
    object (ProxyNotificationInsightPercents)
  }
}
Kolom
countMessagesAccepted

string (int64 format)

Jumlah pesan yang diterima oleh FCM yang ditujukan untuk perangkat Android. Perangkat yang ditargetkan harus memilih ikut serta dalam pengumpulan informasi penggunaan dan diagnostik.

countNotificationsAccepted

string (int64 format)

Jumlah notifikasi yang diterima oleh FCM yang ditujukan untuk perangkat Android. Perangkat yang ditargetkan harus memilih ikut serta dalam pengumpulan informasi penggunaan dan diagnostik.

messageOutcomePercents

object (MessageOutcomePercents)

Perincian hasil pengiriman pesan yang saling eksklusif.

deliveryPerformancePercents

object (DeliveryPerformancePercents)

Informasi tambahan tentang performa pengiriman untuk pesan yang berhasil dikirim.

messageInsightPercents

object (MessageInsightPercents)

Insight umum tambahan tentang pengiriman pesan.

proxyNotificationInsightPercents

object (ProxyNotificationInsightPercents)

Insight tambahan tentang pengiriman notifikasi proxy.

MessageOutcomePercents

Perincian persentase hasil pengiriman pesan. Kategori ini sama-sama bersifat eksklusif. Semua persentase dihitung dengan countMessagesAccepted sebagai penyebut. Kategori ini mungkin tidak memperhitungkan semua hasil pesan.

Representasi JSON
{
  "delivered": number,
  "pending": number,
  "collapsed": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number,
  "droppedTtlExpired": number
}
Kolom
delivered

number

Persentase semua pesan yang diterima dan berhasil dikirimkan ke perangkat.

pending

number

Persentase pesan yang diterima pada hari ini, yang tidak dihapus dan tidak terkirim, karena perangkat terputus (per akhir hari America/Los_Angeles saat pesan dikirim ke FCM). Sebagian dari pesan tersebut akan dikirimkan keesokan harinya saat perangkat terhubung, tetapi sebagian lainnya mungkin ditujukan ke perangkat yang pada akhirnya tidak pernah terhubung kembali.

collapsed

number

Persentase pesan yang diterima yang diciutkan oleh pesan lain.

droppedTooManyPendingMessages

number

Persentase pesan yang diterima, yang dihapus karena terlalu banyak pesan yang tidak terkirim dan tidak dapat diciutkan. Secara khusus, setiap instance aplikasi hanya dapat memiliki 100 pesan tertunda yang disimpan di server kami untuk perangkat yang terputus. Ketika perangkat itu terhubung kembali, pesan tersebut akan dikirim. Jika pesan yang tertunda melebihi batas maksimum, kami akan memanggil OnDeletedMessages() di SDK, bukan mengirim pesan.

droppedAppForceStopped

number

Persentase pesan yang diterima dan dihapus karena aplikasi dipaksa berhenti di perangkat pada saat pengiriman dan percobaan ulang tidak berhasil.

droppedDeviceInactive

number

Persentase pesan yang diterima, yang dihapus karena perangkat target tidak aktif. FCM akan menghapus pesan jika perangkat target dianggap tidak aktif oleh server kami. Jika perangkat terhubung kembali, kita akan memanggil OnDeletedMessages() di SDK, bukan mengirimkan pesan.

droppedTtlExpired

number

Persentase pesan yang diterima dan berakhir masa berlakunya karena Time To Live (TTL) telah berlalu sebelum perangkat target terhubung kembali.

Persentase DeliveryPerformance

Ringkasan performa pengiriman untuk pesan yang berhasil dikirim. Semua persentase dihitung dengan countMessagesAccepted sebagai penyebut. Kategori ini tidak saling eksklusif; pesan dapat tertunda karena beberapa alasan.

Representasi JSON
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
Kolom
deliveredNoDelay

number

Persentase pesan yang diterima dan dikirimkan ke perangkat tanpa penundaan dari sistem FCM.

delayedDeviceOffline

number

Persentase pesan yang diterima yang tertunda karena perangkat target tidak terhubung pada saat pengiriman. Pesan ini akhirnya dikirim saat perangkat terhubung kembali.

delayedDeviceDoze

number

Persentase pesan yang diterima yang tertunda karena perangkat dalam mode istirahatkan. Hanya pesan prioritas normal yang perlu ditunda karena mode istirahatkan.

delayedMessageThrottled

number

Persentase pesan yang diterima yang tertunda karena throttling pesan, seperti throttling pesan yang dapat diciutkan atau throttling kecepatan pesan maksimum.

delayedUserStopped

number

Persentase pesan yang diterima yang tertunda karena profil pengguna perangkat yang dimaksud telah dihentikan di perangkat target pada saat pengiriman. Pesan akhirnya dikirim saat profil pengguna dimulai lagi.

MessageInsightPercents

Informasi tambahan tentang pengiriman pesan. Semua persentase dihitung dengan countMessagesAccepted sebagai penyebut.

Representasi JSON
{
  "priorityLowered": number
}
Kolom
priorityLowered

number

Persentase pesan yang diterima yang prioritasnya diturunkan dari tinggi ke normal. Lihat dokumentasi untuk menyetel prioritas pesan.

ProxyNotificationInsightPercents

Informasi tambahan tentang pengiriman notifikasi proxy. Semua persentase dihitung dengan countNotificationsAccepted sebagai penyebut.

Representasi JSON
{
  "proxied": number,
  "failed": number,
  "skippedUnsupported": number,
  "skippedNotThrottled": number,
  "skippedUnconfigured": number,
  "skippedOptedOut": number
}
Kolom
proxied

number

Persentase notifikasi yang diterima yang berhasil di-proxy-kan oleh layanan Google Play.

failed

number

Persentase notifikasi yang diterima yang gagal di-proxy-kan. Hal ini biasanya disebabkan oleh pengecualian yang terjadi saat memanggil notifyAsPackage.

skippedUnsupported

number

Persentase notifikasi yang diterima yang dilewati karena notifikasi proxy tidak didukung untuk penerima.

skippedNotThrottled

number

Persentase notifikasi yang diterima yang dilewati karena pesan tidak dibatasi.

skippedUnconfigured

number

Persentase notifikasi yang diterima yang dilewati karena konfigurasi yang diperlukan agar notifikasi di-proxy-kan tidak ada.

skippedOptedOut

number

Persentase notifikasi yang diterima yang dilewati karena aplikasi tidak mengizinkan pesan tersebut untuk di-proxy-kan.