- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Dane dostawy Androida
- Data
- Dane
- WiadomośćWynikProcenty
- DostawaWydajnośćProcenty
- MessageInsightProcenty
- Spróbuj!
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 | Wymagany. Aplikacja, dla której chcesz wyświetlić dane dotyczące dostawy. Format: |
Parametry zapytania
Parametry | |
---|---|
pageSize | 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 | Token strony otrzymany z poprzedniego wywołania |
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 ( |
Pola | |
---|---|
androidDeliveryData[] | Dane dostawy dla dostarczonej aplikacji. Na każdą kombinację aplikacji, daty i etykiety analitycznej będzie przypadał jeden wpis. |
nextPageToken | Token, który można wysłać jako |
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 ( |
Pola | |
---|---|
appId | Identyfikator aplikacji, do której wysłano wiadomości. |
date | Data reprezentowana przez ten wpis. |
analyticsLabel | Etykieta analityczna powiązana z wysłanymi wiadomościami. Wszystkie wiadomości wysłane bez etykiety analitycznej zostaną zgrupowane w jednym wpisie. |
data | Dane dla określonego |
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:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
Reprezentacja JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Pola | |
---|---|
year | Rok daty. Musi wynosić od 1 do 9999 lub 0, aby określić datę bez roku. |
month | Miesiąc roku. Musi wynosić od 1 do 12 lub 0, aby określić rok bez miesiąca i dnia. |
day | 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 ( |
Pola | |
---|---|
countMessagesAccepted | 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 | Wzajemnie wykluczający się podział wyników dostarczania wiadomości. |
deliveryPerformancePercents | Dodatkowe informacje o wydajności dostarczania wiadomości, które zostały pomyślnie dostarczone. |
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 | Procent wszystkich zaakceptowanych wiadomości, które zostały pomyślnie dostarczone na urządzenie. |
pending | 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 | 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 | 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 | 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 | Procent zaakceptowanych wiadomości, które zostały bezzwłocznie dostarczone na urządzenie z systemu FCM. |
delayedDeviceOffline | 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 | 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 | 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 | 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 | Procent zaakceptowanych wiadomości, których priorytet został obniżony z wysokiego do normalnego. Zobacz dokumentację dotyczącą ustawiania priorytetu wiadomości . |