Method: listPlannableProducts

Muestra la lista de formatos de anuncios de YouTube que se pueden planificar por ubicación y con segmentación permitida.

Lista de errores arrojados: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Solicitud HTTP

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

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "plannableLocationId": string
}
Campos
plannableLocationId

string

Obligatorio. El ID de la ubicación seleccionada para la planificación. Para ver los IDs de ubicación planificables disponibles, usa ReachPlanService.ListPlannableLocations.

Cuerpo de la respuesta

Una respuesta con todos los productos disponibles.

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)

Es la lista de productos disponibles para la planificación y los metadatos de segmentación relacionados.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

ProductMetadata

Los metadatos asociados con un producto planificable disponible.

Representación JSON 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
Campos
plannableProductName

string

Es el nombre asociado con el producto del anuncio.
plannableTargeting

object (PlannableTargeting)

Es la segmentación planificable permitida para este producto.
plannableProductCode

string

Es el código asociado con el producto del anuncio (por ejemplo: BUMPER, TRUEVIEW_IN_STREAM). Para enumerar los códigos de productos planificables disponibles, usa ReachPlanService.ListPlannableProducts.

PlannableTargeting

Es la segmentación para la que se informarán las métricas de tráfico.

Representación JSON 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ]
}
Campos
ageRanges[]

enum (ReachPlanAgeRange)

Rangos de edad planificables permitidos para el producto para el que se informarán las métricas. Para calcular la segmentación real, se asigna este rango de edad a los valores estándar de Google Commons.AgeRangeInfo.
genders[]

object (GenderInfo)

Sexos para los que se puede segmentar el producto del anuncio.
devices[]

object (DeviceInfo)

Son los dispositivos que se pueden orientar para el producto publicitario. La segmentación por dispositivo de TABLET se aplica automáticamente a las métricas informadas cuando se selecciona la segmentación por MOBILE para los productos CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER y GOOGLE_PREFERRED_SHORT.
networks[]

enum (ReachPlanNetwork)

Redes que se pueden orientar para el producto publicitario
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Selecciones de contenido de YouTube Select que se pueden segmentar para el producto publicitario.

YouTubeSelectLineUp

Una selección de contenido de YouTube Select planificable para la segmentación de productos

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

string (int64 format)

El ID de la selección de contenido de YouTube Select.
lineupName

string

El nombre único de la selección de contenido de YouTube Select.