Method: projects.androidApps.deliveryData.list

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
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
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
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 otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:

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

Tipos relacionados:

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

integer

Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año.
month

integer

Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día.
day

integer

Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo.

Datos

Datos que detallan la entrega de mensajes

Representación JSON 
{
  "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 son mutuamente excluyentes. un mensaje puede retrasarse por varias razones.

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
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.