Method: projects.androidApps.deliveryData.list

Lista dados de entrega agregados do aplicativo Android especificado.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O aplicativo para o qual listar dados de entrega. Formato: projects/{projectId}/androidApps/{appId}

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de entradas a serem retornadas. O serviço pode retornar menos que esse valor. Se não for especificado, serão retornadas no máximo 1.000 entradas. 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

string

Um token de página recebido de uma chamada ListAndroidDeliveryDataRequest anterior. Forneça isso para recuperar a página subsequente. Ao paginar, todos os outros parâmetros fornecidos para ListAndroidDeliveryDataRequest precisam corresponder à chamada que forneceu o token da página.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para deliveryData.list.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
Campos
androidDeliveryData[]

object (AndroidDeliveryData)

Os dados de entrega do app fornecido. Haverá uma entrada por combinação de app, data e rótulo de análise.
nextPageToken

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

AndroidDeliveryData.

Dados de entrega de mensagens para determinada combinação de data, app e rótulo de análise.

Representação JSON 
{
  "appId": string,
  "date": {
    object (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
Campos
appId

string

O ID do app para o qual as mensagens foram enviadas.
date

object (Date)

A data representada por esta entrada.
analyticsLabel

string

O marcador de análise associado às mensagens enviadas. Todas as mensagens enviadas sem um marcador de análise serão agrupadas em uma única entrada.
data

object (Data)

Os dados para appId, date e analyticsLabel especificados.

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 é referente ao calendário gregoriano. Isso pode representar uma das seguintes opções:

  • Uma data completa, com valores de ano, mês e dia diferentes de zero.
  • um mês e dia, com ano zero (por exemplo, uma data comemorativa);
  • Um ano sozinho, 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 de cartão de crédito).

Tipos relacionados:

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.
month

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.
day

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.

Dados

Dados detalhados da entrega de mensagens

Representação JSON 
{
  "countMessagesAccepted": string,
  "countNotificationsAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  },
  "proxyNotificationInsightPercents": {
    object (ProxyNotificationInsightPercents)
  }
}
Campos
countMessagesAccepted

string (int64 format)

Contagem de mensagens aceitas pelo FCM destinadas a dispositivos Android. O dispositivo de destino precisa ter ativado a coleta de informações de uso e diagnósticos.
countNotificationsAccepted

string (int64 format)

Contagem de notificações aceitas pelo FCM destinadas a dispositivos Android. O dispositivo de destino precisa ter ativado a coleta de informações de uso e diagnósticos.
messageOutcomePercents

object (MessageOutcomePercents)

Detalhamento mutuamente exclusivo dos resultados de entrega de mensagens.
deliveryPerformancePercents

object (DeliveryPerformancePercents)

Informações adicionais sobre o desempenho da entrega de mensagens entregues.
messageInsightPercents

object (MessageInsightPercents)

Outros insights gerais sobre a entrega de mensagens.
proxyNotificationInsightPercents

object (ProxyNotificationInsightPercents)

Mais insights sobre a entrega de notificações de proxy.

MessageOutcomePercents

Detalhamento percentual dos resultados de entrega de mensagens. Essas categorias são mutuamente exclusivas. Todas as porcentagens são calculadas com countMessagesAccepted como o denominador. Talvez essas categorias não contabilizam todos os resultados de mensagens.

Representação JSON 
{
  "delivered": number,
  "pending": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number
}
Campos
delivered

number

A porcentagem de todas as mensagens aceitas que foram entregues ao dispositivo.
pending

number

A porcentagem de mensagens aceitas nesse dia que não foram descartadas nem entregues devido à desconexão do dispositivo (a partir do 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 podem estar destinadas a dispositivos que nunca se reconectam.
droppedTooManyPendingMessages

number

É a porcentagem de mensagens aceitas que foram descartadas devido a um número excessivo de mensagens não recolhíveis não entregues. Especificamente, cada instância do app só pode ter 100 mensagens pendentes armazenadas nos nossos servidores para um dispositivo desconectado. Quando o dispositivo for reconectado, as mensagens serão entregues. Quando há mais do que o máximo de mensagens pendentes, chamamos OndeletedMessages() no nosso SDK em vez de entregar as mensagens.
droppedAppForceStopped

number

A porcentagem de mensagens aceitas que foram descartadas porque o aplicativo foi interrompido no dispositivo à força no momento da entrega e as tentativas falharam.
droppedDeviceInactive

number

A porcentagem de mensagens aceitas que foram descartadas porque o dispositivo de destino está inativo. O FCM descartará as mensagens se o dispositivo de destino for considerado inativo pelos nossos servidores. Se um dispositivo se reconectar, chamamos OndeletedMessages() no nosso SDK em vez de entregar as mensagens.

Porcentagem de desempenho de entrega

Visão geral do desempenho de entrega de mensagens entregues. Todas as porcentagens são calculadas com countMessagesAccepted como o denominador. Essas categorias não são mutuamente exclusivas; uma mensagem pode atrasar por vários motivos.

Representação JSON 
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
Campos
deliveredNoDelay

number

A porcentagem de mensagens aceitas que foram entregues ao dispositivo sem atraso pelo sistema do FCM.
delayedDeviceOffline

number

A porcentagem de mensagens aceitas que foram atrasadas porque o dispositivo de destino não estava conectado no momento do envio. Essas mensagens foram entregues quando o dispositivo foi reconectado.
delayedDeviceDoze

number

A porcentagem de mensagens aceitas que foram atrasadas porque o dispositivo estava no modo Soneca. Somente mensagens de prioridade normal devem ser adiadas devido ao modo Soneca.
delayedMessageThrottled

number

A porcentagem de mensagens aceitas que foram atrasadas devido à limitação de mensagens, como limitação de mensagens recolhíveis ou limitação máxima da taxa de mensagens.
delayedUserStopped

number

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 foram entregues quando o perfil do usuário foi iniciado novamente.

MessageInsightPercents

Mais informações sobre a entrega de mensagens. Todas as porcentagens são calculadas com countMessagesAccepted como o denominador.

Representação JSON 
{
  "priorityLowered": number
}
Campos
priorityLowered

number

A porcentagem de mensagens aceitas que tiveram a prioridade reduzida de alta para normal. Consulte a documentação para definir a prioridade da mensagem.

ProxyNotificationInsightPercents

Mais informações sobre a entrega de notificações de proxy. Todas as porcentagens são calculadas com countNotificationsAccepted como o denominador.

Representação JSON 
{
  "proxied": number,
  "failed": number,
  "skippedUnsupported": number,
  "skippedNotThrottled": number,
  "skippedUnconfigured": number,
  "skippedOptedOut": number
}
Campos
proxied

number

É a porcentagem de notificações aceitas que foram encaminhadas por proxy pelo Google Play Services.
failed

number

A porcentagem de notificações aceitas que não passaram por proxy. Isso geralmente é causado por exceções que ocorreram ao chamar notifyAsPackage.
skippedUnsupported

number

A porcentagem de notificações aceitas que foram ignoradas porque o destinatário não oferece suporte às notificações proxy.
skippedNotThrottled

number

A porcentagem de notificações aceitas que foram ignoradas porque as mensagens não foram limitadas.
skippedUnconfigured

number

A porcentagem de notificações aceitas que foram ignoradas porque as configurações necessárias para o envio de notificações por proxy estavam ausentes.
skippedOptedOut

number

A porcentagem de notificações aceitas que foram ignoradas porque o app não permitiu o encaminhamento dessas mensagens por proxy.