Method: properties.recurringAudienceLists.list

Répertorie toutes les listes d'audience récurrentes d'une propriété. Cette méthode vous permet de trouver et de réutiliser des listes d'audience récurrentes existantes plutôt que de créer de nouvelles listes d'audience récurrentes inutiles. La même audience peut avoir plusieurs listes d'audience récurrentes qui représentent différentes combinaisons de dimensions (par exemple, uniquement la dimension deviceId ou les dimensions deviceId et userId).

Cette méthode a été introduite en version alpha afin de recueillir des commentaires sur la syntaxe et les fonctionnalités avant le passage à la version bêta. Pour nous faire part de vos commentaires sur cette API, remplissez le formulaire Commentaires sur l'API Audience Export Google Analytics.

Requête HTTP

GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Toutes les listes d'audience récurrentes de cette propriété sont listées dans la réponse. Format : properties/{property}

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal de listes d'audience récurrentes à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si ce paramètre n'est pas spécifié, 200 listes d'audience récurrentes au maximum sont renvoyées. La valeur maximale est 1 000 (les valeurs supérieures sont réduites à la valeur maximale).

pageToken

string

Facultatif. Jeton de page reçu d'un appel recurringAudienceLists.list précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à recurringAudienceLists.list doivent correspondre à l'appel ayant fourni le jeton de page.

Corps de la requête

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

Corps de la réponse

Liste de toutes les listes d'audience récurrentes d'une propriété.

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

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

object (RecurringAudienceList)

Chaque liste d'audience récurrente pour une propriété.

nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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