Method: properties.audienceLists.create

Crée une liste d'audience pour une récupération ultérieure. Cette méthode renvoie rapidement le nom de ressource de la liste d'audience et lance une requête asynchrone de longue durée pour créer une liste d'audience. Pour répertorier les utilisateurs dans une liste d'audience, commencez par la créer à l'aide de cette méthode, puis envoyez le nom de la ressource d'audience à la méthode audienceLists.query.

Pour obtenir une présentation des listes d'audience et des exemples, consultez l'article Créer une liste d'audience.

Une liste d'audience est un instantané des utilisateurs qui figurent actuellement dans l'audience au moment de sa création. Si vous créez des listes d'audience pour une audience, mais pour des jours différents, les résultats obtenus varient en fonction des utilisateurs qui rejoignent l'audience ou la quittent.

Les audiences dans Google Analytics 4 vous permettent de segmenter les utilisateurs afin de dégager les données importantes pour votre entreprise. Pour en savoir plus, consultez https://support.google.com/analytics/answer/9267572. Les listes d'audience contiennent les utilisateurs de chaque audience.

Cette méthode est disponible en version bêta sur audienceExports.create. Pour nous faire part de vos commentaires sur cette API, remplissez le formulaire Commentaires sur l'API Audience Export Google Analytics.

Requête HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Ressource parente dans laquelle cette liste d'audience sera créée. Format : properties/{property}

Corps de la requête

Le corps de la requête contient une instance AudienceList.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation.

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