Method: projects.androidApps.deliveryData.list

Belirli bir Android uygulaması için toplu yayınlama 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. İletim 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 sonuç döndürebilir. Belirtilmemesi durumunda en fazla 1.000 giriş döndürülür. Maksimum değer 10.000'dir; 10.000'den büyük değerler 10.000 ile sınırlanır. Bu varsayılan ayar zamanla değişebilir.

pageToken

string

Önceki ListAndroidDeliveryDataRequest çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bu kodu sağlayın. Sayfalara ayırma işlemi sırasında, ListAndroidDeliveryDataRequest için 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 gönderim verileri. Her uygulama, tarih ve analiz etiketi kombinasyonu için bir giriş olacaktır.

nextPageToken

string

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

Yetkilendirme 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 ileti teslimi 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 analytics 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

Doğum günü gibi tam veya kısmi bir takvim tarihini temsil eder. Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim ile görelidir. 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ılı olan bir ay ve gün (örneğin, yıl dönümü).
  • Sıfır ay ve sıfır gün olmak üzere tek başına bir yıl.
  • 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 tarih belirtmek için 0 olmalıdır.

month

integer

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

day

integer

Ayın günü. 1 ile 31 arasında olup yıl ve ay için geçerli olmalıdır. Yılın tek başına olduğu yıl ya da günün önemli olmadığı yıl ve ay belirtilmelidir.

Veriler

Mesajlaşmayı ayrıntılı olarak açıklayan 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 Android cihazlara yönelik olarak kabul edilen iletilerin sayısı. Hedeflenen cihaz, kullanım ve teşhis bilgilerinin toplanmasını etkinleştirmiş olmalıdır.

countNotificationsAccepted

string (int64 format)

FCM tarafından Android cihazlar için kabul edilen bildirimlerin sayısı. Hedeflenen cihaz, kullanım ve teşhis bilgilerinin toplanmasını etkinleştirmiş olmalıdır.

messageOutcomePercents

object (MessageOutcomePercents)

İleti teslimi sonuçlarının karşılıklı olarak hariç tutulduğu 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 Sonuçları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 mesaj sonuçlarını kapsamayabilir.

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

number

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

pending

number

Söz konusu günde kabul edilen ancak cihazın bağlantısının kesildiği için iptal edilmeyen ve teslim edilmeyen iletilerin yüzdesi (iletinin FCM'ye gönderildiği Amerika/Los_Angeles gününün sonu itibarıyla). Bu mesajların bir kısmı, cihaz bağlandığında ertesi gün teslim edilir. Diğerleri ise nihayetinde hiçbir zaman yeniden bağlanmayan cihazlara gönderilmiş olabilir.

droppedTooManyPendingMessages

number

Teslim edilmeyen çok fazla daraltılamayan ileti nedeniyle bırakılan, kabul edilen iletilerin yüzdesi. Daha açık belirtecek olursak, bağlantısı kesilen bir cihaz için her uygulama örneğinin sunucularımızda depolanan 100 bekleyen mesajı olabilir. Cihaz yeniden bağlandığında bu mesajlar teslim edilir. Bekleyen mesaj sayısı üst sınırından fazla olduğunda, SDK'mızda mesajları iletmek yerine OnDeletedMessages() yöntemini çağırırız.

droppedAppForceStopped

number

Teslim sırasında uygulama cihazda zorla durdurulduğu ve yeniden denemeler başarısız olduğu için bırakılan, kabul edilen iletilerin yüzdesi.

droppedDeviceInactive

number

Kabul edilen ve hedef cihaz etkin olmadığı için bırakılan mesajların yüzdesi. Hedef cihazın sunucularımız tarafından etkin olmadığı kabul edilirse FCM, mesajları bırakır. Bir cihaz yeniden bağlanırsa mesajları iletmek yerine SDK'mızda On deletedMessages() yöntemini çağırırız.

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ılamaz. Bir iletide birden çok nedenden dolayı gecikme yaşanabilir.

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

number

FCM sisteminden gecikme olmadan cihaza teslim edilen, kabul edilmiş iletilerin yüzdesi.

delayedDeviceOffline

number

Gönderme sırasında hedef cihaz bağlı olmadığı için geciken, kabul edilmiş iletilerin yüzdesi. Bu mesajlar, cihaz yeniden bağlandığında sonunda teslim edildi.

delayedDeviceDoze

number

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

delayedMessageThrottled

number

Kabul edilen ve ileti kısıtlama (ör. daraltılabilir ileti kısıtlama veya maksimum ileti hızı kısıtlama) nedeniyle geciken iletilerin yüzdesi.

delayedUserStopped

number

Gönderme sırasında, hedeflenen cihaz kullanıcı profili hedef cihazda durdurulduğu için geciken, kabul edilen iletilerin yüzdesi. İletiler, kullanıcı profili yeniden başlatıldığında sonunda teslim edildi.

Mesaj AnaliziYüzdeleri

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

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

number

Kabul edilmiş ve önceliği yüksekten normale düşmüş olan iletilerin yüzdesi. İleti önceliğini ayarlama dokümanlarına bakın.

ProxyBildirimiYüzdeleri

Proxy bildirim teslimi hakkında ek bilgi. 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 kullanılarak gönderilen, kabul edilen bildirimlerin yüzdesi.

failed

number

Proxy kullanılamayan, kabul edilen 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 kabul edilen ve atlanan bildirimlerin yüzdesi.

skippedNotThrottled

number

İletiler kısıtlanmadığı için atlanan, kabul edilmiş bildirimlerin yüzdesi.

skippedUnconfigured

number

Bildirimlerin proxy kullanılarak kullanılabilmesi için gereken yapılandırmalar eksik olduğundan atlanan, kabul edilen bildirimlerin yüzdesi.

skippedOptedOut

number

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