REST Resource: advertisers.adGroupAds

Recurso: AdGroupAd

Es un anuncio individual asociado a un grupo de anuncios.

Representación JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
Campos
name

string

Solo salida. Es el nombre del recurso del anuncio.
advertiserId

string (int64 format)

Solo salida. Es el ID único del anunciante al que pertenece el anuncio.
adGroupAdId

string (int64 format)

Solo salida. Es el ID único del anuncio. Asignado por el sistema.
adGroupId

string (int64 format)

Obligatorio. Inmutable. Es el ID único del grupo de anuncios al que pertenece el anuncio.
displayName

string

Obligatorio. Es el nombre visible del anuncio.

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

object (AdPolicy)

Solo salida. Es el estado de aprobación de la política del anuncio.
entityStatus

enum (EntityStatus)

Obligatorio. Es el estado de la entidad del anuncio.
adUrls[]

object (AdUrl)

Solo salida. Es la lista de URLs que usa el anuncio.
dcmTrackingInfo

object (DcmTrackingInfo)

Opcional. Es la información del anuncio de seguimiento de DCM. Solo es válido para los anuncios de generación de demanda.

Para quitar la información del anuncio de seguimiento de DCM, deja este campo vacío.
Son los detalles del anuncio. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Solo salida. Son los detalles de un anuncio que proviene de una creatividad de Display & Video 360.
mastheadAd

object (MastheadAd)

Solo salida. Detalles de un anuncio publicado en el feed de la página principal de YouTube.
inStreamAd

object (InStreamAd)

Solo salida. Detalles de un anuncio in-stream que se puede omitir después de 5 segundos, que se utiliza para los objetivos de marketing de reconocimiento de la marca o alcance.
nonSkippableAd

object (NonSkippableAd)

Solo salida. Son los detalles de un anuncio de video in-stream corto que no se puede omitir, de entre 6 y 15 segundos, que se utiliza para los objetivos de marketing de alcance.
bumperAd

object (BumperAd)

Solo salida. Son los detalles de un anuncio de video corto que no se puede omitir, de 6 segundos o menos, que se usa para el alcance.
audioAd

object (AudioAd)

Solo salida. Son los detalles de un anuncio de audio que se utiliza para objetivos de marketing de alcance.
videoDiscoverAd

object (VideoDiscoveryAd)

Solo salida. Son los detalles de un anuncio que promociona un video que se muestra en lugares de descubrimiento.
videoPerformanceAd

object (VideoPerformanceAd)

Solo salida. Son los detalles de un anuncio que se utiliza en una campaña de acción de video para generar acciones para la empresa, el servicio o el producto.
demandGenVideoAd

object (DemandGenVideoAd)

Son los detalles de un anuncio de video de generación de demanda.
demandGenImageAd

object (DemandGenImageAd)

Son los detalles de un anuncio con imagen de generación de demanda.
demandGenProductAd

object (DemandGenProductAd)

Son los detalles de un anuncio de producto de generación de demanda.
Fin de los campos mutuamente excluyentes.

DisplayVideoSourceAd

Es el anuncio que proviene de una creatividad de DV360.

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

string (int64 format)

Es el ID de la creatividad fuente.

MastheadAd

Son los detalles de un anuncio masthead.

Representación JSON 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
Campos
video

object (YoutubeVideoDetails)

Es el video de YouTube que utiliza el anuncio.
headline

string

Es el título del anuncio.
description

string

Es la descripción del anuncio.
videoAspectRatio

enum (VideoAspectRatio)

Es la relación de aspecto del video de YouTube que se reproduce automáticamente en el masthead.
autoplayVideoStartMillisecond

string (int64 format)

Es la cantidad de tiempo en milisegundos después de la cual comenzará a reproducirse el video.
autoplayVideoDuration

string (Duration format)

Es la duración de la reproducción automática del video.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
callToActionButtonLabel

string

Es el texto que aparece en el botón de llamado a la acción.
callToActionFinalUrl

string

La URL de destino del botón de llamado a la acción.
callToActionTrackingUrl

string

Es la URL de seguimiento del botón de llamado a la acción.
showChannelArt

boolean

Indica si se debe mostrar un fondo o banner en la parte superior de una página de YouTube.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

Son los videos que aparecen junto al anuncio masthead en computadoras de escritorio. No puede haber más de dos.

YoutubeVideoDetails

Son los detalles de un video de YouTube.

Representación JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason),
  "videoAssetId": string
}
Campos
id

string

Solo salida. Es el ID del video de YouTube que se puede buscar en la página web de YouTube.
unavailableReason

enum (VideoUnavailableReason)

Es el motivo por el que los datos del video no están disponibles.
videoAssetId

string (int64 format)

Obligatorio. Es el ID del recurso de video de YouTube. Este es el adAssetId de un recurso AdAsset.

VideoUnavailableReason

Posibles motivos por los que un video podría no estar disponible

Enums
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Desconocido o sin especificar.
VIDEO_UNAVAILABLE_REASON_PRIVATE El video es privado.
VIDEO_UNAVAILABLE_REASON_DELETED Se borra el video.

VideoAspectRatio

Son las posibles relaciones de aspecto de un video de YouTube.

Enums
VIDEO_ASPECT_RATIO_UNSPECIFIED No especificado o desconocido.
VIDEO_ASPECT_RATIO_WIDESCREEN El video se estira y se recortan las partes superior e inferior.
VIDEO_ASPECT_RATIO_FIXED_16_9 El video usa una relación de aspecto fija de 16:9.

InStreamAd

Son los detalles de un anuncio in-stream.

Representación JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Campos
commonInStreamAttribute

object (CommonInStreamAttribute)

Atributos de anuncios comunes
customParameters

map (key: string, value: string)

Son los parámetros personalizados y los valores que los acompañan que se agregarán a la URL de seguimiento.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CommonInStreamAttribute

Atributos comunes de los anuncios in-stream, los anuncios que no se pueden omitir y los anuncios bumper.

Representación JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Campos
displayUrl

string

Es la dirección de la página web que aparece con el anuncio.
finalUrl

string

Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en el anuncio.
trackingUrl

string

Es la dirección URL que se carga en segundo plano para realizar un seguimiento.
actionButtonLabel

string

Es el texto que aparece en el botón de llamado a la acción.
actionHeadline

string

Es el título del banner de llamado a la acción.
video

object (YoutubeVideoDetails)

Es el video de YouTube del anuncio.
companionBanner

object (ImageAsset)

Es la imagen que se muestra junto al anuncio de video.

ImageAsset

Son los metadatos de un recurso de imagen.

Representación JSON 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string,
  "assetId": string
}
Campos
mimeType

string

Solo salida. Es el tipo de MIME del recurso de imagen.
fullSize

object (Dimensions)

Solo salida. Son los metadatos de esta imagen en su tamaño original.
fileSize

string (int64 format)

Solo salida. Es el tamaño del archivo del recurso de imagen en bytes.
assetId

string (int64 format)

Obligatorio. Es el ID único del recurso.

NonSkippableAd

Son los detalles de un anuncio que no se puede omitir.

Representación JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Campos
commonInStreamAttribute

object (CommonInStreamAttribute)

Atributos de anuncios comunes
customParameters

map (key: string, value: string)

Son los parámetros personalizados y los valores que los acompañan que se agregarán a la URL de seguimiento.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

BumperAd

Detalles de un anuncio bumper.

Representación JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Campos
commonInStreamAttribute

object (CommonInStreamAttribute)

Atributos de anuncios comunes

AudioAd

Son los detalles de un anuncio de audio.

Representación JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Campos
displayUrl

string

Es la dirección de la página web que aparece con el anuncio.
finalUrl

string

Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en el anuncio.
trackingUrl

string

Es la dirección URL que se carga en segundo plano para realizar un seguimiento.
video

object (YoutubeVideoDetails)

Es el video de YouTube del anuncio.

VideoDiscoveryAd

Son los detalles de un anuncio discovery de video.

Representación JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
Campos
headline

string

Es el título del anuncio.
description1

string

Es la primera línea de texto del anuncio.
description2

string

Es la segunda línea de texto del anuncio.
video

object (YoutubeVideoDetails)

Es el video de YouTube que promociona el anuncio.
thumbnail

enum (Thumbnail)

Es la imagen en miniatura que se usa en el anuncio.

Miniatura

Posibles opciones de miniaturas en los anuncios discovery de video.

Enums
THUMBNAIL_UNSPECIFIED Desconocido o sin especificar.
THUMBNAIL_DEFAULT La miniatura predeterminada, que puede ser generada de forma automática o subida por el usuario.
THUMBNAIL_1 Miniatura 1, generada a partir del video.
THUMBNAIL_2 Miniatura 2, generada a partir del video.
THUMBNAIL_3 Miniatura 3, generada a partir del video.

VideoPerformanceAd

Son los detalles de un anuncio de rendimiento de video.

Representación JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ],
  "businessName": string,
  "logo": {
    object (ImageAsset)
  }
}
Campos
finalUrl

string

Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en el anuncio.
trackingUrl

string

Es la dirección URL que se carga en segundo plano para realizar un seguimiento.
actionButtonLabels[]

string

Es la lista de recursos de texto que se muestran en el botón de llamado a la acción.
headlines[]

string

Es la lista de títulos que se muestran en el banner de llamado a la acción.
longHeadlines[]

string

Es la lista de títulos largos que se muestran en el banner de llamado a la acción.
descriptions[]

string

Es la lista de descripciones que se muestran en el banner de llamado a la acción.
displayUrlBreadcrumb1

string

Es la primera parte después del dominio en la URL visible.
displayUrlBreadcrumb2

string

Es la segunda parte después del dominio en la URL visible.
domain

string

Es el dominio de la URL visible.
videos[]

object (YoutubeVideoDetails)

Es la lista de recursos de video de YouTube que utiliza este anuncio.
customParameters

map (key: string, value: string)

Son los parámetros personalizados y los valores que los acompañan que se agregarán a la URL de seguimiento.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
companionBanners[]

object (ImageAsset)

Es la lista de banners complementarios que usa este anuncio.
businessName

string

Opcional. Es el nombre de la empresa que se muestra en el anuncio.

Este parámetro de configuración es obligatorio, a menos que se establezca un valor predeterminado a nivel del anunciante. Si no se establece, se aplicará el valor predeterminado.

DemandGenVideoAd

Son los detalles de un anuncio de video de generación de demanda.

Representación JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
Campos
finalUrl

string

Obligatorio. Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en el anuncio.
trackingUrl

string

Solo salida. Es la dirección URL que se carga en segundo plano para realizar un seguimiento.
userSpecifiedTrackingUrl

string

Opcional. Es la URL de seguimiento que el usuario especificó de forma manual.
callToAction

enum (CallToAction)

Obligatorio. Es el botón de llamado a la acción que se muestra en el anuncio.

Los valores admitidos son los siguientes:

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

Obligatorio. Es la lista de títulos que se muestran en el anuncio.
longHeadlines[]

string

Obligatorio. Es la lista de títulos largos que se muestran en el anuncio.
descriptions[]

string

Obligatorio. Es la lista de descripciones que se muestran en el anuncio.
displayUrlBreadcrumb1

string

Opcional. Es la primera parte después del dominio en la URL visible.
displayUrlBreadcrumb2

string

Opcional. Es la segunda parte después del dominio en la URL visible.
videos[]

object (YoutubeVideoDetails)

Obligatorio. Es la lista de recursos de video de YouTube que utiliza este anuncio.
customParameters

map (key: string, value: string)

Opcional. Son los parámetros personalizados y los valores que los acompañan que se agregarán a la URL de seguimiento.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
companionBanner

object (ImageAsset)

Opcional. Es el banner complementario que utiliza este anuncio.
finalMobileUrl

string

Opcional. Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en el anuncio en un dispositivo móvil.
finalUrlSuffix

string

Opcional. Es el sufijo que se agregará a las URLs de página de destino.
businessName

string

Opcional. Es el nombre de la empresa que se muestra en el anuncio.

Este parámetro de configuración es obligatorio, a menos que se establezca un valor predeterminado a nivel del anunciante. Si no se establece, se aplicará el valor predeterminado.

CallToAction

Son los posibles valores de llamado a la acción para los anuncios de producto o de video de campaña de generación de demanda.

Enums
CALL_TO_ACTION_UNSPECIFIED No especificado o desconocido.
AUTOMATED Automatizado.
LEARN_MORE Más información
GET_QUOTE Obtener cotización.
APPLY_NOW Postúlate ahora.
SIGN_UP Registrarse.
CONTACT_US Comunícate con nosotros.
SUBSCRIBE Suscribirse.
DOWNLOAD Descargar.
BOOK_NOW Reserva ahora.
SHOP_NOW Cómpralos ahora.
BUY_NOW Compre ahora.
DONATE_NOW Donar ahora.
ORDER_NOW Pedir ahora
PLAY_NOW Jugar ahora
SEE_MORE Obtén más información.
START_NOW Comienza ahora y
VISIT_SITE Visitar el sitio.
WATCH_NOW Míralo ahora.

DemandGenImageAd

Son los detalles de un anuncio con imagen de generación de demanda.

Representación JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
Campos
finalUrl

string

Obligatorio. Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en el anuncio.
trackingUrl

string

Solo salida. Es la dirección URL que se carga en segundo plano para realizar un seguimiento.
userSpecifiedTrackingUrl

string

Opcional. Es la URL de seguimiento que el usuario especificó de forma manual.
callToAction

string

Obligatorio. Es el botón de llamado a la acción que se muestra en el anuncio.
headlines[]

string

Obligatorio. Es la lista de títulos que se muestran en el anuncio.
descriptions[]

string

Obligatorio. Es la lista de descripciones que se muestran en el anuncio.
customParameters

map (key: string, value: string)

Opcional. Son los parámetros personalizados y los valores que los acompañan que se agregarán a la URL de seguimiento.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
finalMobileUrl

string

Opcional. Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en el anuncio en un dispositivo móvil.
finalUrlSuffix

string

Opcional. Es el sufijo que se agregará a las URLs de página de destino.
businessName

string

Opcional. Es el nombre de la empresa que se muestra en el anuncio.

Este parámetro de configuración es obligatorio, a menos que se establezca un valor predeterminado a nivel del anunciante. Si no se establece, se aplicará el valor predeterminado.
marketingImages[]

object (ImageAsset)

Es la lista de imágenes de marketing que se muestran en el anuncio.
squareMarketingImages[]

object (ImageAsset)

Es la lista de imágenes de marketing cuadradas que se muestran en el anuncio.
portraitMarketingImages[]

object (ImageAsset)

Es la lista de imágenes de marketing verticales que se muestran en el anuncio.
logoImages[]

object (ImageAsset)

Es la lista de imágenes de logotipos que se muestran en el anuncio.

Este parámetro de configuración es obligatorio, a menos que se establezca un valor predeterminado a nivel del anunciante. Si no se establece, se aplicará el valor predeterminado.

DemandGenCarouselAd

Son los detalles de un anuncio de carrusel de campaña de generación de demanda.

Representación JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
Campos
finalUrl

string

Obligatorio. Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en el anuncio.
headline

string

Obligatorio. Es el título del anuncio.
description

string

Obligatorio. Es la descripción del anuncio.
cards[]

object (CarouselCard)

Obligatorio. Es la lista de tarjetas que se muestran en el anuncio.
finalUrlSuffix

string

Opcional. Es el sufijo que se agregará a las URLs de página de destino.
trackingUrl

string

Solo salida. Es la dirección URL que se carga en segundo plano para realizar un seguimiento.
userSpecifiedTrackingUrl

string

Opcional. Es la URL de seguimiento que el usuario especificó de forma manual.
businessName

string

Opcional. Es el nombre de la empresa que se muestra en el anuncio.

Este parámetro de configuración es obligatorio, a menos que se establezca un valor predeterminado a nivel del anunciante. Si no se establece, se aplicará el valor predeterminado.
customParameters

map (key: string, value: string)

Opcional. Son los parámetros personalizados y los valores que los acompañan que se agregarán a la URL de seguimiento.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CarouselCard

Son los detalles de una tarjeta de carrusel de campaña de generación de demanda.

Representación JSON 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
Campos
finalUrl

string

Obligatorio. Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en la tarjeta.
finalMobileUrl

string

Opcional. Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en la tarjeta en un dispositivo móvil.
headline

string

Obligatorio. Es el título de la tarjeta.
callToAction

string

Obligatorio. Es el texto que aparece en el botón de llamado a la acción que se muestra en la tarjeta.

Debe tener 10 caracteres o menos.
marketingImage

object (ImageAsset)

Opcional. Es la imagen de marketing que se muestra en la tarjeta.
squareMarketingImage

object (ImageAsset)

Opcional. Es la imagen de marketing cuadrada que se muestra en la tarjeta.
portraitMarketingImage

object (ImageAsset)

Opcional. Es la imagen de marketing vertical que se muestra en la tarjeta.

DemandGenProductAd

Son los detalles de un anuncio de productos de campaña de generación de demanda.

Representación JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
Campos
finalUrl

string

Obligatorio. Es la dirección URL de la página web a la que llegan los usuarios después de hacer clic en el anuncio.
headline

string

Obligatorio. Es el título del anuncio.
description

string

Obligatorio. Es la descripción del anuncio.
finalUrlSuffix

string

Opcional. Es el sufijo que se agregará a las URLs de página de destino.
callToAction

enum (CallToAction)

Obligatorio. Es el botón de llamado a la acción que se muestra en el anuncio.

Los valores admitidos son los siguientes:

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

Solo salida. Es la dirección URL que se carga en segundo plano para realizar un seguimiento.
userSpecifiedTrackingUrl

string

Opcional. Es la URL de seguimiento que el usuario especificó de forma manual.
businessName

string

Opcional. Es el nombre de la empresa que se muestra en el anuncio.

Este parámetro de configuración es obligatorio, a menos que se establezca un valor predeterminado a nivel del anunciante. Si no se establece, se aplicará el valor predeterminado.
customParameters

map (key: string, value: string)

Opcional. Son los parámetros personalizados y los valores que los acompañan que se agregarán a la URL de seguimiento.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
displayUrlBreadcrumb1

string

Opcional. Es la primera parte después del dominio en la URL visible.
displayUrlBreadcrumb2

string

Opcional. Es la segunda parte después del dominio en la URL visible.

AdPolicy

Es una política de anuncios única asociada a un anuncio de un grupo de anuncios.

Representación JSON 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Campos
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

Es el estado de aprobación de la política de un anuncio, que indica la decisión de aprobación.
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

Es el estado de revisión de cumplimiento de las políticas de un anuncio, que indica en qué parte del proceso de revisión se encuentra actualmente.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Son las entradas de cada tema de política que se identificó como relacionado con el anuncio. Cada entrada incluye el tema, el nivel de restricción y orientación sobre cómo corregir los problemas relacionados con las políticas.

AdPolicyApprovalStatus

Son los estados posibles de la aprobación de una política de anuncios.

Enums
AD_POLICY_APPROVAL_STATUS_UNKNOWN Desconocido o no especificado.
DISAPPROVED No se publicará.
APPROVED_LIMITED Se publicará con restricciones.
APPROVED Se publicará sin restricciones.
AREA_OF_INTEREST_ONLY No se publicarán en los países de segmentación, pero podrían publicarse para los usuarios que busquen información sobre esos países.

AdPolicyReviewStatus

Son los posibles estados de una revisión de cumplimiento de las políticas de anuncios.

Enums
AD_POLICY_REVIEW_STATUS_UNKNOWN Desconocido o no especificado.
REVIEW_IN_PROGRESS Actualmente, está en proceso de revisión.
REVIEWED Se completó la revisión principal. Es posible que otras revisiones aún estén en curso.
UNDER_APPEAL Se volvió a enviar para su aprobación o se apeló una decisión basada en políticas.
ELIGIBLE_MAY_SERVE Se considera apto y es posible que se esté publicando. Es posible que se realicen más revisiones.

AdPolicyTopicEntry

Es una entrada que describe cómo se identificó que un anuncio se relaciona con una política de anuncios.

Representación JSON 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
Campos
policyTopic

string

Es el tema de la política.

Algunos ejemplos son "TRADEMARKS", "ALCOHOL", etcétera.
policyLabel

string

Es el texto localizado de la etiqueta de la política.

Por ejemplo, "Marcas en el texto", "Contiene alcohol", etcétera.
policyTopicDescription

string

Es una breve descripción del tema de la política.
policyTopicType

enum (AdPolicyTopicEntryType)

Cómo se verá afectada la publicación de anuncios debido a la relación con el tema de la política de anuncios
policyDecisionType

enum (AdPolicyDecisionType)

Es la fuente de la decisión basada en políticas.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Son los medios de aplicación de medidas por incumplimiento de políticas que se usan en la revisión de cumplimiento de las políticas.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

La evidencia que se usó en la decisión basada en políticas.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Son las restricciones de publicación relevantes para la decisión basada en políticas.
appealInfo

object (AdPolicyTopicAppealInfo)

Información para apelar la decisión basada en políticas

AdPolicyTopicEntryType

Son los posibles impactos en la publicación de un tema de política de anuncios.

Enums
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN Desconocido o no especificado.
PROHIBITED El recurso no se publicará.
FULLY_LIMITED El recurso no se publicará en todos los países de segmentación.
LIMITED El recurso no se puede publicar en algunos países.
DESCRIPTIVE El recurso se puede publicar.
BROADENING El recurso puede publicar anuncios y puede hacerlo más allá de la cobertura normal.
AREA_OF_INTEREST_ONLY El recurso está restringido para todos los países de segmentación, pero puede publicarse para los usuarios que buscan información sobre esos países.

AdPolicyDecisionType

Son las posibles fuentes de una decisión basada en políticas.

Enums
AD_POLICY_DECISION_TYPE_UNKNOWN Desconocido o no especificado.
PURSUANT_TO_NOTICE La decisión se basa en un aviso legal, una orden judicial, un reclamo del propietario del contenido de la marca, etc.
GOOGLE_INVESTIGATION La decisión proviene de una investigación de Google.

AdPolicyEnforcementMeans

Son los posibles medios de aplicación de políticas que se usan en la revisión de cumplimiento de las políticas.

Enums
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Desconocido o no especificado.
AUTOMATED El proceso de aplicación de medidas por incumplimiento se automatizó por completo.
HUMAN_REVIEW Un ser humano participó parcial o totalmente en el proceso de aplicación de la decisión.

AdPolicyTopicEvidence

Es la información de evidencia que se usó en la decisión basada en políticas.

Representación JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
Campos
Es la evidencia de la decisión basada en políticas. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
textList

object (TextList)

Es la lista de evidencias encontradas en el texto del anuncio.
websiteList

object (WebsiteList)

Es la lista de sitios web vinculados con el anuncio.
httpCode

integer

Es el código HTTP que se devolvió cuando se rastreó la URL final.
languageCode

string

Es el idioma en el que se detectó que está escrito el anuncio.

Este campo usa etiquetas de idioma de IETF, como "en-US".
destinationTextList

object (DestinationTextList)

Es el texto en el destino del anuncio que provoca un incumplimiento de política.
destinationMismatch

object (DestinationMismatch)

Una diferencia entre las URLs de destino del anuncio
destinationNotWorking

object (DestinationNotWorking)

Información sobre los errores de HTTP o DNS relacionados con el destino del anuncio.
trademark

object (Trademark)

Son los términos de marcas que causaron un incumplimiento de política.
legalRemoval

object (LegalRemoval)

Aplicación de reglamentaciones legales que causaron un incumplimiento de política
counterfeit

object (Counterfeit)

Aplicación de medidas por incumplimiento de la política de falsificaciones que causó un incumplimiento de política
regionalRequirements

object (RegionalRequirements)

Aplicación proactiva de medidas por incumplimiento de las Condiciones del Servicio que causó un incumplimiento de política.
Fin de los campos mutuamente excluyentes.

TextList

Es una lista de fragmentos de texto que incumplieron la política.

Representación JSON 
{
  "texts": [
    string
  ]
}
Campos
texts[]

string

Son los fragmentos de texto del recurso que causaron el hallazgo de la política.

WebsiteList

Una lista de los sitios web que incumplieron la política

Representación JSON 
{
  "websites": [
    string
  ]
}
Campos
websites[]

string

Son los sitios web que causaron el hallazgo de incumplimiento de la política.

DestinationTextList

Es una lista de textos de destino que infringieron la política.

Representación JSON 
{
  "destinationTexts": [
    string
  ]
}
Campos
destinationTexts[]

string

Es el texto de destino que causó el hallazgo de política.

DestinationMismatch

Detalles sobre una discrepancia entre los tipos de URL de destino.

Representación JSON 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Campos
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

Es el conjunto de URLs que no coinciden. La lista puede incluir uno o varios tipos de URI.

Ejemplo 1: [DISPLAY_URL, FINAL_URL] significa que la URL visible del anuncio no coincide con la URL final del anuncio.

Ejemplo 2: [FINAL_URL] significa que la URL final del anuncio no coincidió con la URL rastreada, lo que también se considera una diferencia en el destino.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Posibles tipos de URLs

Enums
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN No especificado o desconocido.
DISPLAY_URL Es la URL visible.
FINAL_URL La URL final.
FINAL_MOBILE_URL Es la URL final para dispositivos móviles.
TRACKING_URL Es la URL de seguimiento.
MOBILE_TRACKING_URL Es la URL de seguimiento para dispositivos móviles.

DestinationNotWorking

Son los detalles de los errores de HTTP o DNS relacionados con el destino del anuncio.

Representación JSON 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
Campos
expandedUri

string

La URL completa que no funcionó
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Es el dispositivo en el que se produjo el error cuando se visitó la URL.
lastCheckedTime

string (Timestamp format)

La última vez que se vio el error cuando se navegó a la URL.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
El error de HTTP o DNS La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Es el tipo de error de DNS.
httpErrorCode

string (int64 format)

Es el código de error de HTTP.
Fin de los campos mutuamente excluyentes.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Son los posibles tipos de errores de DNS.

Enums
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN No especificado o desconocido.
HOSTNAME_NOT_FOUND No se encontró el nombre de host en el DNS cuando se recuperó la página de destino.
GOOGLE_CRAWLER_DNS_ISSUE Google no pudo rastrear la página de destino cuando se comunicó con el DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Son los dispositivos que posiblemente vieron un error cuando visitaron la URL.

Enums
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN No especificado o desconocido.
DESKTOP Dispositivo de escritorio.
ANDROID Dispositivo Android
IOS Dispositivo iOS.

Marca

Son los términos de marcas que causaron un incumplimiento de política.

Representación JSON 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Campos
owner

string

El propietario del contenido de la marca.
term

string

El término de la marca.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Países donde el incumplimiento de política es relevante.

AdPolicyCriterionRestriction

Representa una restricción por país.

Representación JSON 
{
  "countryCriterionId": string,
  "countryLabel": string
}
Campos
countryCriterionId

string (int64 format)

Es el ID del criterio de país.
countryLabel

string

Es el nombre localizado del país. Puede estar vacío.

LegalRemoval

Aplicación de reglamentaciones legales, ya sea de la DMCA o de reglamentaciones legales locales

Representación JSON 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
Campos
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

El tipo de reclamo que causó la eliminación por motivos legales.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Son los países restringidos debido a la eliminación por motivos legales.
restrictedUris[]

string

Son las URLs restringidas debido a la eliminación por motivos legales.
Son los detalles sobre el tipo de eliminación por motivos legales. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
dmca

object (Dmca)

Son los detalles sobre la eliminación por motivos legales de la reglamentación de la DMCA.
Fin de los campos mutuamente excluyentes.

DMCA

Detalles del reclamo en virtud de la DMCA

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

string

Es la entidad que presentó el reclamo legal.

LocalLegal

Detalles de la reglamentación legal local.

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

string

Es el tipo de ley para el aviso legal.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Son los posibles tipos de reclamos para la eliminación por motivos legales.

Enums
COPYRIGHT

Derechos de autor.

Solo se aplica a la DMCA.
COURT_ORDER

Orden judicial.

Solo se aplica a los requisitos legales locales.

Falsificaciones

Son los detalles sobre la aplicación de medidas por incumplimiento de la política de falsificaciones que causó un incumplimiento de política.

Representación JSON 
{
  "owners": [
    string
  ]
}
Campos
owners[]

string

Los propietarios del contenido o del producto que presentaron un reclamo

RegionalRequirements

Aplicación proactiva de medidas por incumplimiento de políticas de Confianza y Seguridad (T&S) para abordar los requisitos regionales. Esto se considera una investigación de Google en lugar de un aviso de regulación, ya que se trata de una aplicación proactiva de las medidas por incumplimiento de las Condiciones del Servicio.

Representación JSON 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
Campos
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

Lista de requisitos regionales.

RegionalRequirementsEntry

Detalles de los incumplimientos legales regionales a nivel de la política.

Representación JSON 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Campos
legalPolicy

string

La política legal que se está incumpliendo
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Son los países restringidos debido a la política legal.

AdPolicyTopicConstraint

Detalles sobre las restricciones de publicación de anuncios.

Representación JSON 
{
  "requestCertificateFormLink": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
Campos
Es la restricción de publicación. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
countryConstraint

object (AdPolicyCountryConstraintList)

Son los países en los que no se puede publicar el anuncio.
resellerConstraint

object (AdPolicyResellerConstraint)

Restricción del revendedor.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Países en los que se requiere un certificado para publicar anuncios.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

Son los países en los que los certificados asociados no cubren el dominio del recurso.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

Se requiere un certificado para publicar anuncios en cualquier país.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

Se requiere un certificado para publicar anuncios en cualquier país, y el certificado existente no cubre el dominio del anuncio.
Fin de los campos mutuamente excluyentes.

AdPolicyCountryConstraintList

Es una lista de países en los que no se puede publicar el anuncio debido a restricciones de la política.

Representación JSON 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Campos
countries[]

object (AdPolicyCriterionRestriction)

Son los países en los que no se puede publicar el anuncio.

AdPolicyResellerConstraint

Este tipo no tiene campos.

Se restringió el tema de política debido al rechazo del sitio web para fines de reventa.

AdPolicyGlobalCertificateMissingConstraint

Este tipo no tiene campos.

Se requiere un certificado para publicar anuncios en cualquier país.

AdPolicyGlobalCertificateDomainMismatchConstraint

Este tipo no tiene campos.

Se requiere un certificado para publicar anuncios en cualquier país, y el certificado existente no cubre el dominio del anuncio.

AdPolicyTopicAppealInfo

Información para apelar una decisión basada en políticas

Representación JSON 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
Campos
appealType

enum (AdPolicyAppealType)

Si es posible apelar la decisión a través de una apelación de autoservicio o un formulario de apelación

AdPolicyAppealType

Son los posibles tipos de apelación.

Enums
AD_POLICY_APPEAL_TYPE_UNKNOWN Desconocido o no especificado.
SELF_SERVICE_APPEAL La decisión se puede apelar a través de una apelación de autoservicio.
APPEAL_FORM La decisión se puede apelar con un formulario de apelación.

AdUrl

Son las URLs adicionales relacionadas con el anuncio, incluidas las balizas.

Representación JSON 
{
  "type": enum (AdUrlType),
  "url": string
}
Campos
type

enum (AdUrlType)

Es el tipo de URL del anuncio.
url

string

Es el valor de la cadena de la URL.

AdUrlType

Son los posibles tipos de URLs de anuncios.

Enums
AD_URL_TYPE_UNSPECIFIED Desconocido o sin especificar.
AD_URL_TYPE_BEACON_IMPRESSION Es un píxel de seguimiento de 1 × 1 que se activa cuando se publica una impresión de una creatividad.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Pixel contador de impresiones de DCM expandible En el momento de la publicación, se expande a varias balizas.
AD_URL_TYPE_BEACON_CLICK Es la URL de seguimiento a la que se debe hacer ping cuando se activa el evento de clic.
AD_URL_TYPE_BEACON_SKIP Es la URL de seguimiento a la que se debe hacer ping cuando se activa el evento de omisión.

DcmTrackingInfo

Detalles sobre el seguimiento de DCM.

Representación JSON 
{
  "placementId": string,
  "trackingAdId": string,
  "creativeId": string
}
Campos
placementId

string (int64 format)

Obligatorio. Es el ID de posición de DCM.
trackingAdId

string (int64 format)

Obligatorio. Es el ID del anuncio de seguimiento de DCM.
creativeId

string (int64 format)

Obligatorio. Es el ID de la creatividad de DCM.

Métodos

create

 Crea un anuncio del grupo de anuncios.

delete

 Borra un anuncio del grupo de anuncios.

get

 Obtiene un anuncio del grupo de anuncios.

list

 Enumera los anuncios de los grupos de anuncios.

patch

 Actualiza un anuncio de un grupo de anuncios.