- Recurso: AdGroupAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- Thumbnail
- VideoPerformanceAd
- AdUrl
- AdUrlType
- Métodos
Recurso: AdGroupAd
Es un anuncio único asociado a un grupo de anuncios.
Representación JSON |
---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "entityStatus": enum ( |
Campos | |
---|---|
name |
Es el nombre del recurso del anuncio. |
advertiserId |
El ID único del anunciante al que pertenece el anuncio |
adGroupAdId |
El ID único del anuncio Lo asigna el sistema. |
adGroupId |
El ID único del grupo de anuncios al que pertenece el anuncio |
displayName |
El nombre visible del anuncio. Debe estar codificado en UTF-8 con un tamaño máximo de 255 bytes. |
entityStatus |
Es el estado de la entidad del anuncio. |
adUrls[] |
Es la lista de las URLs que utiliza el anuncio. |
Campo de unión ad_details . Son los detalles del anuncio. Las direcciones (ad_details ) solo pueden ser una de las siguientes opciones: |
|
displayVideoSourceAd |
Detalles de un anuncio provenientes de una creatividad de Display & Video 360 |
mastheadAd |
Son los detalles de un anuncio publicado en el feed de la página principal de YouTube. |
inStreamAd |
Detalles de un anuncio in-stream que se puede omitir después de 5 segundos, que se utiliza para los objetivos de marketing de alcance o reconocimiento de la marca. |
nonSkippableAd |
Detalles de un anuncio de video in-stream corto que no se puede omitir, de 6 a 15 segundos, que se usa para los objetivos de marketing de alcance. |
bumperAd |
Son los detalles de un anuncio de video corto que no se puede omitir de 6 segundos o menos, utilizado para alcance. |
audioAd |
Detalles de un anuncio de audio que se utiliza para lograr objetivos de marketing de alcance. |
videoDiscoverAd |
Son los detalles de un anuncio que promociona un video que se muestra en lugares de descubrimiento. |
videoPerformanceAd |
Son los detalles de un anuncio que se usó en una campaña de acción de video para generar acciones para la empresa, el servicio o el producto. |
DisplayVideoSourceAd
El anuncio proviene de una creatividad de DV360.
Representación JSON |
---|
{ "creativeId": string } |
Campos | |
---|---|
creativeId |
Es el ID de la creatividad de origen. |
MastheadAd
Detalles para un anuncio masthead.
Representación JSON |
---|
{ "video": { object ( |
Campos | |
---|---|
video |
Es el video de YouTube que se usa en el anuncio. |
headline |
El título del anuncio. |
description |
Es la descripción del anuncio. |
videoAspectRatio |
Es la relación de aspecto del video de YouTube de reproducción automática en el masthead. |
autoplayVideoStartMillisecond |
Es la cantidad de tiempo (expresado en milisegundos) después del cual se comenzará a reproducir el video. |
autoplayVideoDuration |
El tiempo durante el que se reproducirá automáticamente el video. Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
callToActionButtonLabel |
El texto del botón de llamado a la acción. |
callToActionFinalUrl |
La URL de destino del botón de llamado a la acción. |
callToActionTrackingUrl |
La URL de seguimiento del botón de llamado a la acción. |
showChannelArt |
Indica si se debe mostrar un fondo o un banner en la parte superior de una página de YouTube. |
companionYoutubeVideos[] |
Los videos que aparecen junto al anuncio masthead en computadoras de escritorio No puede haber más de dos. |
YoutubeVideoDetails
Detalles de un video de YouTube
Representación JSON |
---|
{
"id": string,
"unavailableReason": enum ( |
Campos | |
---|---|
id |
ID de video de YouTube que se puede buscar en la página web de YouTube. |
unavailableReason |
Es el motivo por el que los datos del video no están disponibles. |
VideoAspectRatio
Las posibles relaciones de aspecto de un video de YouTube.
Enumeradores | |
---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
No especificado o desconocido. |
VIDEO_ASPECT_RATIO_WIDESCREEN |
El video se estiró y se recortan la parte superior y la 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 ( |
Campos | |
---|---|
commonInStreamAttribute |
Atributos comunes del anuncio |
customParameters |
Los parámetros personalizados para pasar valores personalizados a la plantilla de URL de seguimiento. Es un objeto que contiene una lista de pares |
CommonInStreamAttribute
Atributos comunes de los anuncios in-stream, que no se pueden omitir y bumper
Representación JSON |
---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( |
Campos | |
---|---|
displayUrl |
Es la dirección de la página web que aparece con el anuncio. |
finalUrl |
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 |
La dirección URL cargada en segundo plano con fines de seguimiento. |
actionButtonLabel |
El texto del botón de llamado a la acción. |
actionHeadline |
Título del banner de llamado a la acción. |
video |
Es el video de YouTube del anuncio. |
companionBanner |
Es la imagen que se muestra junto al anuncio de video. |
ImageAsset
Metadatos de un recurso de imagen.
Representación JSON |
---|
{
"mimeType": string,
"fullSize": {
object ( |
Campos | |
---|---|
mimeType |
Es el tipo de MIME del recurso de imagen. |
fullSize |
Metadatos de esta imagen en su tamaño original. |
fileSize |
Tamaño del archivo del recurso de imagen, expresado en bytes. |
NonSkippableAd
Detalles de un anuncio que no se puede omitir
Representación JSON |
---|
{
"commonInStreamAttribute": {
object ( |
Campos | |
---|---|
commonInStreamAttribute |
Atributos comunes del anuncio |
customParameters |
Los parámetros personalizados para pasar valores personalizados a la plantilla de URL de seguimiento. Es un objeto que contiene una lista de pares |
BumperAd
Detalles de un anuncio bumper.
Representación JSON |
---|
{
"commonInStreamAttribute": {
object ( |
Campos | |
---|---|
commonInStreamAttribute |
Atributos comunes del anuncio |
AudioAd
Detalles para un anuncio de audio.
Representación JSON |
---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"video": {
object ( |
Campos | |
---|---|
displayUrl |
Es la dirección de la página web que aparece con el anuncio. |
finalUrl |
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 |
La dirección URL cargada en segundo plano con fines de seguimiento. |
video |
Es el video de YouTube del anuncio. |
VideoDiscoveryAd
Detalles para un anuncio video discovery.
Representación JSON |
---|
{ "headline": string, "description1": string, "description2": string, "video": { object ( |
Campos | |
---|---|
headline |
El título del anuncio |
description1 |
Primera línea de texto del anuncio |
description2 |
Segunda línea de texto para el anuncio |
video |
Es el video de YouTube que promociona el anuncio. |
thumbnail |
Imagen en miniatura utilizada en el anuncio. |
Thumbnail
Posibles opciones de miniaturas en los anuncios discovery de video.
Enumeradores | |
---|---|
THUMBNAIL_UNSPECIFIED |
Desconocido o sin especificar. |
THUMBNAIL_DEFAULT |
La miniatura predeterminada se puede generar automáticamente o subir 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
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 ( |
Campos | |
---|---|
finalUrl |
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 |
La dirección URL cargada en segundo plano con fines de seguimiento. |
actionButtonLabels[] |
Es la lista de recursos de texto que se muestra en el botón de llamado a la acción. |
headlines[] |
Es la lista de títulos que se muestran en el banner de llamado a la acción. |
longHeadlines[] |
La lista de títulos solitarios que se muestran en el banner de llamado a la acción. |
descriptions[] |
Es la lista de descripciones que se muestra en el banner de llamado a la acción. |
displayUrlBreadcrumb1 |
Es la primera parte después del dominio en la URL visible. |
displayUrlBreadcrumb2 |
Es la segunda parte después del dominio en la URL visible. |
domain |
Es el dominio de la URL visible. |
videos[] |
Es la lista de elementos de video de YouTube que utiliza este anuncio. |
customParameters |
Los parámetros personalizados para pasar valores personalizados a la plantilla de URL de seguimiento. Es un objeto que contiene una lista de pares |
companionBanners[] |
Es la lista de banners complementarios utilizados en este anuncio. |
AdUrl
URLs adicionales relacionadas con el anuncio, incluidos los píxeles contadores.
Representación JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Es el tipo de URL del anuncio. |
url |
El valor de string de URL. |
AdUrlType
Tipos de URL de anuncio posibles.
Enumeradores | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
Desconocido o sin especificar. |
AD_URL_TYPE_BEACON_IMPRESSION |
Es un píxel de seguimiento de 1 x 1 para hacer ping cuando se publica una impresión de una creatividad. |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
Pixel contador de impresiones de DCM expandible. Al momento de la publicación, se expande a varias balizas. |
AD_URL_TYPE_BEACON_CLICK |
URL de seguimiento para hacer ping cuando se activa el evento de clic. |
AD_URL_TYPE_BEACON_SKIP |
URL de seguimiento para hacer ping cuando se activa el evento de omisión. |
Métodos |
|
---|---|
|
Obtiene un anuncio del grupo de anuncios. |
|
Muestra una lista de los anuncios del grupo de anuncios. |