Method: projects.androidApps.deliveryData.list

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

string

Diperlukan. Aplikasi untuk membuat daftar data pengiriman. Format: projects/{project_id}/androidApps/{appId}

Parameter kueri

Parameter
pageSize

integer

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

string

Token halaman, diterima dari panggilan ListAndroidDeliveryDataRequest sebelumnya. Berikan ini untuk mengambil halaman berikutnya. Saat membuat paginasi, semua parameter lain yang diberikan ke ListAndroidDeliveryDataRequest harus cocok dengan panggilan yang memberikan token halaman.

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 (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
bidang
androidDeliveryData[]

object ( AndroidDeliveryData )

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

nextPageToken

string

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

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 (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
bidang
appId

string

ID aplikasi tujuan pengiriman pesan.

date

object ( Date )

Tanggal diwakili oleh entri ini.

analyticsLabel

string

Label analitik yang terkait dengan pesan yang dikirim. Semua pesan yang dikirim tanpa label analitik akan dikelompokkan menjadi 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. 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:

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

integer

Tahun tanggalnya. 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 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 (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  }
}
bidang
countMessagesAccepted

string ( int64 format)

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

messageOutcomePercents

object ( MessageOutcomePercents )

Perincian hasil pengiriman pesan yang saling eksklusif.

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

Informasi tambahan tentang kinerja pengiriman untuk pesan yang berhasil terkirim.

messageInsightPercents

object ( 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

number

Persentase semua pesan diterima yang berhasil terkirim ke perangkat.

pending

number

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

number

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

number

Persentase pesan diterima yang dibatalkan karena aplikasi dihentikan paksa pada perangkat pada saat pengiriman dan percobaan ulang tidak berhasil.

droppedDeviceInactive

number

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

number

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

delayedDeviceOffline

number

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

delayedDeviceDoze

number

Persentase pesan yang diterima namun tertunda karena perangkat berada dalam mode istirahat. Hanya pesan prioritas normal yang harus ditunda karena mode istirahat.

delayedMessageThrottled

number

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

delayedUserStopped

number

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

number

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