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/v4/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 produit 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 planifiables (audiences Google).

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 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 de l'intérêt, par exemple "Passionnés d'activités d'extérieur".
userInterestPath

string

Uniquement en sortie. Chemin de catégorie de l'intérêt.
userInterestType

string

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

object (UserInterest)

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

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

  • [userInterestCategory][] est renseigné pour "Youtube".
  • [userInterestUserList][] est renseigné pour les enchères ouvertes.

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ée lorsque productCategory est défini sur "Enchères ouvertes". Format : customers/{customerId}/userLists/{user_list_id}