Method: projects.androidApps.deliveryData.list

Belirtilen Android uygulaması için toplu teslimat verilerini listeleyin.

HTTP isteği

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

URL, gRPC Kod Dönüştürme sözdizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Gerekli. Teslimat verilerinin listeleneceği uygulama. Biçim: projects/{project_id}/androidApps/{appId}

Sorgu parametreleri

Parametreler
pageSize

integer

Döndürülecek maksimum giriş sayısı. Hizmet bu değerden daha azını döndürebilir. Belirtilmemişse en fazla 1.000 giriş döndürülecektir. Maksimum değer 10.000'dir; 10.000'in üzerindeki değerler 10.000 ile sınırlandırılacaktır. Bu varsayılan zaman içinde değişebilir.

pageToken

string

Önceki bir ListAndroidDeliveryDataRequest çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın. Sayfalandırma sırasında ListAndroidDeliveryDataRequest sağlanan diğer tüm parametrelerin, sayfa belirtecini sağlayan çağrıyla eşleşmesi gerekir.

Talep gövdesi

İstek gövdesi boş olmalıdır.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi aşağıdaki yapıya sahip verileri içerir:

DeliveryData.list için yanıt mesajı.

JSON gösterimi
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
Alanlar
androidDeliveryData[]

object ( AndroidDeliveryData )

Sağlanan uygulamaya ilişkin teslimat verileri. Uygulama, tarih ve analiz etiketi kombinasyonu başına bir giriş olacaktır.

nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir belirteç. Bu alan atlanırsa sonraki sayfalar olmaz.

Yetki Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

AndroidDeliveryData

Belirli bir tarih, uygulama ve analiz etiketi kombinasyonu için mesaj teslim verileri.

JSON gösterimi
{
  "appId": string,
  "date": {
    object (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
Alanlar
appId

string

Mesajların gönderildiği uygulama kimliği.

date

object ( Date )

Bu girişin temsil ettiği tarih.

analyticsLabel

string

Gönderilen mesajlarla ilişkili analiz etiketi. Analiz etiketi olmadan gönderilen tüm iletiler tek bir girişte gruplandırılacaktır.

data

object ( Data )

Belirtilen appId , date ve analyticsLabel ilişkin veriler.

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini temsil eder. Günün saati ve saat dilimi ya başka bir yerde belirtilmiştir ya da önemsizdir. Tarih Gregoryen Takvimine göredir. Bu aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerlerine sahip tam tarih.
  • Sıfır yılı olan bir ay ve gün (örneğin, yıl dönümü).
  • Sıfır ayı ve sıfır günü olan, başlı başına bir yıl.
  • Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartının son kullanma tarihi).

İlgili türler:

JSON gösterimi
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. Yıl olmadan bir tarih belirtmek için 1 ile 9999 arasında veya 0 olmalıdır.

month

integer

Bir yılın ayı. Ay ve gün olmadan yılı belirtmek için 1 ile 12 arasında veya 0 olmalıdır.

day

integer

Bir ayın günü. 1'den 31'e kadar olmalı ve yıl ve ay için geçerli olmalıdır veya tek başına bir yıl veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır.

Veri

Mesajlaşma dağıtımını detaylandıran veriler

JSON gösterimi
{
  "countMessagesAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  }
}
Alanlar
countMessagesAccepted

string ( int64 format)

FCM tarafından Android cihazlara yönelik olarak kabul edilen mesajların sayısı. Hedeflenen cihazın kullanım ve teşhis bilgilerinin toplanmasına izin vermiş olması gerekir.

messageOutcomePercents

object ( MessageOutcomePercents )

Mesaj teslimi sonuçlarının birbirini dışlayan dökümü.

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

Başarıyla teslim edilen iletilerin teslim performansı hakkında ek bilgi.

messageInsightPercents

object ( MessageInsightPercents )

İleti teslimiyle ilgili ek genel bilgiler.

MesajSonucuYüzdeleri

Mesaj teslim sonuçlarının yüzdesel dökümü. Bu kategoriler birbirini dışlar. Tüm yüzdeler payda olarak countMessagesAccepted ile hesaplanır. Bu kategoriler tüm mesaj sonuçlarını hesaba katmayabilir.

JSON gösterimi
{
  "delivered": number,
  "pending": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number
}
Alanlar
delivered

number

Cihaza başarıyla teslim edilen tüm kabul edilen mesajların yüzdesi.

pending

number

Cihaz bağlantısının kesilmesi nedeniyle (mesajın FCM'ye gönderildiği Amerika/Los_Angeles gününün sonu itibarıyla) bu günde kabul edilen ve bırakılmayan ve teslim edilmeyen mesajların yüzdesi. Bu mesajların bir kısmı ertesi gün cihaz bağlandığında iletilecek, ancak diğerleri bir daha asla yeniden bağlanmayacak cihazlara gönderilecek.

droppedTooManyPendingMessages

number

Çok fazla teslim edilmemiş, daraltılamaz ileti nedeniyle reddedilen kabul edilen iletilerin yüzdesi. Spesifik olarak, her uygulama örneğinde, bağlantısı kesilen bir cihaz için sunucularımızda depolanan yalnızca 100 bekleyen mesaj bulunabilir. Bu cihaz yeniden bağlandığında bu mesajlar iletilir. Maksimum bekleyen mesaj sayısı aşıldığında mesajları iletmek yerine SDK'mızda OnDeletedMessages()' ı çağırırız.

droppedAppForceStopped

number

Teslim sırasında uygulamanın cihazda zorla durdurulması ve yeniden denemelerin başarısız olması nedeniyle bırakılan kabul edilen mesajların yüzdesi.

droppedDeviceInactive

number

Hedef cihazın etkin olmaması nedeniyle bırakılan kabul edilen mesajların yüzdesi. Hedef cihazın sunucularımız tarafından etkin olmadığı kabul edilirse FCM mesaj bırakacaktır. Bir cihaz yeniden bağlanırsa mesajları iletmek yerine SDK'mızda OnDeletedMessages() öğesini çağırırız.

TeslimatPerformansYüzdeleri

Başarıyla teslim edilen mesajların teslim performansına genel bakış. Tüm yüzdeler payda olarak countMessagesAccepted ile hesaplanır. Bu kategoriler birbirini dışlayan değildir; bir mesaj birçok nedenden dolayı gecikebilir.

JSON gösterimi
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
Alanlar
deliveredNoDelay

number

FCM sisteminden gecikme olmadan cihaza teslim edilen kabul edilen mesajların yüzdesi.

delayedDeviceOffline

number

Gönderme sırasında hedef cihazın bağlı olmaması nedeniyle geciken kabul edilen mesajların yüzdesi. Bu mesajlar sonunda cihaz yeniden bağlandığında iletildi.

delayedDeviceDoze

number

Cihazın uyku modunda olması nedeniyle geciken kabul edilen mesajların yüzdesi. Doze modu nedeniyle yalnızca normal öncelikli mesajlar ertelenmelidir.

delayedMessageThrottled

number

Daraltılabilir mesaj azaltma veya maksimum mesaj hızı azaltma gibi mesaj kısıtlama nedeniyle geciken kabul edilen mesajların yüzdesi.

delayedUserStopped

number

Gönderilme sırasında amaçlanan cihaz kullanıcı profilinin hedef cihazda durdurulması nedeniyle geciken kabul edilen mesajların yüzdesi. Mesajlar sonunda kullanıcı profili yeniden başlatıldığında teslim edildi.

MesajInsightPercents

İleti teslimi hakkında ek bilgi. Tüm yüzdeler payda olarak countMessagesAccepted ile hesaplanır.

JSON gösterimi
{
  "priorityLowered": number
}
Alanlar
priorityLowered

number

Önceliği yüksekten normale düşürülen kabul edilen mesajların yüzdesi. Mesaj önceliğini ayarlamak için belgelere bakın.