Method: listPlannableProducts

Affiche la liste des formats d'annonces YouTube pouvant être planifiés par établissement et dont le ciblage est autorisé.

Liste des erreurs générées: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Requête HTTP

POST https://googleads.googleapis.com/v16:listPlannableProducts

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "plannableLocationId": string
}
Champs
plannableLocationId

string

Obligatoire. ID du lieu sélectionné pour la planification. Pour répertorier les ID de zone géographique pouvant être planifiés, utilisez ReachPlanService.ListPlannableLocations.

Corps de la réponse

Réponse avec tous les produits disponibles.

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)

Liste des produits disponibles pour la planification et des métadonnées de ciblage associées.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/adwords

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

ProductMetadata

Métadonnées associées à un produit disponible planifiable.

Représentation JSON 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
Champs
plannableProductName

string

Nom associé au produit publicitaire.
plannableTargeting

object (PlannableTargeting)

Ciblage planifiable autorisé pour ce produit.
plannableProductCode

string

Le code associé au produit publicitaire (par exemple, BUMPER, TRUEVIEW_IN_STREAM). Pour lister les codes des produits planifiables disponibles, utilisez ReachPlanService.ListPlannableProducts.

PlannableTargeting

Ciblage pour lequel les métriques sur le trafic seront prises en compte.

Représentation JSON 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
Champs
ageRanges[]

enum (ReachPlanAgeRange)

Tranches d'âge autorisées pour le produit pour lequel vous souhaitez générer des rapports. Le ciblage réel est calculé en mappant cette tranche d'âge aux valeurs Google common.AgeRangeInfo standards.
genders[]

object (GenderInfo)

Critères de sexe pouvant être ciblés pour le produit publicitaire.
devices[]

object (DeviceInfo)

Appareils pouvant être ciblés pour le produit publicitaire. Le ciblage par types d'appareil "TABLET" est automatiquement appliqué aux statistiques des rapports lorsque le ciblage par type d'appareil "MOBILE" est sélectionné pour les produits CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER et GOOGLE_PREFERRED_SHORT.
networks[]

enum (ReachPlanNetwork)

Réseaux pouvant être ciblés pour le produit publicitaire.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Lineups YouTube Select pouvant être ciblés pour le produit publicitaire.
surfaceTargeting

object (SurfaceTargetingCombinations)

Combinaisons de surfaces pouvant être ciblées pour le produit publicitaire.

YouTubeSelectLineUp

Un lineup Plannable YouTube Select pour le ciblage de produits.

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

string (int64 format)

ID du lineup YouTube Select.
lineupName

string

Nom unique du lineup YouTube Select.

SurfaceTargetingCombinations

Combinaisons de ciblage des surfaces disponibles pour un produit publicitaire.

Représentation JSON 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
Champs
defaultTargeting

object (SurfaceTargeting)

Ciblage par surface par défaut appliqué au produit publicitaire.
availableTargetingCombinations[]

object (SurfaceTargeting)

Combinaisons de cibles de surface disponibles pour le produit publicitaire.