Method: projects.androidApps.deliveryData.list

Belirli bir Android uygulaması için toplu teslim verilerini listeleme.

HTTP isteği

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

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

Yol parametreleri

Parametreler
parent

string

Zorunlu. Teslim verilerinin listeleneceği uygulama. Biçim: projects/{projectId}/androidApps/{appId}

Sorgu parametreleri

Parametreler
pageSize

integer

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

pageToken

string

Önceki ListAndroidDeliveryDataRequest çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın. Sayfalara ayırma işlemi sırasında ListAndroidDeliveryDataRequest öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

İstek içeriği

İsteğin gövdesi boş olmalıdır.

Yanıt gövdesi

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

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

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

object (AndroidDeliveryData)

Sağlanan uygulama için yayınlanma verileri. Uygulama, tarih ve analiz etiketinin kombinasyonu başına tek bir giriş olur.

nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa olmaz.

Yetkilendirme kapsamları

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

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

AndroidTeslimat Verileri

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 iletilerle ilişkili analiz etiketi. Analytics etiketi olmadan gönderilen tüm iletiler tek bir girişte gruplandırılır.

data

object (Data)

Belirtilen appId, date ve analyticsLabel için veriler.

Tarih

Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

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

İlgili türler:

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

integer

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

month

integer

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

day

integer

Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin.

Veriler

Mesaj teslimini ayrıntılarıyla gösteren veriler

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

string (int64 format)

FCM tarafından kabul edilen Android cihazlara yönelik mesajların sayısı. Hedeflenen cihazda, kullanım ve teşhis bilgilerinin toplanması özelliği etkinleştirilmiş olmalıdır.

countNotificationsAccepted

string (int64 format)

FCM tarafından kabul edilen Android cihazlara yönelik bildirimlerin sayısı. Hedeflenen cihazda, kullanım ve teşhis bilgilerinin toplanması özelliği etkinleştirilmiş olmalıdır.

messageOutcomePercents

object (MessageOutcomePercents)

İleti teslimi sonuçlarının ayrı ayrı dökümü.

deliveryPerformancePercents

object (DeliveryPerformancePercents)

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

messageInsightPercents

object (MessageInsightPercents)

İleti teslimi hakkında ek genel bilgiler.

proxyNotificationInsightPercents

object (ProxyNotificationInsightPercents)

Proxy bildirim teslimi hakkında ek bilgiler.

Mesaj Sonucu Yüzdeleri

İleti teslimi sonuçlarının yüzde dökümü. Bu kategoriler birlikte kullanılamaz. Tüm yüzdeler payda olarak countMessagesAccepted ile hesaplanır. Bu kategoriler tüm ileti sonuçlarını kapsamayabilir.

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

number

Kabul edilen ve cihaza başarıyla teslim edilen tüm mesajların yüzdesi.

pending

number

Cihazın bağlantısı kesildiği için bu gün kabul edilen ancak gönderilmeyen ve teslim edilmeyen mesajların yüzdesi (mesajın FCM'ye gönderildiği Amerika/Los_Angeles gününün sonu itibarıyla). Bu mesajların bir kısmı, ertesi gün cihaz bağlandığında teslim edilir, ancak bazıları daha sonra hiç bağlanmayan cihazlara gönderilebilir.

collapsed

number

Kabul edilen ve başka bir ileti tarafından daraltılan iletilerin yüzdesi.

droppedTooManyPendingMessages

number

Teslim edilmeyen çok sayıda daraltılamayan ileti nedeniyle atlanan kabul edilmiş iletilerin yüzdesi. Daha açık belirtmek gerekirse, bağlantısı kesilen bir cihaz için her uygulama örneğinin sunucularımızda yalnızca 100 bekleyen mesajı olabilir. Söz konusu cihaz yeniden bağlandığında bu mesajlar teslim edilir. Bekleyen maksimum mesaj sayısından daha fazla mesaj varsa mesajları iletmek yerine SDK'mızda On deletedMessages() çağrısını yaparı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 edilmiş mesajların yüzdesi.

droppedDeviceInactive

number

Hedef cihaz etkin olmadığı için vazgeçilen, kabul edilen mesajların yüzdesi. Sunucularımız hedef cihazın etkin olmadığını belirlerse FCM, mesajları kaldırır. Bir cihaz yeniden bağlanırsa mesajları iletmek yerine SDK'mızda On deletedMessages() çağrısını yaparız.

droppedTtlExpired

number

Hedef cihaz yeniden bağlanmadan önce Geçerlilik Süresi (TTL) geçen kabul edilen mesajların yüzdesi.

DeliveryPerformancePercents

Başarıyla teslim edilen iletilerin teslim performansına genel bakış. Tüm yüzdeler payda olarak countMessagesAccepted ile hesaplanır. Bu kategoriler birlikte kullanılabilir; bir ileti birkaç nedenden dolayı gecikebilir.

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

number

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

delayedDeviceOffline

number

Gönderildiği sırada hedef cihaz bağlı olmadığı için geciken kabul edilen mesajların yüzdesi. Bu mesajlar sonunda cihaz yeniden bağlandığında teslim edildi.

delayedDeviceDoze

number

Cihaz doz modunda olduğu için geciken kabul edilen mesajların yüzdesi. Doz modu nedeniyle yalnızca normal öncelikli mesajlar gecikmelidir.

delayedMessageThrottled

number

Daraltılabilir ileti kısıtlama veya maksimum ileti hızı kısıtlama gibi ileti kısıtlama nedeniyle geciken kabul edilen iletilerin yüzdesi.

delayedUserStopped

number

Hedeflenen cihaz kullanıcı profili gönderme sırasında hedef cihazda durdurulduğu için geciken kabul edilmiş mesajların yüzdesi. Mesajlar sonuçta kullanıcı profili yeniden başlatıldığında teslim edilmiştir.

Mesaj Analizi Yüzdeleri

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

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

number

Kabul edilmiş, öncelik düzeyi yüksekten normale düşürülmüş iletilerin yüzdesi. İleti önceliğini ayarlamayla ilgili dokümanlara göz atın.

ProxyBildirimInsightYüzdeleri

Proxy bildirim teslimi hakkında ek bilgiler. Tüm yüzdeler payda olarak countNotificationsAccepted ile hesaplanır.

JSON gösterimi
{
  "proxied": number,
  "failed": number,
  "skippedUnsupported": number,
  "skippedNotThrottled": number,
  "skippedUnconfigured": number,
  "skippedOptedOut": number
}
Alanlar
proxied

number

Google Play hizmetleri tarafından başarıyla proxy'den alınan kabul edilen bildirimlerin yüzdesi.

failed

number

Kabul edilen ve proxy kullanılamayan bildirimlerin yüzdesi. Bu durum genellikle notifyAsPackage çağrılırken oluşan istisnalardan kaynaklanır.

skippedUnsupported

number

Alıcı için proxy bildirimi desteklenmediğinden atlanan, kabul edilen bildirimlerin yüzdesi.

skippedNotThrottled

number

Mesajlar kısıtlanmadığı için atlanan kabul edilen bildirimlerin yüzdesi.

skippedUnconfigured

number

Bildirimlerin proxy tarafından kullanılması için gereken yapılandırmalar eksik olduğundan atlanan kabul edilen bildirimlerin yüzdesi.

skippedOptedOut

number

Uygulama, bu mesajlarda proxy kullanılmasına izin vermediği için atlanan kabul edilen bildirimlerin yüzdesi.