Method: properties.audienceExports.list

Répertorie toutes les exportations d'audiences pour une propriété. Cette méthode vous permet de rechercher et de réutiliser des exportations d'audiences existantes au lieu de créer des exportations d'audiences inutiles. La même audience peut avoir plusieurs exportations d'audiences représentant l'exportation des utilisateurs qui figuraient dans une audience à différents jours.

Consultez l'article Créer une exportation d'audience pour obtenir une présentation des exportations d'audiences avec des exemples.

Les API d'exportation d'audience disposent de certaines méthodes en version alpha, et d'autres en version bêta. L'objectif est de faire progresser les méthodes vers la stabilité bêta après avoir reçu des commentaires et adoptées. Pour nous faire part de vos commentaires sur cette API, remplissez le formulaire Google Analytics Audience Export API Feedback.

Requête HTTP

GET https://analyticsdata.googleapis.com/v1beta/{parent=properties/*}/audienceExports

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Toutes les exportations d'audiences pour cette propriété seront listées dans la réponse. Format : properties/{property}

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal d'exportations d'audiences à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 200 exportations d'audiences au maximum seront renvoyées. La valeur maximale est 1 000 (les valeurs plus élevées sont forcées à la valeur maximale).

pageToken

string

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

Lors de la pagination, tous les autres paramètres fournis à audienceExports.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 exportations d'audiences pour 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
{
  "audienceExports": [
    {
      object (AudienceExport)
    }
  ],
  "nextPageToken": string
}
Champs
audienceExports[]

object (AudienceExport)

Chaque audience est exportée 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