Se usó la API de Cloud Translation para traducir esta página.

Method: projects.androidApps.deliveryData.list

Solicitud HTTP
Parámetros de ruta de acceso
Parámetros de consulta
Cuerpo de la solicitud
Cuerpo de la respuesta
- Representación JSON0
Permisos de autorización
AndroidDeliveryData
- Representación JSON0
Fecha
- Representación JSON0
Datos
- Representación JSON0
MessageResultPercents
- Representación JSON0
DeliveryPerformancePercents
- Representación JSON0
MessageInsightPercents
- Representación JSON0
ProxyNotificationInsightPercents
- Representación JSON0
Pruébalo

Enumera los datos de entrega agregados de la aplicación para Android determinada.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros

Parámetros
`parent`	`string` Obligatorio. La aplicación para la que se enumeran los datos de entrega. Formato: `projects/{projectId}/androidApps/{appId}`

parent

string

Obligatorio. La aplicación para la que se enumeran los datos de entrega. Formato: projects/{projectId}/androidApps/{appId}

Parámetros de consulta

Parámetros

Parámetros
`pageSize`	`integer` La cantidad máxima de entradas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán 1,000 entradas como máximo. El valor máximo es 10,000; los valores superiores a 10,000 se limitarán a 10,000. Esta configuración predeterminada puede cambiar con el tiempo.
`pageToken`	`string` Un token de página, recibido desde una llamada `ListAndroidDeliveryDataRequest` anterior. Proporciona esto para recuperar la página siguiente. Durante la paginación, todos los demás parámetros proporcionados a `ListAndroidDeliveryDataRequest` deben coincidir con la llamada que proporcionó el token de la página.

pageSize

integer

La cantidad máxima de entradas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán 1,000 entradas como máximo. El valor máximo es 10,000; los valores superiores a 10,000 se limitarán a 10,000. Esta configuración predeterminada puede cambiar con el tiempo.

pageToken

string

Un token de página, recibido desde una llamada ListAndroidDeliveryDataRequest anterior. Proporciona esto para recuperar la página siguiente. Durante la paginación, todos los demás parámetros proporcionados a ListAndroidDeliveryDataRequest deben coincidir con la llamada que proporcionó el token de la página.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para deliveryData.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

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

Campos

Campos
`androidDeliveryData[]`	`object (AndroidDeliveryData)` Los datos de entrega de la app proporcionada. Habrá una entrada por combinación de app, fecha y etiqueta de estadísticas.
`nextPageToken`	`string` Un token, que se puede enviar como `pageToken` para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

androidDeliveryData[]

object (AndroidDeliveryData)

Los datos de entrega de la app proporcionada. Habrá una entrada por combinación de app, fecha y etiqueta de estadísticas.

nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

AndroidDeliveryData

Datos de entrega de mensajes para una combinación determinada de fecha, app y etiqueta de estadísticas.

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

Campos
`appId`	`string` El ID de la app a la que se enviaron los mensajes.
`date`	`object (Date)` La fecha que representa esta entrada.
`analyticsLabel`	`string` Es la etiqueta de estadísticas asociada a los mensajes enviados. Todos los mensajes enviados sin una etiqueta de estadísticas se agruparán en una sola entrada.
`data`	`object (Data)` Los datos de `appId`, `date` y `analyticsLabel` especificados.

Fecha

Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otra parte o son insignificantes. La fecha está relacionada con el calendario gregoriano. Esto puede representar una de las siguientes opciones:

Una fecha completa con valores de año, mes y día que no sean cero
Un mes y un día con un año en cero (por ejemplo, un aniversario).
Un año solo, con cero mes y cero día.
Un año y un mes con un día en cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito)

Tipos relacionados:

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

Representación JSON
{ "year": integer, "month": integer, "day": integer }

Campos

Campos
`year`	`integer` Es el año de la fecha. Debe encontrarse entre 1 y 9999, o 0 para especificar una fecha sin año.
`month`	`integer` Mes del año. Debe encontrarse entre 1 y 12, o 0 para especificar un año sin mes ni día.
`day`	`integer` El día de un mes. Debe encontrarse entre 1 y 31 y ser válido para el año y el mes, o bien 0 para especificar un año por sí solo o un año y un mes en los que el día no sea importante.

year

integer

Es el año de la fecha. Debe encontrarse entre 1 y 9999, o 0 para especificar una fecha sin año.

month

integer

Mes del año. Debe encontrarse entre 1 y 12, o 0 para especificar un año sin mes ni día.

day

integer

El día de un mes. Debe encontrarse entre 1 y 31 y ser válido para el año y el mes, o bien 0 para especificar un año por sí solo o un año y un mes en los que el día no sea importante.

Precio de

Datos que detallan la entrega de mensajes

Representación JSON

Representación JSON
{ "countMessagesAccepted": string, "countNotificationsAccepted": string, "messageOutcomePercents": { object (`MessageOutcomePercents`) }, "deliveryPerformancePercents": { object (`DeliveryPerformancePercents`) }, "messageInsightPercents": { object (`MessageInsightPercents`) }, "proxyNotificationInsightPercents": { object (`ProxyNotificationInsightPercents`) } }

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

Campos
`countMessagesAccepted`	`string (int64 format)` Recuento de mensajes aceptados por FCM para dispositivos Android. El dispositivo de destino debe tener habilitada la recopilación de información de uso y diagnóstico.
`countNotificationsAccepted`	`string (int64 format)` Cantidad de notificaciones aceptadas por FCM para dispositivos Android. El dispositivo de destino debe tener habilitada la recopilación de información de uso y diagnóstico.
`messageOutcomePercents`	`object (MessageOutcomePercents)` Desglose mutuamente excluyente de los resultados de entrega de mensajes.
`deliveryPerformancePercents`	`object (DeliveryPerformancePercents)` Información adicional sobre el rendimiento de entrega de los mensajes que se entregaron correctamente.
`messageInsightPercents`	`object (MessageInsightPercents)` Estadísticas generales adicionales sobre la entrega de mensajes.
`proxyNotificationInsightPercents`	`object (ProxyNotificationInsightPercents)` Estadísticas adicionales sobre la entrega de notificaciones de proxy.

MessageResultPercents (en inglés)

Desglose porcentual de los resultados de entrega de mensajes. Estas categorías son mutuamente excluyentes. Todos los porcentajes se calculan con countMessagesAccepted como denominador. Es posible que estas categorías no representen todos los resultados de los mensajes.

Representación JSON
{ "delivered": number, "pending": number, "collapsed": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number, "droppedTtlExpired": number }

Campos
`delivered`	`number` El porcentaje de todos los mensajes aceptados que se enviaron correctamente al dispositivo.
`pending`	`number` El porcentaje de mensajes aceptados ese día que no se descartaron y no se entregaron debido a que el dispositivo se desconectó (al final del día de América/Los_Angeles cuando se envió el mensaje a FCM). Una parte de estos mensajes se entregará al día siguiente, cuando el dispositivo se conecte, pero otros podrían estar destinados a dispositivos que finalmente nunca se reconectan.
`collapsed`	`number` El porcentaje de mensajes aceptados que otro mensaje contrajo.
`droppedTooManyPendingMessages`	`number` El porcentaje de mensajes aceptados que se descartaron debido a demasiados mensajes no contraíbles sin entregar. Específicamente, cada instancia de app solo puede tener 100 mensajes pendientes almacenados en nuestros servidores para un dispositivo que está desconectado. Cuando el dispositivo se vuelva a conectar, esos mensajes se entregarán. Cuando el número supera la cantidad máxima de mensajes pendientes, llamamos a OnDeletedMessages() en nuestro SDK en lugar de entregarlos.
`droppedAppForceStopped`	`number` El porcentaje de mensajes aceptados que se descartaron debido a que se forzó la detención de la aplicación en el dispositivo en el momento de la entrega y los reintentos no tuvieron éxito.
`droppedDeviceInactive`	`number` El porcentaje de mensajes aceptados que se descartaron porque el dispositivo de destino está inactivo. FCM descartará los mensajes si nuestros servidores consideran que el dispositivo de destino está inactivo. Si un dispositivo se vuelve a conectar, llamamos a OnDeletedMessages() en nuestro SDK en lugar de entregar los mensajes.
`droppedTtlExpired`	`number` El porcentaje de mensajes aceptados que vencieron porque el tiempo de actividad (TTL) transcurrió antes de que el dispositivo de destino se volviera a conectar.

Porcentajesderendimientodeentrega

Descripción general del rendimiento de entrega de los mensajes que se enviaron correctamente. Todos los porcentajes se calculan con countMessagesAccepted como denominador. Estas categorías no se excluyen mutuamente; un mensaje puede retrasarse por varios motivos.

Representación JSON
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number }

Campos
`deliveredNoDelay`	`number` El porcentaje de mensajes aceptados que se entregaron al dispositivo sin demora desde el sistema FCM.
`delayedDeviceOffline`	`number` El porcentaje de mensajes aceptados que se retrasaron porque el dispositivo de destino no estaba conectado en el momento del envío. Estos mensajes se entregaron cuando el dispositivo volvió a conectarse.
`delayedDeviceDoze`	`number` Porcentaje de mensajes aceptados que se retrasaron debido a que el dispositivo estaba en modo de descanso. Solo se deben retrasar los mensajes con prioridad normal debido al modo Descanso.
`delayedMessageThrottled`	`number` Es el porcentaje de mensajes aceptados que se retrasaron debido a la limitación de mensajes, como la regulación de mensajes contraíbles o la regulación de la frecuencia máxima de mensajes.
`delayedUserStopped`	`number` El porcentaje de mensajes aceptados que se retrasaron porque el perfil de usuario del dispositivo previsto se detuvo en el dispositivo de destino al momento del envío. Los mensajes se entregaron finalmente cuando se volvió a iniciar el perfil de usuario.

MessageInsightPercents

Información adicional sobre la entrega de mensajes. Todos los porcentajes se calculan con countMessagesAccepted como denominador.

Representación JSON
{ "priorityLowered": number }

Campos

Campos
`priorityLowered`	`number` El porcentaje de mensajes aceptados cuya prioridad se bajó de alta a normal. Consulta la documentación para configurar la prioridad de los mensajes.

priorityLowered

number

El porcentaje de mensajes aceptados cuya prioridad se bajó de alta a normal. Consulta la documentación para configurar la prioridad de los mensajes.

Porcentajes de notificaciones de proxy

Información adicional sobre la entrega de notificaciones de proxy. Todos los porcentajes se calculan con countNotificationsAccepted como denominador.

Representación JSON
{ "proxied": number, "failed": number, "skippedUnsupported": number, "skippedNotThrottled": number, "skippedUnconfigured": number, "skippedOptedOut": number }

Campos
`proxied`	`number` El porcentaje de notificaciones aceptadas que se enviaron correctamente a través de los Servicios de Google Play.
`failed`	`number` El porcentaje de notificaciones aceptadas que no se pudieron enviar mediante proxy. Por lo general, esto se debe a excepciones que ocurrieron cuando se llamaba a notifyAsPackage.
`skippedUnsupported`	`number` El porcentaje de notificaciones aceptadas que se omitieron porque el destinatario no admite la notificación de proxy.
`skippedNotThrottled`	`number` El porcentaje de notificaciones aceptadas que se omitieron porque los mensajes no se regularon.
`skippedUnconfigured`	`number` El porcentaje de notificaciones aceptadas que se omitieron porque faltaban parámetros de configuración necesarios para que las notificaciones se enviaran mediante proxy.
`skippedOptedOut`	`number` El porcentaje de notificaciones aceptadas que se omitieron porque la app no permitió que estos mensajes se enviaran a través del proxy.