- Recurso: YouTubeAdGroupAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- Miniatura
- VideoPerformanceAd
- AdUrl
- AdUrlType
- Métodos
Recurso: YouTubeAdGroupAd
Es un solo anuncio asociado a un grupo de anuncios de YouTube.
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 |
Es el ID único del anunciante al que pertenece el anuncio. |
adGroupAdId |
El ID único del anuncio. Asignada por el sistema. |
adGroupId |
El ID único del grupo de anuncios al que pertenece el anuncio. |
displayName |
Es 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 entidad del anuncio. |
adUrls[] |
Es la lista de URLs utilizadas por 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 obtenido de una campaña de Display & Creatividad de 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 usa para generar reconocimiento de la marca o lograr objetivos de marketing. |
nonSkippableAd |
Son los detalles de un anuncio de video in-stream corto que no se puede omitir, que dura entre 6 y 15 segundos, que se utiliza para lograr 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, que se utiliza para el alcance. |
audioAd |
Detalles de un anuncio de audio que se usó para lograr los objetivos de marketing |
videoDiscoverAd |
Son los detalles de un anuncio que promociona un video que aparece en lugares de descubrimiento. |
videoPerformanceAd |
Detalles de un anuncio usado en una campaña de acción de video para generar acciones en 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 |
Video de YouTube utilizado por el anuncio |
headline |
Es 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 |
La cantidad de tiempo en milisegundos después de la cual se comenzará a reproducir el video. |
autoplayVideoDuration |
Es el tiempo durante el que se reproduce automáticamente el video. Una duración en segundos con hasta nueve dígitos decimales, que terminan 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 que aparece en la parte superior de una página de YouTube. |
companionYoutubeVideos[] |
Los videos que aparecen junto al anuncio masthead en las computadoras de escritorio. No puede ser 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 |
El motivo por el que los datos de video no están disponibles. |
VideoAspectRatio
Posibles relaciones de aspecto para un video de YouTube.
Enumeraciones | |
---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
No se especifica o es desconocido. |
VIDEO_ASPECT_RATIO_WIDESCREEN |
Se estira el video y se recortan las partes inferior y superior. |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
El video tiene una relación de aspecto fija de 16:9. |
InStreamAd
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 para anuncios in-stream, anuncios que no se pueden omitir y anuncios 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 |
Es la dirección de la URL que se carga en segundo plano con fines de seguimiento. |
actionButtonLabel |
El texto del botón de llamado a la acción. |
actionHeadline |
El título del banner de llamado a la acción. |
video |
El video de YouTube del anuncio. |
companionBanner |
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 ( |
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 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 de 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 |
Es la dirección de la URL que se carga en segundo plano con fines de seguimiento. |
video |
El video de YouTube del anuncio. |
VideoDiscoveryAd
Detalles de 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 del anuncio |
video |
El video de YouTube que promociona el anuncio |
thumbnail |
Imagen en miniatura que se utiliza en el anuncio. |
Miniatura
Posibles opciones de miniaturas en los anuncios video discovery.
Enumeraciones | |
---|---|
THUMBNAIL_UNSPECIFIED |
Desconocido o sin especificar. |
THUMBNAIL_DEFAULT |
La miniatura predeterminada puede generarse automáticamente o subirse por usuarios. |
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 |
Es la dirección de la URL que se carga en segundo plano con fines de seguimiento. |
actionButtonLabels[] |
La lista de recursos de texto que se muestran 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 independientes 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 |
La primera parte después del dominio en la URL visible. |
displayUrlBreadcrumb2 |
La segunda parte después del dominio en la URL visible. |
domain |
Indica el dominio de la URL visible. |
videos[] |
Es la lista de elementos de video de YouTube que se utilizan en 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 que usa este anuncio. |
AdUrl
URL adicionales relacionadas con el anuncio, incluidas las balizas.
Representación JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Es el tipo de URL del anuncio. |
url |
Es el valor de la cadena de URL. |
AdUrlType
Tipos de URL del anuncio posibles.
Enumeraciones | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
Desconocido o sin especificar. |
AD_URL_TYPE_BEACON_IMPRESSION |
Un píxel de seguimiento de 1 x 1 para hacer ping cuando se publica la impresión de una creatividad |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
Pixel contador de impresiones de DCM expandible. Durante 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 de YouTube. |
|
Muestra una lista de los anuncios del grupo de anuncios de YouTube. |