REST Resource: advertisers.adGroups

Recurso: AdGroup

Un solo grupo de anuncios asociado con una línea de pedido.

Representación JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
Campos
name

string

Es el nombre del recurso del grupo de anuncios.
advertiserId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

Es el nombre visible del grupo de anuncios.

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

enum (AdGroupFormat)

Es el formato de los anuncios del grupo de anuncios.
bidStrategy

object (BiddingStrategy)

Es la estrategia de ofertas que utiliza el grupo de anuncios. Solo se puede usar el campo youtubeAndPartnersBid en la estrategia de ofertas.
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 grupo de anuncios no puede invertir su presupuesto, incluso si su propio estado es ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

La configuración de la segmentación optimizada del grupo de anuncios
productFeedData

object (ProductFeedData)

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

AdGroupFormat

Es el formato del grupo de anuncios.

Enumeraciones
AD_GROUP_FORMAT_UNSPECIFIED El valor del formato no se especificó o es desconocido en esta versión.
AD_GROUP_FORMAT_IN_STREAM Anuncios in-stream
AD_GROUP_FORMAT_VIDEO_DISCOVERY Anuncios in-feed
AD_GROUP_FORMAT_BUMPER Bumpers publicitarios
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Anuncios in-stream que no se pueden omitir
AD_GROUP_FORMAT_AUDIO Anuncios de audio in-stream que no se pueden omitir
AD_GROUP_FORMAT_RESPONSIVE Anuncios responsivos
AD_GROUP_FORMAT_REACH Grupos de anuncios de alcance eficaz, incluidos los anuncios in-stream y bumper
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)

Es una lista de dimensiones que se usan para hacer coincidir los productos.
isFeedDisabled

boolean

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

ProductMatchType

Los tipos de formas de hacer coincidir los productos.

Enumeraciones
PRODUCT_MATCH_TYPE_UNSPECIFIED No se especifica o es desconocido.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Todos los productos coinciden.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Se seleccionaron productos específicos.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Haz coincidir los productos por sus etiquetas personalizadas.

ProductMatchDimension

Es una dimensión que se usa para hacer coincidir 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. La dimensión y el valor en los que se debe hacer 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 un producto con el mismo ID de oferta.
customLabel

object (CustomLabel)

Es la etiqueta personalizada que debe coincidir con todos los productos que tengan la etiqueta.

CustomLabel

La clave y el valor de una etiqueta personalizada.

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

enum (CustomLabelKey)

Es la clave de la etiqueta.
value

string

Es el valor de la etiqueta.

CustomLabelKey

La clave de la etiqueta personalizada

Enumeraciones
CUSTOM_LABEL_KEY_UNSPECIFIED No se especifica o es 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 claves 3.
CUSTOM_LABEL_KEY_4 Índice de claves 4.

Métodos

bulkListAdGroupAssignedTargetingOptions

 Se muestra una lista de opciones de segmentación asignadas para varios grupos de anuncios en los tipos de segmentación.

get

 Obtiene un grupo de anuncios.

list

 Muestra una lista de los grupos de anuncios.