Method: domains.trafficStats.list

Liste as estatísticas de tráfego para todos os dias disponíveis. Retorna PERMISSION_DENIED se o usuário não tiver permissão para acessar TrafficStats no domínio.

Solicitação HTTP

GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats

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

Parâmetros de caminho

Parâmetros
parent

string

O nome do recurso do domínio cujas estatísticas de tráfego queremos listar. Ele precisa estar no formato domains/{domain_name}, em que "domain_name" é o nome de domínio totalmente qualificado.

Parâmetros de consulta

Parâmetros
startDate

object (Date)

O primeiro dia das métricas a serem recuperadas. Os valores startDate e endDate precisam ser especificados ou ambos não são especificados. Se apenas um for especificado, ou endDate for anterior a startDate, INVALID_ ARGUMENT será retornado.
endDate

object (Date)

O dia mais recente das métricas a serem recuperadas exclusivas. startDate e endDate devem ser especificadas ou ambas não foram especificadas. Se apenas um for especificado, ou endDate for anterior a startDate, INVALID_ ARGUMENT será retornado.
pageSize

integer

Tamanho da página solicitada. O servidor pode retornar menos TrafficStats do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.
pageToken

string

O valor nextPageToken retornado de uma solicitação de lista anterior, se houver. Esse é o valor de ListTrafficStatsResponse.next_page_token retornado pela chamada anterior para o método trafficStats.list.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para trafficStats.list.

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

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

object (TrafficStats)

A lista de TrafficStats.
nextPageToken

string

Token para recuperar a próxima página de resultados ou vazia se não houver mais resultados na lista.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/postmaster.readonly

Para mais informações, consulte o Guia de autorização.

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 um dia, com ano zero (por exemplo, uma data comemorativa).
  • Um ano sozinho, com mês zero e 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. Precisa ser de 1 a 9999 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.