Method: domains.trafficStats.list

Lister les statistiques de trafic pour tous les jours disponibles Renvoie PERMISSION_DENIED si l'utilisateur n'est pas autorisé à accéder à TrafficStats pour le domaine.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Nom de ressource du domaine dont nous souhaitons répertorier les statistiques de trafic. Il doit se présenter sous la forme domains/{domain_name}, où domain_name correspond au nom de domaine complet.

Paramètres de requête

Paramètres
startDate

object (Date)

Premier jour des métriques à récupérer inclusives. Les champs startDate et endDate doivent tous les deux être spécifiés, ou ne sont pas spécifiés. Si une seule valeur est spécifiée ou si la date de fin est antérieure à la date de début (startDate), INVALID_ARGUMENT est renvoyé.
endDate

object (Date)

Jour le plus récent des métriques à récupérer exclusives. Les champs startDate et endDate doivent tous les deux être spécifiés, ou ne sont pas spécifiés. Si une seule valeur est spécifiée ou si la date de fin est antérieure à la date de début (startDate), INVALID_ARGUMENT est renvoyé.
pageSize

integer

Taille de la page demandée. Le serveur peut renvoyer moins de TrafficStats que demandé. Si aucune valeur n'est spécifiée, le serveur choisit une valeur par défaut appropriée.
pageToken

string

La valeur nextPageToken affichée par une requête "List" antérieure, le cas échéant. Il s'agit de la valeur de ListTrafficStatsResponse.next_page_token renvoyée par l'appel précédent à la méthode trafficStats.list.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour trafficStats.list.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
Champs
trafficStats[]

object (TrafficStats)

Liste des statistiques TrafficStats.
nextPageToken

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez le Guide relatif aux autorisations.

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est donnée selon le calendrier grégorien. Il peut s'agir de l'un des éléments suivants:

  • Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
  • Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
  • une année seule, avec un mois et un jour zéro.
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés:

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Doit être comprise entre 1 et 9999, ou 0 pour indiquer une date sans année.
month

integer

Mois de l'année. La valeur doit être comprise entre 1 et 12, ou égale à 0 pour spécifier une année sans mois ni jour.
day

integer

Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif.