- Solicitud HTTP
- Parámetros de ruta
- Parámetros de consulta
- cuerpo de la solicitud
- Cuerpo de respuesta
- Ámbitos de autorización
- AndroidDeliveryData
- Fecha
- Datos
- MensajeResultadoPorcentajes
- EntregaRendimientoPorcentajes
- MensajeInsightPercents
- ¡Intentalo!
Enumere los datos de entrega agregados para la aplicación de Android dada.
Solicitud HTTP
GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData
La URL usa la sintaxis de transcodificación de gRPC .
Parámetros de ruta
Parámetros | |
---|---|
parent | Requerido. La aplicación para la que se enumeran los datos de entrega. Formato: |
Parámetros de consulta
Parámetros | |
---|---|
pageSize | El número máximo de entradas a devolver. El servicio puede devolver menos de este valor. Si no se especifica, se devolverán como máximo 1000 entradas. El valor máximo es 10.000; los valores por encima de 10.000 se limitarán a 10.000. Este valor predeterminado puede cambiar con el tiempo. |
pageToken | Un token de página, recibido de una llamada |
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 ( |
Campos | |
---|---|
androidDeliveryData[] | Los datos de entrega para la aplicación proporcionada. Habrá una entrada por combinación de aplicación, fecha y etiqueta de análisis. |
nextPageToken | Un token, que se puede enviar como |
Ámbitos 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, aplicación y etiqueta de análisis.
Representación JSON |
---|
{ "appId": string, "date": { object ( |
Campos | |
---|---|
appId | El ID de la aplicación a la que se enviaron los mensajes. |
date | La fecha representada por esta entrada. |
analyticsLabel | 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 sola entrada. |
data | Los datos para el |
Fecha
Representa una fecha de calendario total 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 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 un año cero (por ejemplo, un aniversario).
- Un año por sí solo, 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:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
Representación JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campos | |
---|---|
year | Año de la fecha. Debe ser de 1 a 9999, o 0 para especificar una fecha sin año. |
month | Mes de un año. Debe ser de 1 a 12, o 0 para especificar un año sin mes ni día. |
day | 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 un mes donde el día no es significativo. |
Datos
Datos que detallan la entrega de mensajes
Representación JSON |
---|
{ "countMessagesAccepted": string, "messageOutcomePercents": { object ( |
Campos | |
---|---|
countMessagesAccepted | Recuento de mensajes aceptados por FCM destinados a dispositivos Android. El dispositivo de destino debe haber optado por la recopilación de información de uso y diagnóstico. |
messageOutcomePercents | Desglose mutuamente excluyente de los resultados de entrega de mensajes. |
deliveryPerformancePercents | Información adicional sobre el rendimiento de la entrega de mensajes que se entregaron correctamente. |
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 tengan en cuenta todos los resultados de los mensajes.
Representación JSON |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
Campos | |
---|---|
delivered | El porcentaje de todos los mensajes aceptados que se entregaron correctamente al dispositivo. |
pending | El porcentaje de mensajes aceptados en este día que no se descartaron ni se entregaron debido a que el dispositivo se desconectó (al final del día de América/Los_Ángeles en que se envió el mensaje 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 vuelven a conectar. |
droppedTooManyPendingMessages | El porcentaje de mensajes aceptados que se descartaron debido a demasiados mensajes no plegables no entregados . Específicamente, cada instancia de la 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 | El porcentaje de mensajes aceptados que se descartaron porque la aplicación se detuvo a la fuerza en el dispositivo en el momento de la entrega y los reintentos no tuvieron éxito. |
droppedDeviceInactive | 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. |
EntregaRendimientoPorcentajes
Descripción general del rendimiento de entrega de los 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 razones.
Representación JSON |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
Campos | |
---|---|
deliveredNoDelay | El porcentaje de mensajes aceptados que se entregaron al dispositivo sin demora desde el sistema FCM. |
delayedDeviceOffline | 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 enviaron cuando el dispositivo se volvió a conectar. |
delayedDeviceDoze | El porcentaje de mensajes aceptados que se retrasaron porque el dispositivo estaba en modo inactivo. Solo los mensajes de prioridad normal deben retrasarse debido al modo de reposo. |
delayedMessageThrottled | 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 velocidad máxima de mensajes . |
delayedUserStopped | 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ó de nuevo el perfil de usuario. |
MensajeInsightPercents
Información adicional sobre la entrega de mensajes. Todos los porcentajes se calculan con countMessagesAccepted
como denominador.
Representación JSON |
---|
{ "priorityLowered": number } |
Campos | |
---|---|
priorityLowered | El porcentaje de mensajes aceptados cuya prioridad se redujo de alta a normal. Consulte la documentación para configurar la prioridad de los mensajes . |