Method: projects.androidApps.deliveryData.list

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

string

Requeridos. 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 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

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 a ListAndroidDeliveryDataRequest devem corresponder à chamada que forneceu o token de página.

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

object ( 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

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 um rótulo de análise serão agrupadas em uma única entrada.

data

object ( Data )

Os dados para appId , date e analyticsLabel .

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:

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 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 (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 )

Detalhamento mutuamente exclusivo dos resultados de entrega de mensagens.

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

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

messageInsightPercents

object ( 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

number

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

pending

number

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

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 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

number

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

number

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

number

A porcentagem de mensagens aceitas que foram entregues ao dispositivo sem atraso do 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 acabaram sendo entregues quando o dispositivo foi reconectado.

delayedDeviceDoze

number

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

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 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

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 .