Method: projects.androidApps.deliveryData.list

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

solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación gRPC .

Parámetros de ruta

Parámetros
parent

string

Requerido. La aplicación para la cual enumerar los datos de entrega. Formato: projects/{project_id}/androidApps/{appId}

Parámetros de consulta

Parámetros
pageSize

integer

El número máximo de entradas a devolver. El servicio puede devolver menos que este valor. Si no se especifica, se devolverán como máximo 1000 entradas. El valor máximo es 10.000; los valores superiores a 10.000 tendrán un límite de 10.000. Este valor predeterminado puede cambiar con el tiempo.

pageToken

string

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

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de respuesta

Si tiene éxito, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Mensaje de respuesta para deliveryData.list.

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

object ( AndroidDeliveryData )

Los datos de entrega de la aplicación proporcionada. Habrá una entrada por combinación de aplicación, fecha y etiqueta de análisis.

nextPageToken

string

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

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Datos de entrega de Android

Datos de entrega de mensajes para una combinación determinada de fecha, aplicación y etiqueta de análisis.

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

string

El ID de la aplicación a la que se enviaron los mensajes.

date

object ( Date )

La fecha representada por esta entrada.

analyticsLabel

string

La etiqueta de análisis asociada con los mensajes enviados. Todos los mensajes enviados sin una etiqueta de análisis se agruparán en una única entrada.

data

object ( Data )

Los datos para el appId , date y analyticsLabel especificados.

Fecha

Representa una fecha del calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se indican en otra parte o son insignificantes. La fecha es relativa al Calendario Gregoriano. Esto puede representar uno de los siguientes:

  • Una fecha completa, con valores de año, mes y día distintos de cero.
  • Un mes y un día, con año cero (por ejemplo, un aniversario).
  • Un año en sí, con un mes cero y un día cero.
  • 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 de 1 a 9999, o 0 para especificar una fecha sin año.

month

integer

Mes de un año. Debe ser de 1 a 12, o 0 para especificar un año sin mes ni día.

day

integer

Día de un mes. Debe ser del 1 al 31 y válido para el año y el mes, o 0 para especificar un año por sí solo o un año y mes donde el día no es significativo.

Datos

Datos que detallan la entrega de mensajes.

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

string ( int64 format)

Recuento de mensajes aceptados por FCM destinados a dispositivos Android. El dispositivo objetivo debe haber optado por la recopilación de información de uso y diagnóstico.

messageOutcomePercents

object ( MessageOutcomePercents )

Desglose mutuamente excluyente de los resultados de la entrega de mensajes.

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

Información adicional sobre el rendimiento de entrega de mensajes que se entregaron correctamente.

messageInsightPercents

object ( MessageInsightPercents )

Información general adicional sobre la entrega de mensajes.

MensajeResultadoPorcentajes

Desglose porcentual de los resultados de la 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,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number
}
Campos
delivered

number

El porcentaje de todos los mensajes aceptados que se entregaron correctamente al dispositivo.

pending

number

El porcentaje de mensajes aceptados en este día que no se descartaron ni se entregaron debido a que el dispositivo se desconectó (a partir del final del día de América/Los Ángeles cuando el mensaje se envió a FCM). Una parte de estos mensajes se entregará al día siguiente cuando el dispositivo se conecte, pero otros pueden estar destinados a dispositivos que finalmente nunca se volverán a conectar.

droppedTooManyPendingMessages

number

El porcentaje de mensajes aceptados que se descartaron debido a que no se entregaron demasiados mensajes no plegables . Específicamente, cada instancia de aplicación solo puede tener 100 mensajes pendientes almacenados en nuestros servidores para un dispositivo que esté desconectado. Cuando ese dispositivo se vuelve a conectar, esos mensajes se entregan. Cuando hay más mensajes pendientes que el máximo, llamamos a OnDeletedMessages() en nuestro SDK en lugar de entregar los mensajes.

droppedAppForceStopped

number

El porcentaje de mensajes aceptados que se descartaron porque la aplicación se detuvo por la fuerza 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 eliminará 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.

Porcentajes de rendimiento de entrega

Descripción general del rendimiento de entrega de mensajes que se entregaron correctamente. Todos los porcentajes se calculan con countMessagesAccepted como denominador. Estas categorías no son mutuamente excluyentes; un mensaje puede retrasarse por múltiples 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 finalmente se entregaron cuando el dispositivo se volvió a conectar.

delayedDeviceDoze

number

El porcentaje de mensajes aceptados que se retrasaron porque el dispositivo estaba en modo inactivo. Sólo los mensajes de prioridad normal deben retrasarse debido al modo de reposo.

delayedMessageThrottled

number

El porcentaje de mensajes aceptados que se retrasaron debido a la limitación de mensajes, como la limitación de mensajes contraíbles o la limitación de la velocidad 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 en el momento del envío. Los mensajes finalmente se entregaron cuando se inició nuevamente el perfil de usuario.

MensajeInsightPorcentajes

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 redujo de alta a normal. Consulte la documentación para configurar la prioridad de los mensajes .