Method: projects.androidApps.deliveryData.list

Liste os dados de entrega agregados para o aplicativo Android específico.

Solicitação HTTP

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

A URL usa sintaxe de transcodificação gRPC .

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O aplicativo para o qual listar os dados de entrega. Formato: projects/{project_id}/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. Este 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 devem corresponder à chamada que forneceu o token da página.

Solicitar corpo

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 (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
Campos
androidDeliveryData[]

object ( AndroidDeliveryData )

Os dados de entrega do aplicativo fornecido. Haverá uma entrada por combinação de aplicativo, 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 este 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 uma determinada combinação de data, aplicativo 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 aplicativo para o qual as mensagens foram enviadas.

date

object ( Date )

A data representada por esta entrada.

analyticsLabel

string

O rótulo de análise associado às mensagens enviadas. Todas as mensagens enviadas sem rótulo analítico serão agrupadas em uma única entrada.

data

object ( Data )

Os dados para appId , date e analyticsLabel especificados.

Data

Representa uma data de calendário total ou parcial, 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 um dia, com ano zero (por exemplo, um aniversário).
  • Um ano sozinho, com mês zero e dia zero.
  • Um ano e um mês, com dia zero (por exemplo, data de validade do cartão de crédito).

Tipos relacionados:

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

integer

Ano da data. Deve ser de 1 a 9999 ou 0 para especificar uma data sem ano.

month

integer

Mês de um ano. Deve ser de 1 a 12 ou 0 para especificar um ano sem mês e dia.

day

integer

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 sozinho ou um ano e mês onde o dia não é significativo.

Dados

Dados detalhando a entrega de mensagens

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

string ( int64 format)

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

object ( MessageOutcomePercents )

Análise mutuamente exclusiva dos resultados da entrega de mensagens.

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

Informações adicionais sobre o desempenho de entrega de mensagens que foram entregues com êxito.

messageInsightPercents

object ( MessageInsightPercents )

Informações gerais adicionais sobre 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. Estas categorias podem não contabilizar todos os resultados da mensagem.

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 com êxito ao dispositivo.

pending

number

A porcentagem de mensagens aceitas neste dia que não foram descartadas e não entregues devido à desconexão do dispositivo (a partir do final do dia América/Los_Angeles em que 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

number

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 só pode ter 100 mensagens pendentes armazenadas em nossos servidores para um dispositivo desconectado. Quando esse dispositivo se reconectar, essas mensagens serão entregues. Quando há mais mensagens pendentes do que o máximo, chamamos OnDeletedMessages() em nosso SDK em vez de entregar as mensagens.

droppedAppForceStopped

number

A porcentagem de mensagens aceitas que foram descartadas porque o aplicativo foi interrompido à força no dispositivo no momento da entrega e as novas tentativas não tiveram êxito.

droppedDeviceInactive

number

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

Percentagens de desempenho de entrega

Visão geral do desempenho de entrega de mensagens que foram entregues com êxito. Todas as porcentagens são calculadas com countMessagesAccepted como denominador. Estas 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

number

A porcentagem de mensagens aceitas que foram entregues ao dispositivo sem demora pelo sistema 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 finalmente entregues quando o dispositivo foi reconectado.

delayedDeviceDoze

number

A porcentagem de mensagens aceitas que foram atrasadas porque o dispositivo estava no modo soneca. Apenas mensagens de prioridade normal devem ser atrasadas 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 de taxa máxima 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 finalmente entregues quando o perfil do usuário foi reiniciado.

Percentagens do MessageInsight

Informações adicionais sobre entrega de mensagens. Todas as porcentagens são calculadas com countMessagesAccepted como denominador.

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

number

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