- solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo de resposta
- Escopos de autorização
- AndroidDeliveryData
- Encontro: Data
- Dados
- MessageOutcomePercents
- Porcentagens de Desempenho de Entrega
- MessageInsightPercents
- Tente!
Liste os dados de entrega agregados para o aplicativo Android fornecido.
solicitação HTTP
GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData
A URL usa a sintaxe de transcodificação gRPC .
Parâmetros de caminho
Parâmetros | |
---|---|
parent | Requeridos. O aplicativo para o qual listar os dados de entrega. Formato: |
Parâmetros de consulta
Parâmetros | |
---|---|
pageSize | O número máximo de entradas a serem retornadas. O serviço pode retornar menos que esse valor. Se não especificado, no máximo 1.000 entradas serão retornadas. O valor máximo é 10.000; valores acima de 10.000 serão limitados a 10.000. Esse padrão pode mudar com o tempo. |
pageToken | Um token de página, recebido de uma chamada |
Corpo da solicitação
O corpo da solicitação deve estar vazio.
Corpo de resposta
Se for bem-sucedido, o corpo da resposta conterá dados com a seguinte estrutura:
Mensagem de resposta para deliveryData.list.
Representação JSON |
---|
{
"androidDeliveryData": [
{
object ( |
Campos | |
---|---|
androidDeliveryData[] | Os dados de entrega para o aplicativo fornecido. Haverá uma entrada por combinação de aplicativo, data e rótulo de análise. |
nextPageToken | Um token, que pode ser enviado como |
Escopos de autorização
Requer o seguinte escopo OAuth:
-
https://www.googleapis.com/auth/cloud-platform
AndroidDeliveryData
Dados de entrega de mensagens para uma determinada combinação de data, aplicativo e rótulo de análise.
Representação JSON |
---|
{ "appId": string, "date": { object ( |
Campos | |
---|---|
appId | O ID do aplicativo para o qual as mensagens foram enviadas. |
date | A data representada por esta entrada. |
analyticsLabel | O rótulo de análise associado às mensagens enviadas. Todas as mensagens enviadas sem um rótulo de análise serão agrupadas em uma única entrada. |
data | Os dados para |
Encontro: Data
Representa uma data inteira ou parcial do calendário, como um aniversário. A hora do dia e o fuso horário são especificados em outro lugar ou são insignificantes. A data é relativa ao calendário gregoriano. Isso pode representar um dos seguintes:
- Uma data completa, com valores de ano, mês e dia diferentes de zero.
- Um mês e dia, com um ano zero (por exemplo, um aniversário).
- Um ano por conta própria, com um mês zero e um dia zero.
- Um ano e um mês, com um dia zero (por exemplo, uma data de validade do cartão de crédito).
Tipos relacionados:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
Representação JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campos | |
---|---|
year | Ano da data. Deve ser de 1 a 9999 ou 0 para especificar uma data sem ano. |
month | Mês de um ano. Deve ser de 1 a 12 ou 0 para especificar um ano sem mês e dia. |
day | Dia de um mês. Deve ser de 1 a 31 e válido para o ano e mês, ou 0 para especificar um ano por si só ou um ano e mês em que o dia não seja significativo. |
Dados
Dados que detalham a entrega de mensagens
Representação JSON |
---|
{ "countMessagesAccepted": string, "messageOutcomePercents": { object ( |
Campos | |
---|---|
countMessagesAccepted | Contagem de mensagens aceitas pelo FCM destinadas a dispositivos Android. O dispositivo de destino deve ter optado pela coleta de informações de uso e diagnóstico. |
messageOutcomePercents | Detalhamento mutuamente exclusivo dos resultados de entrega de mensagens. |
deliveryPerformancePercents | Informações adicionais sobre o desempenho de entrega de mensagens que foram entregues com sucesso. |
messageInsightPercents | Informações gerais adicionais sobre a entrega de mensagens. |
MessageOutcomePercents
Detalhamento percentual dos resultados de entrega de mensagens. Essas categorias são mutuamente exclusivas. Todas as porcentagens são calculadas com countMessagesAccepted
como denominador. Essas categorias podem não levar em conta todos os resultados da mensagem.
Representação JSON |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
Campos | |
---|---|
delivered | A porcentagem de todas as mensagens aceitas que foram entregues com sucesso ao dispositivo. |
pending | A porcentagem de mensagens aceitas neste dia que não foram descartadas e não entregues, devido ao dispositivo ter sido desconectado (no final do dia América/Los_Angeles quando a mensagem foi enviada ao FCM). Uma parte dessas mensagens será entregue no dia seguinte, quando o dispositivo se conectar, mas outras poderão ser destinadas a dispositivos que nunca se reconectarão. |
droppedTooManyPendingMessages | A porcentagem de mensagens aceitas que foram descartadas devido a muitas mensagens não recolhíveis não entregues . Especificamente, cada instância de aplicativo pode ter apenas 100 mensagens pendentes armazenadas em nossos servidores para um dispositivo desconectado. Quando esse dispositivo se reconecta, essas mensagens são entregues. Quando há mais do que o máximo de mensagens pendentes, chamamos OnDeletedMessages() em nosso SDK em vez de entregar as mensagens. |
droppedAppForceStopped | A porcentagem de mensagens aceitas que foram descartadas porque o aplicativo foi interrompido à força no dispositivo no momento da entrega e as tentativas não foram bem-sucedidas. |
droppedDeviceInactive | A porcentagem de mensagens aceitas que foram descartadas porque o dispositivo de destino está inativo. O FCM descartará mensagens se o dispositivo de destino for considerado inativo por nossos servidores. Se um dispositivo se reconectar, chamamos OnDeletedMessages() em nosso SDK em vez de entregar as mensagens. |
Porcentagens de Desempenho de Entrega
Visão geral do desempenho de entrega de mensagens que foram entregues com sucesso. Todas as porcentagens são calculadas com countMessagesAccepted
como denominador. Essas categorias não são mutuamente exclusivas; uma mensagem pode ser atrasada por vários motivos.
Representação JSON |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
Campos | |
---|---|
deliveredNoDelay | A porcentagem de mensagens aceitas que foram entregues ao dispositivo sem atraso do sistema FCM. |
delayedDeviceOffline | A porcentagem de mensagens aceitas que foram atrasadas porque o dispositivo de destino não estava conectado no momento do envio. Essas mensagens acabaram sendo entregues quando o dispositivo foi reconectado. |
delayedDeviceDoze | A porcentagem de mensagens aceitas que foram atrasadas porque o dispositivo estava no modo de descanso. Somente mensagens de prioridade normal devem ser atrasadas devido ao modo de descanso. |
delayedMessageThrottled | A porcentagem de mensagens aceitas que foram atrasadas devido à limitação de mensagens, como limitação de mensagens recolhíveis ou limitação de taxa máxima de mensagens . |
delayedUserStopped | A porcentagem de mensagens aceitas que foram atrasadas porque o perfil de usuário do dispositivo pretendido foi interrompido no dispositivo de destino no momento do envio. As mensagens acabaram sendo entregues quando o perfil do usuário foi reiniciado. |
MessageInsightPercents
Informações adicionais sobre a entrega de mensagens. Todas as porcentagens são calculadas com countMessagesAccepted
como denominador.
Representação JSON |
---|
{ "priorityLowered": number } |
Campos | |
---|---|
priorityLowered | A porcentagem de mensagens aceitas que tiveram sua prioridade reduzida de alta para normal. Consulte a documentação para definir a prioridade da mensagem . |