Method: advertisers.reachForecast.retrievePlannableProducts

Récupère la liste des produits qui peuvent être planifiés pour un établissement.

Requête HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableProducts

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 produits planifiables.

Paramètres de requête

Paramètres
plannableLocationId

string

Obligatoire. ID de la zone géographique planifiable.

Corps de la requête

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

Corps de la réponse

Réponse pour reachForecast.retrievePlannableProducts

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

Représentation JSON 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
Champs
productMetadata[]

object (ProductMetadata)

Uniquement en sortie. Liste des métadonnées produit indiquant les possibilités de ciblage.

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.

ProductMetadata

Métadonnées d'un produit planifiable.

Représentation JSON 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
Champs
plannableProductDescription

string

Uniquement en sortie. Description en texte brut du produit publicitaire.
plannableProductCode

string

Uniquement en sortie. Code du produit planifiable (par exemple, "YOUTUBE_REACH_MIX").
plannableTargeting

object (PlannableTargeting)

Uniquement en sortie. Fonctionnalités de ciblage disponibles pour ce produit.
displayName

string

Uniquement en sortie. Nom associé au produit publicitaire. Par exemple : "Campagne de vues de vidéo".
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

Uniquement en sortie. Attributs principaux de ce produit.

PlannableTargeting

Fonctionnalités de ciblage pour un produit donné.

Représentation JSON 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
Champs
ageRanges[]

enum (PlannableAgeRange)

Uniquement en sortie. Tranches d'âge planifiables autorisées pour le produit. Le ciblage réel est calculé en mappant cette tranche d'âge sur le ciblage par tranche d'âge standard de Google.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

Uniquement en sortie. Combinaisons de surfaces ciblables pour le produit publicitaire.
genders[]

enum (Gender)

Uniquement en sortie. Sexes ciblables pour le produit publicitaire.
networks[]

enum (PlannableNetwork)

Uniquement en sortie. Réseaux ciblables pour le produit publicitaire.
devices[]

enum (DeviceType)

Uniquement en sortie. Appareils ciblables pour le produit publicitaire.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Uniquement en sortie. Lineups YouTube Select ciblables pour le produit publicitaire.
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

Uniquement en sortie. La lineup YouTube Select par défaut pour ce produit, le cas échéant.

SurfaceTargetingCombinations

Règles de ciblage des surfaces.

Représentation JSON 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
Champs
availableSurfaceTypes[]

enum (PlannableSurface)

Uniquement en sortie. Types de surfaces disponibles.
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

Uniquement en sortie. Combinaisons valides de surfaces pouvant être sélectionnées ensemble.
defaultSurfaceTypes[]

enum (PlannableSurface)

Uniquement en sortie. Types de surfaces par défaut pour ce produit.

SurfaceTargetingCombination

Combinaison de surfaces valide.

Représentation JSON 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
Champs
choices[]

enum (PlannableSurface)

Uniquement en sortie. Combinaison de surfaces.

YouTubeSelectLineUp

Lineup YouTube Select planifiable pour le ciblage de produits.

Représentation JSON 
{
  "lineupId": string,
  "displayName": string
}
Champs
lineupId

string (int64 format)

Uniquement en sortie. ID du lineup YouTube Select.
displayName

string

Uniquement en sortie. Nom à afficher de la sélection YouTube Select.

PlannableProductCoreAttributes

Attributs principaux d'un produit planifiable.

Représentation JSON 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
Champs
productCategory

enum (PlannableProductCategory)

Uniquement en sortie. Catégorie de produits.
buyingMethod

enum (PlannableBuyingMethod)

Uniquement en sortie. Méthode d'achat.
costModel

enum (PlannableCostModel)

Uniquement en sortie. Modèle de coûts.

PlannableBuyingMethod

Méthode d'achat d'un produit planifiable.

Enums
PLANNABLE_BUYING_METHOD_UNSPECIFIED Non spécifié.
PLANNABLE_BUYING_METHOD_AUCTION Enchères
PLANNABLE_BUYING_METHOD_RESERVATION Réservation.

PlannableCostModel

Modèle de coût d'un produit planifiable.

Enums
PLANNABLE_COST_MODEL_UNSPECIFIED Non spécifié.
PLANNABLE_COST_MODEL_CPM le CPM max.
PLANNABLE_COST_MODEL_CPV CPV.
PLANNABLE_COST_MODEL_CPC max.)
PLANNABLE_COST_MODEL_CPA CPA moyen.