REST Resource: advertisers.adGroups

Recurso: AdGroup

Es un solo grupo de anuncios asociado a 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)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
Campos
name

string

Solo salida. Es el identificador. Es el nombre del recurso del grupo de anuncios.
advertiserId

string (int64 format)

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

string (int64 format)

Solo salida. Es el ID único del grupo de anuncios. Asignado por el sistema.
lineItemId

string (int64 format)

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

string

Obligatorio. 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)

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

object (BiddingStrategy)

Opcional. Es la estrategia de ofertas que utiliza el grupo de anuncios. Solo se pueden usar los campos youtubeAndPartnersBid y demandGenBid en la estrategia de ofertas.
entityStatus

enum (EntityStatus)

Obligatorio. Controla si el grupo de anuncios puede invertir su presupuesto y ofertar por 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)

Opcional. Es la configuración de la segmentación optimizada del grupo de anuncios.
productFeedData

object (ProductFeedData)

Opcional. Es la configuración del feed de productos de este grupo de anuncios.
adGroupInventoryControl

object (AdGroupInventoryControl)

Opcional. Es obligatorio para los grupos de anuncios de generación de demanda. Especifica el control de inventario del grupo de anuncios.
adSource

enum (AdSource)

Opcional. Es la fuente de los anuncios de este grupo de anuncios. Este campo solo se usa cuando los anuncios se generan automáticamente a partir de una fuente determinada.
creativeAssignments[]

object (CreativeAssignment)

Opcional. Son las creatividades que se usan para generar anuncios en el grupo de anuncios.

Este campo solo se puede asignar si adSource es AD_SOURCE_DV360_CREATIVE.

AdGroupFormat

Es el formato del grupo de anuncios.

Enums
AD_GROUP_FORMAT_UNSPECIFIED El valor del formato no se especifica 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 Anuncios bumper
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 efectivo, incluidos los anuncios in-stream y bumper
AD_GROUP_FORMAT_MASTHEAD Anuncio masthead que aparece en la posición superior de la página principal de YouTube.
AD_GROUP_FORMAT_DEMAND_GEN Anuncios de generación de demanda

ProductFeedData

Son los detalles del feed de productos.

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

enum (ProductMatchType)

Cómo se seleccionan los productos en el feed de productos.
productMatchDimensions[]

object (ProductMatchDimension)

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

boolean

Indica si el feed de productos se inhabilitó para mostrar productos.

ProductMatchType

Son los tipos de formas de hacer coincidir los productos.

Enums
PRODUCT_MATCH_TYPE_UNSPECIFIED No especificado o 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 Hacer coincidir los productos según sus etiquetas personalizadas

ProductMatchDimension

Es una dimensión que se usa para hacer coincidir productos.

Representación JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
Campos
Es la dimensión y el valor con los que debe coincidir el producto. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
productOfferId

string

Es el ID de la oferta de producto que se debe hacer coincidir con un producto que tenga el mismo ID de oferta.
customLabel

object (CustomLabel)

Es la etiqueta personalizada que debe coincidir con todos los productos que la tengan.
Fin de los campos mutuamente excluyentes.

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

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

AdGroupInventoryControl

Es el control de inventario del grupo de anuncios.

Representación JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
Campos
Es el control de inventario del grupo de anuncios. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

La estrategia de inventario.
selectedInventories

object (SelectedInventories)

Los inventarios seleccionados.
Fin de los campos mutuamente excluyentes.

AdGroupInventoryStrategy

Es la estrategia de inventario del grupo de anuncios.

Enums
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED No especificado o desconocido.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY El grupo de anuncios tiene habilitado todo el inventario de Google y de la Red de Display.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY El grupo de anuncios está habilitado para todo el inventario de Google.

SelectedInventories

Es el control de inventario del grupo de anuncios.

Representación JSON 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
Campos
allowYoutubeStream

boolean

Indica si el grupo de anuncios está habilitado para el inventario in-stream de YouTube.
allowYoutubeShorts

boolean

Indica si el grupo de anuncios está habilitado para el inventario de YouTube Shorts.
allowYoutubeFeed

boolean

Indica si el grupo de anuncios está habilitado para el inventario in-feed de YouTube.
allowDiscover

boolean

Indica si el grupo de anuncios está habilitado para el inventario de Descubre.
allowGmail

boolean

Indica si el grupo de anuncios está habilitado para el inventario de Gmail.
allowGoogleDisplayNetwork

boolean

Indica si el grupo de anuncios está habilitado para el inventario de la Red de Display de Google.

AdSource

Es la fuente de los anuncios de este grupo de anuncios.

Enums
AD_SOURCE_UNSPECIFIED No especificado o desconocido. La configuración predeterminada es la fuente de anuncios normal.
AD_SOURCE_DV360_CREATIVE Proviene de una creatividad de DV360.

CreativeAssignment

Son los detalles de una creatividad asignada al grupo de anuncios.

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

string (int64 format)

Obligatorio. Es el ID de la creatividad de Display & Video 360 asignada al grupo de anuncios.

Métodos

bulkEditAssignedTargetingOptions

 Permite editar de forma masiva las opciones de segmentación de varios grupos de anuncios.

bulkListAssignedTargetingOptions

 Muestra las opciones de segmentación asignadas para varios grupos de anuncios en todos los tipos de segmentación.

create

 Crea un grupo de anuncios nuevo.

delete

 Borra un AdGroup.

get

 Obtiene un grupo de anuncios.

list

 Muestra una lista de los grupos de anuncios.

patch

 Actualiza un grupo de anuncios existente.