Method: projects.androidApps.deliveryData.list

Wyświetl zbiorcze dane dotyczące dostawy dla danej aplikacji na Androida.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC .

Parametry ścieżki

Parametry
parent

string

Wymagany. Aplikacja, dla której chcesz wyświetlić dane dotyczące dostawy. Format: projects/{project_id}/androidApps/{appId}

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba wpisów do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 1000 wpisów. Maksymalna wartość to 10 000; wartości powyżej 10 000 zostaną ograniczone do 10 000. To ustawienie domyślne może z czasem ulec zmianie.

pageToken

string

Token strony otrzymany z poprzedniego wywołania ListAndroidDeliveryDataRequest . Podaj to, aby pobrać kolejną stronę. Podczas stronicowania wszystkie inne parametry dostarczone do ListAndroidDeliveryDataRequest muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Jeśli się powiedzie, treść odpowiedzi zawiera dane o następującej strukturze:

Komunikat odpowiedzi dla DeliveryData.list.

Reprezentacja JSON
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
Pola
androidDeliveryData[]

object ( AndroidDeliveryData )

Dane dostawy dla dostarczonej aplikacji. Na każdą kombinację aplikacji, daty i etykiety analitycznej będzie przypadał jeden wpis.

nextPageToken

string

Token, który można wysłać jako pageToken w celu pobrania następnej strony. Jeżeli to pole zostanie pominięte, kolejne strony nie będą wyświetlane.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Dane dostawy Androida

Dane dotyczące dostarczenia wiadomości dla danej kombinacji daty, aplikacji i etykiety analitycznej.

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

string

Identyfikator aplikacji, do której wysłano wiadomości.

date

object ( Date )

Data reprezentowana przez ten wpis.

analyticsLabel

string

Etykieta analityczna powiązana z wysłanymi wiadomościami. Wszystkie wiadomości wysłane bez etykiety analitycznej zostaną zgrupowane w jednym wpisie.

data

object ( Data )

Dane dla określonego appId , date i analyticsLabel .

Data

Reprezentuje całą lub częściową datę kalendarzową, taką jak urodziny. Pora dnia i strefa czasowa są albo określone gdzie indziej, albo są nieistotne. Data jest zależna od kalendarza gregoriańskiego. Może to oznaczać jedno z poniższych:

  • Pełna data z niezerowymi wartościami roku, miesiąca i dnia.
  • Miesiąc i dzień z rokiem zerowym (na przykład rocznica).
  • Rok sam w sobie, z zerowym miesiącem i zerowym dniem.
  • Rok i miesiąc z dniem zerowym (na przykład datą ważności karty kredytowej).

Powiązane typy:

Reprezentacja JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi wynosić od 1 do 9999 lub 0, aby określić datę bez roku.

month

integer

Miesiąc roku. Musi wynosić od 1 do 12 lub 0, aby określić rok bez miesiąca i dnia.

day

integer

Dzień miesiąca. Musi wynosić od 1 do 31 i obowiązywać dla roku i miesiąca, lub 0, aby określić sam rok lub rok i miesiąc, gdy dzień nie jest znaczący.

Dane

Dane szczegółowe dotyczące dostarczania wiadomości

Reprezentacja JSON
{
  "countMessagesAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  }
}
Pola
countMessagesAccepted

string ( int64 format)

Liczba wiadomości zaakceptowanych przez FCM przeznaczonych na urządzenia z systemem Android. Docelowe urządzenie musi wyrazić zgodę na gromadzenie informacji o użytkowaniu i diagnostyce.

messageOutcomePercents

object ( MessageOutcomePercents )

Wzajemnie wykluczający się podział wyników dostarczania wiadomości.

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

Dodatkowe informacje o wydajności dostarczania wiadomości, które zostały pomyślnie dostarczone.

messageInsightPercents

object ( MessageInsightPercents )

Dodatkowe ogólne informacje na temat dostarczania wiadomości.

WiadomośćWynikProcenty

Procentowy podział wyników dostarczenia wiadomości. Kategorie te wykluczają się wzajemnie. Wszystkie wartości procentowe są obliczane z licznikiem countMessagesAccepted . Kategorie te mogą nie uwzględniać wszystkich wyników wiadomości.

Reprezentacja JSON
{
  "delivered": number,
  "pending": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number
}
Pola
delivered

number

Procent wszystkich zaakceptowanych wiadomości, które zostały pomyślnie dostarczone na urządzenie.

pending

number

Procent wiadomości przyjętych tego dnia, które nie zostały odrzucone i niedostarczone ze względu na odłączenie urządzenia (stan na koniec dnia w Ameryce/Los Angeles, kiedy wiadomość została wysłana do FCM). Część tych wiadomości zostanie dostarczona następnego dnia, kiedy urządzenie się połączy, ale inne mogą zostać przeznaczone do urządzeń, które ostatecznie nigdy się nie połączą.

droppedTooManyPendingMessages

number

Procent zaakceptowanych wiadomości, które zostały odrzucone z powodu zbyt dużej liczby niedostarczonych wiadomości, których nie można zwinąć . W szczególności każda instancja aplikacji może przechowywać na naszych serwerach tylko 100 oczekujących wiadomości dla odłączonego urządzenia. Gdy to urządzenie ponownie się połączy, wiadomości zostaną dostarczone. Jeśli jest więcej niż maksymalna liczba oczekujących wiadomości, zamiast dostarczać wiadomości, wywołujemy funkcję OnDeletedMessages() w naszym zestawie SDK.

droppedAppForceStopped

number

Procent zaakceptowanych wiadomości, które zostały odrzucone ze względu na wymuszone zatrzymanie aplikacji na urządzeniu w momencie dostarczenia i ponowne próby nie powiodły się.

droppedDeviceInactive

number

Procent zaakceptowanych wiadomości, które zostały odrzucone, ponieważ urządzenie docelowe było nieaktywne. FCM będzie odrzucać wiadomości, jeśli nasze serwery uznają urządzenie docelowe za nieaktywne. Jeśli urządzenie ponownie się połączy, zamiast dostarczać wiadomości, wywołujemy funkcję OnDeletedMessages() w naszym zestawie SDK.

DostawaWydajnośćProcenty

Przegląd wydajności dostarczania wiadomości, które zostały pomyślnie dostarczone. Wszystkie wartości procentowe są obliczane z licznikiem countMessagesAccepted . Kategorie te nie wykluczają się wzajemnie; wiadomość może być opóźniona z wielu powodów.

Reprezentacja JSON
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
Pola
deliveredNoDelay

number

Procent zaakceptowanych wiadomości, które zostały bezzwłocznie dostarczone na urządzenie z systemu FCM.

delayedDeviceOffline

number

Procent zaakceptowanych wiadomości, które zostały opóźnione, ponieważ urządzenie docelowe nie było podłączone w momencie wysyłania. Wiadomości te zostały ostatecznie dostarczone po ponownym podłączeniu urządzenia.

delayedDeviceDoze

number

Procent zaakceptowanych wiadomości, które zostały opóźnione, ponieważ urządzenie było w trybie uśpienia. Tylko wiadomości o normalnym priorytecie powinny być opóźnione ze względu na tryb drzemki.

delayedMessageThrottled

number

Procent zaakceptowanych wiadomości, które zostały opóźnione z powodu ograniczania wiadomości, np. ograniczania wiadomości zwijanych lub ograniczania maksymalnej szybkości wiadomości .

delayedUserStopped

number

Procent zaakceptowanych wiadomości, które zostały opóźnione, ponieważ profil użytkownika zamierzonego urządzenia został zatrzymany na urządzeniu docelowym w momencie wysyłania. Wiadomości zostały ostatecznie dostarczone po ponownym uruchomieniu profilu użytkownika.

MessageInsightProcenty

Dodatkowe informacje na temat dostarczania wiadomości. Wszystkie wartości procentowe są obliczane z licznikiem countMessagesAccepted .

Reprezentacja JSON
{
  "priorityLowered": number
}
Pola
priorityLowered

number

Procent zaakceptowanych wiadomości, których priorytet został obniżony z wysokiego do normalnego. Zobacz dokumentację dotyczącą ustawiania priorytetu wiadomości .