Method: advertisers.reachForecast.retrievePlannableProducts

Recupera la lista de productos que se pueden planificar para una ubicación.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
advertiserId

string (int64 format)

Obligatorio. Es el ID del anunciante para el que se enumerarán los productos planificables.

Parámetros de consulta

Parámetros
plannableLocationId

string

Obligatorio. Es el ID de la ubicación planificable.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta para reachForecast.retrievePlannableProducts

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
Campos
productMetadata[]

object (ProductMetadata)

Solo salida. Es la lista de metadatos del producto que muestra las posibilidades de segmentación.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

ProductMetadata

Son los metadatos de un producto planificable.

Representación JSON 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
Campos
plannableProductDescription

string

Solo salida. Es la descripción en texto sin formato del producto publicitario.
plannableProductCode

string

Solo salida. Es el código del producto planificable (p.ej., "YOUTUBE_REACH_MIX").
plannableTargeting

object (PlannableTargeting)

Solo salida. Son las capacidades de segmentación disponibles para este producto.
displayName

string

Solo salida. Es el nombre asociado con el producto publicitario. Por ejemplo, "Campaña de vistas de video".
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

Solo salida. Son los atributos principales de este producto.

PlannableTargeting

Son las capacidades de segmentación para un producto determinado.

Representación JSON 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
Campos
ageRanges[]

enum (PlannableAgeRange)

Solo salida. Son los rangos de edad planificables permitidos para el producto. La segmentación real se calcula asignando este rango de edad a la segmentación por edad estándar de Google.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

Solo salida. Son las combinaciones de plataformas segmentables para el producto de anuncios.
genders[]

enum (Gender)

Solo salida. Son los géneros a los que se puede segmentar el producto publicitario.
networks[]

enum (PlannableNetwork)

Solo salida. Son las redes segmentables para el producto publicitario.
devices[]

enum (DeviceType)

Solo salida. Son los dispositivos aptos para la segmentación del producto publicitario.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Solo salida. Son las selecciones de contenido de YouTube Select para las que se puede segmentar el producto publicitario.
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

Solo salida. Es la selección de contenido predeterminada de YouTube Select para este producto, si corresponde.

SurfaceTargetingCombinations

Son las reglas de segmentación de plataformas.

Representación JSON 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
Campos
availableSurfaceTypes[]

enum (PlannableSurface)

Solo salida. Son los tipos de plataformas disponibles.
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

Solo salida. Combinaciones válidas de plataformas que se pueden seleccionar juntas.
defaultSurfaceTypes[]

enum (PlannableSurface)

Solo salida. Son los tipos de plataformas predeterminados para este producto.

SurfaceTargetingCombination

Es una combinación válida de plataformas.

Representación JSON 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
Campos
choices[]

enum (PlannableSurface)

Solo salida. Es la combinación de superficies.

YouTubeSelectLineUp

Es una selección de contenido de YouTube Select planificable para la segmentación de productos.

Representación JSON 
{
  "lineupId": string,
  "displayName": string
}
Campos
lineupId

string (int64 format)

Solo salida. Es el ID de la selección de contenido de YouTube Select.
displayName

string

Solo salida. Es el nombre visible de la selección de contenido de YouTube Select.

PlannableProductCoreAttributes

Son los atributos principales de un producto planificable.

Representación JSON 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
Campos
productCategory

enum (PlannableProductCategory)

Solo salida. Es la categoría del producto.
buyingMethod

enum (PlannableBuyingMethod)

Solo salida. Es el método de compra.
costModel

enum (PlannableCostModel)

Solo salida. Es el modelo de costos.

PlannableBuyingMethod

Es el método de compra de un producto planificable.

Enums
PLANNABLE_BUYING_METHOD_UNSPECIFIED No se especifica.
PLANNABLE_BUYING_METHOD_AUCTION Subasta.
PLANNABLE_BUYING_METHOD_RESERVATION Reserva.

PlannableCostModel

Es el modelo de costos de un producto planificable.

Enums
PLANNABLE_COST_MODEL_UNSPECIFIED No se especifica.
PLANNABLE_COST_MODEL_CPM máx.
PLANNABLE_COST_MODEL_CPV CPV.
PLANNABLE_COST_MODEL_CPC CPC.
PLANNABLE_COST_MODEL_CPA prom.