REST Resource: advertisers.youtubeAdGroups

Recurso: YouTubeAdGroup

Es un grupo de anuncios de YouTube único asociado con una línea de pedido de YouTube y Socios.

Representación JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
Campos
name

string

El nombre del recurso del grupo de anuncios.
advertiserId

string (int64 format)

El ID único del anunciante al que pertenece el grupo de anuncios.
adGroupId

string (int64 format)

El ID único del grupo de anuncios. Lo asigna el sistema.
lineItemId

string (int64 format)

El ID único de la línea de pedido a la que pertenece el grupo de anuncios.
displayName

string

El nombre visible del grupo de anuncios.

Debe estar codificado en UTF-8 con un tamaño máximo de 255 bytes.
youtubeAdIds[]

string (int64 format)

Son los ID de los recursos [youtube_ad_group_ad][] asociados con el grupo de anuncios.
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

El formato de los anuncios en el grupo de anuncios.
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

Es la estrategia de ofertas que utiliza el grupo de anuncios.
entityStatus

enum (EntityStatus)

Controla si el grupo de anuncios puede invertir su presupuesto y ofertar en el inventario.

Si la línea de pedido superior del grupo de anuncios no está activa, el presupuesto no podrá invertir en el grupo de anuncios, incluso si su propio estado es ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

La configuración de expansión de la segmentación del grupo de anuncios

Esta configuración solo se aplica cuando se asigna la segmentación por listas de público apta al grupo de anuncios.
productFeedData

object (ProductFeedData)

La configuración del feed de productos en este grupo de anuncios.

YoutubeAndPartnersAdGroupFormat

El formato del grupo de anuncios de YouTube.

Enumeradores
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED No se especificó el valor de formato o se desconoce en esta versión.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM Anuncios in-stream
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY Anuncios in-feed.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Los bumpers publicitarios
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Anuncios in-stream que no se pueden omitir
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Anuncios de audio in-stream que no se pueden omitir
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION Anuncios responsivos para las campañas de acción de video.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Grupos de anuncios de alcance eficaz, incluidos los anuncios in-stream y bumper
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD Anuncio masthead que aparece en el espacio superior de la página principal de YouTube

ProductFeedData

Los detalles del feed de productos.

Representación JSON 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Campos
productMatchType

enum (ProductMatchType)

Cómo el feed de productos selecciona los productos.
productMatchDimensions[]

object (ProductMatchDimension)

Una lista de las dimensiones que se usan para establecer coincidencias con los productos.
isFeedDisabled

boolean

Si el feed de productos inhabilitó la opción para mostrar productos.

ProductMatchType

Los tipos de las formas de hacer coincidir productos.

Enumeradores
PRODUCT_MATCH_TYPE_UNSPECIFIED No especificado o desconocido.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Todos los productos coinciden.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Se seleccionan productos específicos.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Hacer coincidir los productos según sus etiquetas personalizadas.

ProductMatchDimension

Una dimensión que se utiliza para establecer coincidencias con los productos.

Representación JSON 
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
Campos
Campo de unión dimension. Es la dimensión y el valor en los que se debe coincidir el producto. Las direcciones (dimension) solo pueden ser una de las siguientes opciones:
productOfferId

string

Es el ID de la oferta del producto que debe coincidir con otro producto que tiene el mismo ID de oferta.
customLabel

object (CustomLabel)

La etiqueta personalizada que debe coincidir con todos los productos incluidos en ella.

CustomLabel

La clave y el valor de una etiqueta personalizada.

Representación JSON 
{
  "key": enum (CustomLabelKey),
  "value": string
}
Campos
key

enum (CustomLabelKey)

La clave de la etiqueta.
value

string

El valor de la etiqueta.

CustomLabelKey

La clave de la etiqueta personalizada

Enumeradores
CUSTOM_LABEL_KEY_UNSPECIFIED No especificado o desconocido.
CUSTOM_LABEL_KEY_0 Índice de clave 0.
CUSTOM_LABEL_KEY_1 Índice de clave 1.
CUSTOM_LABEL_KEY_2 Índice de clave 2.
CUSTOM_LABEL_KEY_3 Índice de clave 3.
CUSTOM_LABEL_KEY_4 Índice de clave 4.

Métodos

bulkListAdGroupAssignedTargetingOptions

 Se muestran las opciones de segmentación asignadas para varios grupos de anuncios de YouTube en los distintos tipos de segmentación.

get

 Obtiene un grupo de anuncios de YouTube.

list

 Muestra una lista de los grupos de anuncios de YouTube.