Firebase is back at Google I/O on May 14! Register now.

Questa pagina è stata tradotta dall'API Cloud Translation.

Method: projects.androidApps.deliveryData.list

Elenca i dati di consegna aggregati per l'applicazione Android specificata.

Richiesta HTTP

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

L'URL usa la sintassi di transcodifica gRPC .

Parametri del percorso

Parametri

Parametri
`parent`	`string` Necessario. L'applicazione per la quale elencare i dati di consegna. Formato: `projects/{project_id}/androidApps/{appId}`

parent

string

Necessario. L'applicazione per la quale elencare i dati di consegna. Formato: projects/{project_id}/androidApps/{appId}

Parametri di query

Parametri

Parametri
`pageSize`	`integer` Il numero massimo di voci da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Se non specificato, verranno restituite al massimo 1.000 voci. Il valore massimo è 10.000; i valori superiori a 10.000 verranno limitati a 10.000. Questa impostazione predefinita potrebbe cambiare nel tempo.
`pageToken`	`string` Un token di pagina, ricevuto da una precedente chiamata `ListAndroidDeliveryDataRequest` . Fornirlo per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a `ListAndroidDeliveryDataRequest` devono corrispondere alla chiamata che ha fornito il token della pagina.

pageSize

integer

Il numero massimo di voci da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Se non specificato, verranno restituite al massimo 1.000 voci. Il valore massimo è 10.000; i valori superiori a 10.000 verranno limitati a 10.000. Questa impostazione predefinita potrebbe cambiare nel tempo.

pageToken

string

Un token di pagina, ricevuto da una precedente chiamata ListAndroidDeliveryDataRequest . Fornirlo per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a ListAndroidDeliveryDataRequest devono corrispondere alla chiamata che ha fornito il token della pagina.

Richiedi corpo

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Messaggio di risposta per deliveryData.list.

Rappresentazione JSON
{ "androidDeliveryData": [ { object (`AndroidDeliveryData`) } ], "nextPageToken": string }

Campi

Campi
`androidDeliveryData[]`	`object ( AndroidDeliveryData )` I dati di consegna per l'app fornita. Sarà presente una voce per combinazione di app, data ed etichetta di analisi.
`nextPageToken`	`string` Un token che può essere inviato come `pageToken` per recuperare la pagina successiva. Se questo campo viene omesso, non ci sono pagine successive.

androidDeliveryData[]

object ( AndroidDeliveryData )

I dati di consegna per l'app fornita. Sarà presente una voce per combinazione di app, data ed etichetta di analisi.

nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non ci sono pagine successive.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Dati di consegna Android

Dati di consegna dei messaggi per una determinata combinazione di data, app ed etichetta di analisi.

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

Campi
`appId`	`string` L'ID dell'app a cui sono stati inviati i messaggi.
`date`	`object ( Date )` La data rappresentata da questa voce.
`analyticsLabel`	`string` L'etichetta di analisi associata ai messaggi inviati. Tutti i messaggi inviati senza etichetta analitica verranno raggruppati in un'unica voce.
`data`	`object ( Data )` I dati per `appId` , `date` e `analyticsLabel` specificati.

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Questo può rappresentare uno dei seguenti:

Una data completa, con valori di anno, mese e giorno diversi da zero.
Un mese e un giorno, con un anno pari a zero (ad esempio, un anniversario).
Un anno a parte, con un mese zero e un giorno zero.
Un anno e un mese, con un giorno zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp

Rappresentazione JSON
{ "year": integer, "month": integer, "day": integer }

Campi

Campi
`year`	`integer` Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
`month`	`integer` Mese di un anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
`day`	`integer` Giorno di un mese. Deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

month

integer

Mese di un anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.

day

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

Dati

Dati che dettagliano la consegna dei messaggi

Rappresentazione JSON

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

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

Campi
`countMessagesAccepted`	`string ( int64 format)` Conteggio dei messaggi accettati da FCM destinati ai dispositivi Android. Il dispositivo di destinazione deve aver acconsentito esplicitamente alla raccolta di informazioni sull'utilizzo e sulla diagnostica.
`messageOutcomePercents`	`object ( MessageOutcomePercents )` Suddivisione reciprocamente esclusiva dei risultati di recapito dei messaggi.
`deliveryPerformancePercents`	`object ( DeliveryPerformancePercents )` Ulteriori informazioni sulle prestazioni di recapito per i messaggi recapitati correttamente.
`messageInsightPercents`	`object ( MessageInsightPercents )` Ulteriori approfondimenti generali sulla consegna dei messaggi.

Percentuale risultato messaggio

Ripartizione percentuale dei risultati di recapito dei messaggi. Queste categorie si escludono a vicenda. Tutte le percentuali vengono calcolate con countMessagesAccepted come denominatore. Queste categorie potrebbero non rappresentare tutti i risultati dei messaggi.

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

Campi
`delivered`	`number` La percentuale di tutti i messaggi accettati recapitati correttamente al dispositivo.
`pending`	`number` La percentuale di messaggi accettati in questo giorno che non sono stati ignorati e non consegnati a causa della disconnessione del dispositivo (a partire dalla fine del giorno America/Los_Angeles in cui il messaggio è stato inviato a FCM). Una parte di questi messaggi verrà recapitata il giorno successivo quando il dispositivo si connetterà, ma altri potrebbero essere destinati a dispositivi che alla fine non si riconnetteranno mai.
`droppedTooManyPendingMessages`	`number` La percentuale di messaggi accettati che sono stati eliminati a causa di troppi messaggi non comprimibili non consegnati . Nello specifico, ogni istanza dell'app può avere solo 100 messaggi in sospeso archiviati sui nostri server per un dispositivo disconnesso. Quando il dispositivo si riconnette, tali messaggi vengono recapitati. Quando i messaggi in sospeso superano il numero massimo consentito, chiamiamo OnDeletedMessages() nel nostro SDK invece di consegnare i messaggi.
`droppedAppForceStopped`	`number` La percentuale di messaggi accettati che sono stati eliminati perché l'applicazione è stata interrotta forzatamente sul dispositivo al momento del recapito e i tentativi non sono riusciti.
`droppedDeviceInactive`	`number` La percentuale di messaggi accettati che sono stati eliminati perché il dispositivo di destinazione è inattivo. FCM eliminerà i messaggi se il dispositivo di destinazione viene ritenuto inattivo dai nostri server. Se un dispositivo si riconnette, chiamiamo OnDeletedMessages() nel nostro SDK invece di consegnare i messaggi.

DeliveryPerformancePercents

Panoramica delle prestazioni di recapito per i messaggi recapitati correttamente. Tutte le percentuali vengono calcolate con countMessagesAccepted come denominatore. Queste categorie non si escludono a vicenda; un messaggio può essere ritardato per molteplici motivi.

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

Campi
`deliveredNoDelay`	`number` La percentuale di messaggi accettati recapitati al dispositivo senza ritardo dal sistema FCM.
`delayedDeviceOffline`	`number` La percentuale di messaggi accettati che sono stati ritardati perché il dispositivo di destinazione non era connesso al momento dell'invio. Questi messaggi sono stati infine recapitati quando il dispositivo si è ricollegato.
`delayedDeviceDoze`	`number` La percentuale di messaggi accettati che sono stati ritardati perché il dispositivo era in modalità sospensione. Solo i messaggi con priorità normale dovrebbero essere ritardati a causa della modalità doze.
`delayedMessageThrottled`	`number` La percentuale di messaggi accettati che hanno subito un ritardo a causa della limitazione dei messaggi, ad esempio la limitazione dei messaggi comprimibili o la limitazione della velocità massima dei messaggi .
`delayedUserStopped`	`number` La percentuale di messaggi accettati che sono stati ritardati perché il profilo utente del dispositivo previsto è stato interrotto sul dispositivo di destinazione al momento dell'invio. I messaggi sono stati infine recapitati quando il profilo utente è stato riavviato.

MessageInsightPercents

Ulteriori informazioni sulla consegna dei messaggi. Tutte le percentuali vengono calcolate con countMessagesAccepted come denominatore.

Rappresentazione JSON
{ "priorityLowered": number }

Campi

Campi
`priorityLowered`	`number` La percentuale di messaggi accettati la cui priorità è stata ridotta da alta a normale. Consulta la documentazione per impostare la priorità dei messaggi .

priorityLowered

number

La percentuale di messaggi accettati la cui priorità è stata ridotta da alta a normale. Consulta la documentazione per impostare la priorità dei messaggi .