Method: advertisers.reachForecast.retrievePlannableUserInterests

Récupère les audiences Google (centres d'intérêt des utilisateurs) disponibles pour les prévisions.

Requête HTTP

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/reachForecast:retrievePlannableUserInterests

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
advertiserId

string (int64 format)

Obligatoire. ID de l'annonceur pour lequel lister les centres d'intérêt des utilisateurs planifiables.

Paramètres de requête

Paramètres
productCategory

enum (PlannableProductCategory)

Obligatoire. Catégorie de produits pour laquelle récupérer les centres d'intérêt planifiables des utilisateurs.

Corps de la requête

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

Corps de la réponse

Réponse pour reachForecast.retrievePlannableUserInterests.

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

Représentation JSON 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
Champs
plannableUserInterests[]

object (PlannableUserInterest)

Liste des centres d'intérêt des utilisateurs (audiences Google) pouvant être planifiés.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/display-video

Pour plus d'informations, consultez la OAuth 2.0 Overview.

PlannableUserInterest

Centre d'intérêt de l'utilisateur planifiable utilisé pour le ciblage.

Représentation JSON 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
Champs
userInterestDisplayName

string

Uniquement en sortie. Nom à afficher du centre d'intérêt, par exemple "Amateurs de sports et activités en plein air".
userInterestPath

string

Uniquement en sortie. Chemin de la catégorie du centre d'intérêt.
userInterestType

string

Uniquement en sortie. Type d'audience, par exemple "AFFINITY", "IN_MARKET".
userInterest

object (UserInterest)

Uniquement en sortie. Identifiant du centre d'intérêt de l'utilisateur.

Le champ [productCategory][] spécifié dans la requête détermine le champ renseigné dans l'objet.

  • [userInterestCategory][] est renseigné pour "YouTube".
  • [userInterestUserList][] est renseigné pour "Enchère ouverte".

Centres d'intérêt des internautes

Identifiant d'un centre d'intérêt de l'utilisateur.

Représentation JSON 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
Champs
userInterestCategory

string

Uniquement en sortie. Nom de ressource de la catégorie de centre d'intérêt. Renseigné lorsque productCategory est défini sur "Youtube". Format : customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

Uniquement en sortie. Nom de ressource de la liste d'utilisateurs. Renseigné lorsque productCategory est défini sur "Enchère ouverte". Format : customers/{customerId}/userLists/{user_list_id}