REST Resource: customers.ads

FinalAppUrl

Es una URL para establecer vínculos directos a una aplicación para el sistema operativo determinado.

Representación JSON
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Campos
osType

enum (AppUrlOperatingSystemType)

El sistema operativo al que se orienta esta URL. Obligatorio.

url

string

Es la URL del vínculo directo a la app. Los vínculos directos especifican una ubicación en una aplicación que corresponde al contenido que deseas mostrar y deben tener el formato {scheme}://{host_path}. El esquema identifica la aplicación que se debe abrir. Para tu app, puedes usar un esquema personalizado que comience con el nombre de la app. El host y la ruta de acceso especifican la ubicación única en la app en la que se encuentra tu contenido. Ejemplo: “exampleapp://productid_1234”. Obligatorio.

AppUrlOperatingSystemType

Sistema operativo

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
IOS El sistema operativo iOS de Apple.
ANDROID El sistema operativo Android.

CustomParameter

Una asignación que pueden usar las etiquetas de parámetros personalizados en un trackingUrlTemplate, finalUrls o mobile_final_urls.

Representación JSON
{
  "key": string,
  "value": string
}
Campos
key

string

La clave que coincide con el nombre de la etiqueta del parámetro.

value

string

Valor que se va a sustituir

AdType

Son los tipos posibles de anuncios.

Enumeradores
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

TEXT_AD El anuncio es un anuncio de texto.
EXPANDED_TEXT_AD El anuncio es un anuncio de texto expandido.
EXPANDED_DYNAMIC_SEARCH_AD El anuncio es un anuncio dinámico de búsqueda expandido.
HOTEL_AD El anuncio es un anuncio de hotel.
SHOPPING_SMART_AD El anuncio es un anuncio de Shopping inteligente.
SHOPPING_PRODUCT_AD Se trata de un anuncio de Shopping estándar.
VIDEO_AD El anuncio es un anuncio de video.
IMAGE_AD Este anuncio es un anuncio con imágenes.
RESPONSIVE_SEARCH_AD El anuncio es un anuncio de búsqueda responsivo.
LEGACY_RESPONSIVE_DISPLAY_AD El anuncio es un anuncio de display responsivo heredado.
APP_AD El anuncio es de aplicación.
LEGACY_APP_INSTALL_AD El anuncio es un anuncio heredado de instalación de aplicaciones.
RESPONSIVE_DISPLAY_AD El anuncio es un anuncio de display responsivo.
LOCAL_AD El anuncio es un anuncio local.
HTML5_UPLOAD_AD Este es un anuncio gráfico subido con el tipo de producto HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD El anuncio es un anuncio gráfico subido con uno de los tipos de productos DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD El anuncio es de uso de la aplicación.
SHOPPING_COMPARISON_LISTING_AD Se trata de un anuncio de comparación de productos.
VIDEO_BUMPER_AD Anuncio bumper de video
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Anuncio de video in-stream que no se puede omitir
VIDEO_OUTSTREAM_AD Anuncio outstream de video
VIDEO_TRUEVIEW_IN_STREAM_AD Anuncio de video TrueView in-stream.
VIDEO_RESPONSIVE_AD Anuncio responsivo de video
SMART_CAMPAIGN_AD Anuncio de la campaña inteligente
CALL_AD Anuncio de llamada
APP_PRE_REGISTRATION_AD Anuncio de registro previo de aplicaciones universales
IN_FEED_VIDEO_AD Anuncio de video in-feed.
DISCOVERY_MULTI_ASSET_AD Anuncio discovery con varios elementos.
TRAVEL_AD Anuncio de viajes.
DISCOVERY_VIDEO_RESPONSIVE_AD Es un anuncio responsivo de video discovery.

Dispositivo

Enumera los dispositivos de Google Ads disponibles para la orientación.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
MOBILE Dispositivos móviles con navegadores completos.
TABLET Tablets con navegadores completos
DESKTOP Computadoras
CONNECTED_TV Smart TVs y consolas de juegos.
OTHER Otros tipos de dispositivos.

UrlCollection

Es un grupo de URLs etiquetadas con un identificador único.

Representación JSON
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
Campos
finalUrls[]

string

Una lista de posibles URLs finales

finalMobileUrls[]

string

Una lista de posibles URLs finales para dispositivos móviles

urlCollectionId

string

Identificador único de esta instancia de UrlCollection.

trackingUrlTemplate

string

Plantilla de URL para crear una URL de seguimiento.

SystemManagedResourceSource

Es una enumeración que enumera las posibles fuentes de la entidad administrada por el sistema.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
AD_VARIATIONS Se generó un anuncio del experimento de variaciones del anuncio.

TextAdInfo

Anuncio de texto

Representación JSON
{
  "headline": string,
  "description1": string,
  "description2": string
}
Campos
headline

string

El título del anuncio.

description1

string

La primera línea de la descripción del anuncio.

description2

string

La segunda línea de la descripción del anuncio.

ExpandedTextAdInfo

Un anuncio de texto expandido.

Representación JSON
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
Campos
headlinePart1

string

La primera parte del título del anuncio.

headlinePart2

string

La segunda parte del título del anuncio.

headlinePart3

string

La tercera parte del título del anuncio.

description

string

Es la descripción del anuncio.

description2

string

Es la segunda descripción del anuncio.

path1

string

El texto que puede aparecer al lado de la URL que se muestra del anuncio.

path2

string

Texto adicional que puede aparecer al lado de la URL visible del anuncio.

CallAdInfo

Un anuncio de llamada.

Representación JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
Campos
countryCode

string

Indica el código de país que aparece en el anuncio.

phoneNumber

string

Es el número de teléfono que aparece en el anuncio.

businessName

string

El nombre de la empresa en el anuncio.

headline1

string

Primer título del anuncio.

headline2

string

Segundo título del anuncio.

description1

string

La primera línea de la descripción del anuncio.

description2

string

La segunda línea de la descripción del anuncio.

callTracked

boolean

Indica si se debe habilitar el seguimiento de llamadas para la creatividad. Habilitar el seguimiento de llamadas también habilita las conversiones de llamadas.

disableCallConversion

boolean

Indica si se debe inhabilitar la conversión de llamada para la creatividad. Si se establece en true, se inhabilitan las conversiones de llamadas, incluso cuando callTracked es true. Si callTracked es false, este campo se ignora.

phoneNumberVerificationUrl

string

La URL que se usará para la verificación del número de teléfono.

conversionAction

string

La acción de conversión a la que se atribuye una conversión de llamada. Si no la estableces, se utilizará una acción de conversión predeterminada. Este campo solo tendrá efecto si estableces callTracked como true. De lo contrario, se ignorará este campo.

conversionReportingState

enum (CallConversionReportingState)

El comportamiento de conversión de llamada de este anuncio de llamada. Puede utilizar su propia configuración de conversiones de llamada, heredar la configuración a nivel de la cuenta o inhabilitarse.

path1

string

Primera parte del texto que se puede agregar a la URL del anuncio. Opcional.

path2

string

Es la segunda parte del texto que se puede agregar a la URL del anuncio. Este campo solo se puede configurar si también se configura path1. Opcional.

CallConversionReportingState

Tipos de datos posibles para un estado de acción de conversión de llamada.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
DISABLED La acción de conversión de llamada está inhabilitada.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION La acción de conversión de llamada utilizará el tipo de conversión de llamada establecido a nivel de la cuenta.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION La acción de conversión de llamada utilizará el tipo de conversión de llamada establecido a nivel del recurso (anuncios solo de llamada o extensiones de llamada).

ExpandedDynamicSearchAdInfo

Un anuncio dinámico de búsqueda expandido.

Representación JSON
{
  "description": string,
  "description2": string
}
Campos
description

string

Es la descripción del anuncio.

description2

string

Es la segunda descripción del anuncio.

HotelAdInfo

Este tipo no tiene campos.

Anuncio de hotel

ShoppingSmartAdInfo

Este tipo no tiene campos.

Un anuncio de Shopping inteligente

ShoppingProductAdInfo

Este tipo no tiene campos.

Anuncio de Shopping estándar

ImageAdInfo

Un anuncio con imagen.

Representación JSON
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
Campos
mimeType

enum (MimeType)

Es el tipo MIME de la imagen.

pixelWidth

string (int64 format)

Indica el ancho en píxeles de la imagen en tamaño completo.

pixelHeight

string (int64 format)

Es la altura en píxeles de la imagen en tamaño completo.

imageUrl

string

URL de la imagen en tamaño completo.

previewPixelWidth

string (int64 format)

Es el ancho en píxeles de la imagen del tamaño de la vista previa.

previewPixelHeight

string (int64 format)

Es la altura en píxeles de la imagen del tamaño de la vista previa.

previewImageUrl

string

URL de la imagen en tamaño de vista previa.

name

string

Es el nombre de la imagen. Si la imagen se creó a partir de un MediaFile, este es el nombre de ese MediaFile. Si la imagen se creó a partir de bytes, este campo está vacío.

Campo de unión image. La imagen a partir de la cual se creará el anuncio con imagen. Esto se puede especificar en una de dos maneras. 1. Un recurso MediaFile existente 2. Los datos de imágenes sin procesar como bytes Las direcciones (image) solo pueden ser una de las siguientes opciones:
mediaFile

string

El recurso MediaFile que se usará para la imagen.

data

string (bytes format)

Datos de imágenes sin procesar como bytes.

String codificada en base64.

adIdToCopyImageFrom

string (int64 format)

Un ID de anuncio del que se copiará la imagen.

MimeType

El tipo de MIME

Enumeradores
UNSPECIFIED No se especificó el tipo de MIME.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

IMAGE_JPEG Es el tipo MIME de imagen/jpeg.
IMAGE_GIF Es el tipo MIME de imagen o GIF.
IMAGE_PNG Es el tipo MIME de imagen/png.
FLASH Es el tipo MIME de application/x-shockwave-flash.
TEXT_HTML Es el tipo MIME de text/html.
PDF Tipo MIME de application/pdf.
MSWORD Tipo MIME de aplicación/palabra clave.
MSEXCEL Es el tipo de MIME application/vnd.ms-excel.
RTF Es el tipo de MIME de aplicación/rtf.
AUDIO_WAV Es el tipo MIME de audio/wav.
AUDIO_MP3 Es el tipo MIME de audio/mp3.
HTML5_AD_ZIP Es el tipo de MIME application/x-html5-ad-zip.

VideoAdInfo

Un anuncio de video

Representación JSON
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
Campos
video

object (AdVideoAsset)

Los elementos de video de YouTube que se utilizan para el anuncio.

Campo de unión format. Esquema específico para los diferentes formatos de video. Las direcciones (format) solo pueden ser una de las siguientes opciones:
inStream

object (VideoTrueViewInStreamAdInfo)

Formato de anuncio TrueView in-stream de video

bumper

object (VideoBumperInStreamAdInfo)

Formato de anuncio bumper de video in-stream.

outStream

object (VideoOutstreamAdInfo)

Formato de anuncio de video out-stream.

nonSkippable

object (VideoNonSkippableInStreamAdInfo)

Formato del anuncio de video in-stream que no se puede omitir

inFeed

object (InFeedVideoAdInfo)

Es un formato de anuncio de video in-feed.

AdVideoAsset

Es un recurso de video que se utiliza dentro de un anuncio.

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

string

El nombre del recurso del elemento de este video.

VideoTrueViewInStreamAdInfo

Representación del formato de anuncio TrueView in-stream de video (anuncio que se muestra durante la reproducción del video, a menudo al principio, que muestra un botón de omitir unos segundos después de mirar el video).

Representación JSON
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
Campos
actionButtonLabel

string

Etiqueta en el botón de CTA (llamado a la acción) que dirige al usuario a la URL final del anuncio de video. Obligatorio para las campañas TrueView for Action; de lo contrario, es opcional.

actionHeadline

string

Texto adicional que se muestra con el botón de CTA (llamado a la acción) para brindar contexto y alentar a los usuarios a hacer clic en el botón.

companionBanner

object (AdImageAsset)

Los recursos de imagen del banner complementario que se usa con el anuncio

AdImageAsset

Un recurso de imagen que se utiliza dentro de un anuncio.

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

string

El nombre del recurso del elemento de esta imagen.

VideoBumperInStreamAdInfo

Representación del formato del anuncio bumper de video in-stream (anuncio de video in-stream muy breve que no se puede omitir)

Representación JSON
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Campos
companionBanner

object (AdImageAsset)

Los recursos de imagen del banner complementario que se usa con el anuncio

actionButtonLabel

string

Etiqueta en el botón "Llamado a la acción" que dirige al usuario a la URL final del anuncio de video.

actionHeadline

string

Texto adicional que se muestra con el botón de CTA (llamado a la acción) para brindar contexto y alentar a los usuarios a hacer clic en el botón.

VideoOutstreamAdInfo

Representación del formato de anuncio out-stream de video (anuncios que se muestran junto a un feed con reproducción automática, sin sonido).

Representación JSON
{
  "headline": string,
  "description": string
}
Campos
headline

string

El título del anuncio.

description

string

La línea descriptiva

VideoNonSkippableInStreamAdInfo

Representación del formato de anuncio in-stream que no se puede omitir (anuncio de video in-stream de 15 segundos que no se puede omitir)

Representación JSON
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Campos
companionBanner

object (AdImageAsset)

Los recursos de imagen del banner complementario que se usa con el anuncio

actionButtonLabel

string

Etiqueta en el botón "Llamado a la acción" que dirige al usuario a la URL final del anuncio de video.

actionHeadline

string

Texto adicional que se muestra con el botón "Llamado a la acción" para brindar contexto y alentar a los usuarios a hacer clic en el botón.

InFeedVideoAdInfo

Representación del formato de anuncios de video in-feed.

Representación JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
Campos
headline

string

El título del anuncio.

description1

string

Primera línea de texto para el anuncio.

description2

string

Segunda línea de texto para el anuncio

thumbnail

enum (VideoThumbnail)

Imagen de miniatura del video para usar.

VideoThumbnail

Es una enumeración que enumera los tipos posibles de una miniatura de video.

Enumeradores
UNSPECIFIED No se especificó el tipo.
UNKNOWN El valor recibido no se conoce en esta versión. Este es un valor de solo respuesta.
DEFAULT_THUMBNAIL Miniatura predeterminada. Se pueden 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.

VideoResponsiveAdInfo

Anuncio responsivo de video

Representación JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
Campos
headlines[]

object (AdTextAsset)

Es la lista de recursos de texto utilizados para el título corto. Actualmente, solo se admite un valor para el título corto.

longHeadlines[]

object (AdTextAsset)

Es la lista de recursos de texto utilizados para el título largo. Actualmente, solo se admite un valor para el título largo.

descriptions[]

object (AdTextAsset)

Es la lista de recursos de texto usados para la descripción. Actualmente, solo se admite un valor para la descripción.

callToActions[]

object (AdTextAsset)

Es una lista de recursos de texto utilizados para el botón, por ejemplo, el botón "Llamado a la acción". Actualmente, solo se admite un valor para el botón.

videos[]

object (AdVideoAsset)

Es la lista de elementos de video de YouTube que se usan en el anuncio. Actualmente, solo se admite un valor para el elemento de video de YouTube.

companionBanners[]

object (AdImageAsset)

Lista de recursos de imagen utilizados para el banner complementario. Actualmente, solo se admite un único valor para el elemento del banner complementario.

breadcrumb1

string

Es la primera parte del texto que aparece en el anuncio con la URL que se muestra.

breadcrumb2

string

La segunda parte del texto que aparece en el anuncio con la URL que se muestra.

AdTextAsset

Es un recurso de texto que se utiliza dentro de un anuncio.

Representación JSON
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
Campos
pinnedField

enum (ServedAssetFieldType)

El campo fijado del recurso. Esto restringe el recurso para que solo se publique en este campo. Se pueden fijar varios recursos en el mismo campo. Los elementos que no estén fijados o que estén fijados en un campo diferente no se publicarán en los campos en los que se fijó otro elemento.

assetPerformanceLabel

enum (AssetPerformanceLabel)

La etiqueta de rendimiento de este recurso de texto.

policySummaryInfo

object (AdAssetPolicySummary)

El resumen de la política de este recurso de texto.

text

string

Texto del recurso

ServedAssetFieldType

Los posibles tipos de campos de recursos.

Enumeradores
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

HEADLINE_1 El recurso se utiliza en el título 1.
HEADLINE_2 El recurso se utiliza en el título 2.
HEADLINE_3 El recurso se utiliza en el título 3.
DESCRIPTION_1 El recurso se utiliza en la descripción 1.
DESCRIPTION_2 El recurso se utiliza en la descripción 2.
CALL Este recurso se usa como llamada.
MOBILE_APP Este recurso se usa como una aplicación para dispositivos móviles.
CALLOUT Este recurso se usa como texto destacado.
STRUCTURED_SNIPPET Este recurso se usa como fragmento estructurado.
PRICE Este recurso se usa como precio.
PROMOTION Este recurso se usa como promoción.
AD_IMAGE Este recurso se usa como imagen.
LEAD_FORM El recurso se utiliza como un formulario de clientes potenciales.

AssetPerformanceLabel

Es una enumeración que describe las posibles etiquetas de rendimiento de un activo, que por lo general se calcula en el contexto de una vinculación.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
PENDING Este recurso aún no tiene ninguna información de rendimiento. Esto puede deberse a que aún está en proceso de revisión.
LEARNING El recurso comenzó a obtener impresiones, pero las estadísticas no tienen importancia estadística para obtener una etiqueta de rendimiento del recurso.
LOW Recursos con el peor rendimiento.
GOOD Recursos con buen rendimiento.
BEST Recursos con el mejor rendimiento

AdAssetPolicySummary

Contiene información sobre las políticas de un recurso dentro de un anuncio.

Representación JSON
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Campos
policyTopicEntries[]

object (PolicyTopicEntry)

La lista de resultados de políticas para este recurso.

reviewStatus

enum (PolicyReviewStatus)

El lugar del proceso de revisión en el que se encuentra este recurso.

approvalStatus

enum (PolicyApprovalStatus)

El estado de aprobación general de este recurso, que se calcula en función del estado de sus entradas individuales de temas de políticas.

PolicyTopicEntry

Hallazgo de política adjunta a un recurso (por ejemplo, política sobre bebidas alcohólicas asociada a un sitio que vende bebidas alcohólicas)

Cada PolicyTopicEntry tiene un tema que indica la política de anuncios específica relacionada con la entrada y un tipo que indica el efecto que la entrada tendrá en la publicación. Opcionalmente, puede tener una o más evidencias que indiquen el motivo del hallazgo. De manera opcional, también puede tener una o más restricciones que proporcionen detalles sobre cómo se puede restringir la entrega.

Representación JSON
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
Campos
type

enum (PolicyTopicEntryType)

Describe el efecto negativo o positivo que esta política tendrá en la publicación.

evidences[]

object (PolicyTopicEvidence)

Incluye información adicional en la que se explica la resolución de políticas (por ejemplo, el nombre de la marca de un hallazgo de marca).

constraints[]

object (PolicyTopicConstraint)

Indica cómo se puede ver afectada la entrega de este recurso (por ejemplo, que no se publique en un país).

topic

string

Tema de la política al que se refiere este resultado. Por ejemplo, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT" o "DESTINATION_NOT_WORKING". El conjunto de temas de políticas posibles no es fijo para una versión de API específica y puede cambiar en cualquier momento.

PolicyTopicEntryType

Los posibles tipos de entrada de temas de políticas.

Enumeradores
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

PROHIBITED No se entregará el recurso.
LIMITED No se entregará el recurso en algunas circunstancias.
FULLY_LIMITED El recurso no puede publicarse debido a los criterios de segmentación actuales.
DESCRIPTIVE Puede resultar interesante, pero no limita la forma en que se entrega el recurso.
BROADENING Podría aumentar la cobertura más de lo normal.
AREA_OF_INTEREST_ONLY Está restringida para todos los países de segmentación, pero puede publicar anuncios en otros países según sus áreas de interés.

PolicyTopicEvidence

Información adicional en la que se explica un hallazgo de política.

Representación JSON
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
Campos
Campo de unión value. Información de evidencia específica según el tipo de evidencia. Las direcciones (value) solo pueden ser una de las siguientes opciones:
websiteList

object (WebsiteList)

Lista de sitios web vinculados con este recurso.

textList

object (TextList)

Lista de evidencia encontrada en el texto de un recurso.

languageCode

string

El idioma en el que se detectó que se escribió el recurso. Esta es una etiqueta de idioma IETF, como "en-US".

destinationTextList

object (DestinationTextList)

El texto en el destino del recurso que genera un resultado de política.

destinationMismatch

object (DestinationMismatch)

Los destinos de las URLs de un recurso no coinciden.

destinationNotWorking

object (DestinationNotWorking)

Detalles cuando el destino muestra un código de error de HTTP o no funciona en todas las ubicaciones para los dispositivos de uso general.

WebsiteList

Una lista de sitios web que generaron un hallazgo de política. Se usa, por ejemplo, para el tema de la política ONE_WEBSITE_PER_AD_GROUP. En caso de que haya más de cinco sitios web, solo los cinco principales (los que aparecen más en los recursos) se mostrarán aquí.

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

string

Sitios web que causaron el hallazgo de la política.

TextList

Una lista de fragmentos de texto que infringieron una política.

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

string

Los fragmentos de texto del recurso que causaron el resultado de la política.

DestinationTextList

Una lista de cadenas encontradas en una página de destino que generaron un resultado de política.

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

string

Lista de texto que se encuentra en la página de destino del recurso.

DestinationMismatch

Evidencia de discrepancias entre las URLs de un recurso.

Representación JSON
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Campos
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

Es el conjunto de URLs que no coincidían entre sí.

PolicyTopicEvidenceDestinationMismatchUrlType

Los posibles tipos de URLs de destino de la evidencia del tema de la política no coinciden.

Enumeradores
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

DISPLAY_URL Es la URL visible.
FINAL_URL La URL final.
FINAL_MOBILE_URL La URL final para dispositivos móviles.
TRACKING_URL La plantilla de URL de seguimiento, con la URL de escritorio sustituida
MOBILE_TRACKING_URL La plantilla de URL de seguimiento, con la URL para dispositivos móviles sustituida

DestinationNotWorking

Detalles de la evidencia cuando el destino muestra un código de error de HTTP o no funciona en todas las ubicaciones para los dispositivos de uso general.

Representación JSON
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
Campos
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

Es el tipo de dispositivo que no pudo cargar la URL.

expandedUrl

string

La URL completa que no funcionó.

lastCheckedDateTime

string

La hora en la que se verificó la URL por última vez. El formato es “AAAA-MM-DD HH:MM:SS”. Ejemplos: “2018-03-05 09:15:00” o “2018-02-01 14:34:30”

Campo de unión reason. Indica el motivo del resultado de la política DESTINATION_NOT_WORKING. Las direcciones (reason) solo pueden ser una de las siguientes opciones:
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

El tipo de error de DNS.

httpErrorCode

string (int64 format)

El código de error de HTTP.

PolicyTopicEvidenceDestinationNotWorkingDevice

El posible destino de evidencia de tema de política no funciona.

Enumeradores
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

DESKTOP La página de destino no funciona en un dispositivo de escritorio.
ANDROID La página de destino no funciona en un dispositivo Android.
IOS La página de destino no funciona en un dispositivo iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

El destino posible de la evidencia del tema de la política no funciona con los tipos de errores de DNS.

Enumeradores
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

HOSTNAME_NOT_FOUND No se encontró el nombre de host en el DNS al recuperar la página de destino.
GOOGLE_CRAWLER_DNS_ISSUE Se produjo un error del rastreador interno de Google durante la comunicación con el DNS. Este error no significa que la página de destino no funciona. Google volverá a rastrear la página de destino.

PolicyTopicConstraint

Describe el efecto que tendrá una entrada de tema de política en la publicación.

Representación JSON
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
Campos
Campo de unión value. Información específica sobre la restricción. Las direcciones (value) solo pueden ser una de las siguientes opciones:
countryConstraintList

object (CountryConstraintList)

Países en los que no se puede publicar el recurso.

resellerConstraint

object (ResellerConstraint)

Restricción del revendedor.

certificateMissingInCountryList

object (CountryConstraintList)

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

certificateDomainMismatchInCountryList

object (CountryConstraintList)

Países en los que el dominio del recurso no está cubierto por los certificados asociados a él.

CountryConstraintList

Una lista de países en los que la publicación de un recurso está restringida.

Representación JSON
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
Campos
countries[]

object (CountryConstraint)

Países en los que se restringe la publicación.

totalTargetedCountries

integer

Cantidad total de países a los que se orienta el recurso.

CountryConstraint

Indica que se limita la capacidad de un recurso para publicar anuncios en un país en particular.

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

string

Nombre del recurso constante de segmentación geográfica del país en el que se restringe la publicación.

ResellerConstraint

Este tipo no tiene campos.

Indica que un tema de la política se restringió debido al rechazo del sitio web por motivos de revendedor.

PolicyReviewStatus

Estos son los posibles estados de revisión de cumplimiento de las políticas.

Enumeradores
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

REVIEW_IN_PROGRESS En proceso de revisión.
REVIEWED Se completó la revisión principal. Es posible que otras revisiones continúen.
UNDER_APPEAL El recurso se volvió a enviar para su aprobación o se apeló la decisión sobre la política.
ELIGIBLE_MAY_SERVE El recurso es apto y es posible que se esté publicando, pero aún podría someterse a una revisión más detallada.

PolicyApprovalStatus

Estos son los posibles estados de aprobación de la política. Cuando haya varios estados de aprobación disponibles, se usará el más grave. El orden de gravedad es DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED y APPROVED.

Enumeradores
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

DISAPPROVED No se publicará.
APPROVED_LIMITED Se publica con restricciones.
APPROVED Se publica sin restricciones.
AREA_OF_INTEREST_ONLY No se publicarán en los países de segmentación, pero es posible que se muestren a los usuarios que buscan información sobre esos países.

ResponsiveSearchAdInfo

Anuncio de búsqueda responsivo

Los anuncios de búsqueda responsivos te permiten crear anuncios que se adaptan para mostrar más texto y mensajes más relevantes a tus clientes. Ingrese varios títulos y descripciones cuando cree un anuncio de búsqueda responsivo y, con el tiempo, Google Ads irá probando automáticamente distintas combinaciones para saber cuáles de ellas tienen el mejor rendimiento. Adaptando el contenido de tu anuncio para que coincida mejor con los términos de búsqueda de los clientes potenciales, los anuncios de búsqueda responsivos pueden mejorar el rendimiento de tu campaña.

Más información en https://support.google.com/google-ads/answer/7684791

Representación JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Cuando se publique el anuncio, los títulos se seleccionarán de esta lista.

descriptions[]

object (AdTextAsset)

Lista de recursos de texto para las descripciones. Cuando se publique el anuncio, las descripciones se seleccionarán de esta lista.

path1

string

Primera parte del texto que se puede agregar a la URL del anuncio.

path2

string

Es la segunda parte del texto que se puede agregar a la URL del anuncio. Este campo solo se puede configurar si también se configura path1.

LegacyResponsiveDisplayAdInfo

Anuncio de display responsivo heredado Los anuncios de este tipo se etiquetan como "Anuncios responsivos" en la IU de Google Ads.

Representación JSON
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
Campos
formatSetting

enum (DisplayAdFormatSetting)

Especifica en qué formato se publicará el anuncio. El valor predeterminado es ALL_FORMATS.

shortHeadline

string

La versión breve del título del anuncio.

longHeadline

string

La versión larga del título del anuncio.

description

string

Es la descripción del anuncio.

businessName

string

El nombre de la empresa en el anuncio.

allowFlexibleColor

boolean

Consentimiento del anunciante para permitir colores flexibles. Cuando el valor es verdadero, el anuncio se puede publicar con un color diferente si es necesario. Si es falso, el anuncio se publicará con los colores especificados o con un color neutro. El valor predeterminado es true. Debe ser verdadero si no se configuran mainColor ni accentColor.

accentColor

string

El color de los elementos destacados del anuncio en formato hexadecimal; por ejemplo, #ffffff para el blanco. Si se configura uno de mainColor o accentColor, el otro también es obligatorio.

mainColor

string

El color principal del anuncio en formato hexadecimal; por ejemplo, #ffffff para blanco. Si se configura uno de mainColor o accentColor, el otro también es obligatorio.

callToActionText

string

Es el texto del llamado a la acción del anuncio.

logoImage

string

Es el nombre del recurso MediaFile de la imagen del logotipo que se usa en el anuncio.

squareLogoImage

string

Es el nombre del recurso de MediaFile de la imagen del logotipo cuadrado que se usa en el anuncio.

marketingImage

string

Es el nombre del recurso MediaFile de la imagen de marketing que se usa en el anuncio.

squareMarketingImage

string

Es el nombre del recurso MediaFile de la imagen de marketing cuadrada que se usa en el anuncio.

pricePrefix

string

Prefijo antes del precio. Por ejemplo, "tan bajo como".

promoText

string

Texto promocional que se utiliza para los formatos dinámicos de anuncios responsivos. Por ejemplo, "Envío gratuito en dos días".

DisplayAdFormatSetting

Indica la configuración de formato de anuncio gráfico.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
ALL_FORMATS Formatos nativos, de texto y de imagen
NON_NATIVE Formatos de texto y de imagen
NATIVE El formato nativo, por ejemplo, es el publicador y no Google controla el procesamiento del formato.

AppAdInfo

Un anuncio de aplicación.

Representación JSON
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
Campos
mandatoryAdText

object (AdTextAsset)

Texto del anuncio obligatorio.

headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Cuando se publique el anuncio, los títulos se seleccionarán de esta lista.

descriptions[]

object (AdTextAsset)

Lista de recursos de texto para las descripciones. Cuando se publique el anuncio, las descripciones se seleccionarán de esta lista.

images[]

object (AdImageAsset)

Lista de recursos de imagen que pueden mostrarse con el anuncio.

youtubeVideos[]

object (AdVideoAsset)

Es la lista de elementos de video de YouTube que se pueden mostrar con el anuncio.

html5MediaBundles[]

object (AdMediaBundleAsset)

Es la lista de elementos de paquetes de medios que se pueden usar con el anuncio.

AdMediaBundleAsset

Es un recurso de paquete de medios utilizado dentro de un anuncio.

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

string

Es el nombre del recurso Asset de este paquete de medios.

LegacyAppInstallAdInfo

Es un anuncio heredado de instalación de aplicaciones que solo unos pocos clientes pueden utilizar.

Representación JSON
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
Campos
appStore

enum (LegacyAppInstallAdAppStore)

La tienda de aplicaciones en la que está disponible la aplicación para dispositivos móviles.

appId

string

Es el ID de la app para dispositivos móviles.

headline

string

El título del anuncio.

description1

string

La primera línea descriptiva del anuncio.

description2

string

Es la segunda línea descriptiva del anuncio.

LegacyAppInstallAdAppStore

Tipo de tienda de aplicaciones en un anuncio de instalación de aplicación heredado.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
APPLE_APP_STORE iTunes de Apple
GOOGLE_PLAY Mediante el uso de Google Play
WINDOWS_STORE Tienda Windows.
WINDOWS_PHONE_STORE Tienda Windows Phone.
CN_APP_STORE La aplicación está alojada en una tienda de aplicaciones china.

ResponsiveDisplayAdInfo

Anuncio de display responsivo

Representación JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
Campos
marketingImages[]

object (AdImageAsset)

Imágenes de marketing que se usarán en el anuncio. Los tipos de imagen válidos son GIF, JPEG y PNG. El tamaño mínimo es de 600 x 314 y la relación de aspecto debe ser de 1.91:1 (+-1%). Se requiere al menos un marketingImage. Si se combina con squareMarketingImages, el máximo es 15.

squareMarketingImages[]

object (AdImageAsset)

Imágenes de marketing cuadradas para usar en el anuncio Los tipos de imagen válidos son GIF, JPEG y PNG. El tamaño mínimo es de 300 x 300 y la relación de aspecto debe ser de 1:1 (+-1%). Se requiere al menos un cuadrado marketingImage. Si se combina con marketingImages, el máximo es 15.

logoImages[]

object (AdImageAsset)

Imágenes del logotipo que se utilizarán en el anuncio. Los tipos de imagen válidos son GIF, JPEG y PNG. El tamaño mínimo es de 512 x 128 y la relación de aspecto debe ser de 4:1 (+-1%). Si se combina con squareLogoImages, la cantidad máxima es de 5.

squareLogoImages[]

object (AdImageAsset)

Imágenes del logotipo cuadrado que se usarán en el anuncio Los tipos de imagen válidos son GIF, JPEG y PNG. El tamaño mínimo es de 128 x 128 y la relación de aspecto debe ser de 1:1 (+-1%). Si se combina con logoImages, la cantidad máxima es de 5.

headlines[]

object (AdTextAsset)

Títulos de formato corto para el anuncio La longitud máxima es de 30 caracteres. Se pueden especificar, al menos, 1 título y 5 como máximo.

longHeadline

object (AdTextAsset)

Debe incluir un título de formato largo obligatorio. La longitud máxima es de 90 caracteres.

descriptions[]

object (AdTextAsset)

Textos descriptivos para el anuncio La longitud máxima es de 90 caracteres. Se pueden especificar, al menos, 1 título y 5 como máximo.

youtubeVideos[]

object (AdVideoAsset)

Videos de YouTube opcionales para el anuncio. Se pueden especificar 5 videos como máximo.

formatSetting

enum (DisplayAdFormatSetting)

Especifica en qué formato se publicará el anuncio. El valor predeterminado es ALL_FORMATS.

controlSpec

object (ResponsiveDisplayAdControlSpec)

Especificación para varios controles de creatividades.

businessName

string

Es el nombre de la marca o el anunciante. El ancho máximo de la pantalla es 25.

mainColor

string

El color principal del anuncio en formato hexadecimal; por ejemplo, #ffffff para blanco. Si se configura uno de mainColor o accentColor, el otro también es obligatorio.

accentColor

string

El color de los elementos destacados del anuncio en formato hexadecimal; por ejemplo, #ffffff para el blanco. Si se configura uno de mainColor o accentColor, el otro también es obligatorio.

allowFlexibleColor

boolean

Consentimiento del anunciante para permitir colores flexibles. Cuando el valor es verdadero, el anuncio se puede publicar con un color diferente si es necesario. Si es falso, el anuncio se publicará con los colores especificados o con un color neutro. El valor predeterminado es true. Debe ser verdadero si no se configuran mainColor ni accentColor.

callToActionText

string

Es el texto del llamado a la acción del anuncio. El ancho máximo de la pantalla es 30.

pricePrefix

string

Prefijo antes del precio. Por ejemplo, "tan bajo como".

promoText

string

Texto promocional que se utiliza para los formatos dinámicos de anuncios responsivos. Por ejemplo, "Envío gratuito en dos días".

ResponsiveDisplayAdControlSpec

Especificaciones sobre varios controles de creatividades para los anuncios de display responsivos.

Representación JSON
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
Campos
enableAssetEnhancements

boolean

Si el anunciante habilitó la función de mejoras de los recursos

enableAutogenVideo

boolean

Si el anunciante habilitó la función de videos generados automáticamente

LocalAdInfo

Un anuncio local

Representación JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Cuando se publique el anuncio, los títulos se seleccionarán de esta lista. Se debe especificar 1 título como mínimo y 5 como máximo.

descriptions[]

object (AdTextAsset)

Lista de recursos de texto para las descripciones. Cuando se publique el anuncio, las descripciones se seleccionarán de esta lista. Se debe especificar 1 como mínimo y 5 como máximo.

callToActions[]

object (AdTextAsset)

Lista de recursos de texto para llamados a la acción. Cuando se publique el anuncio, los llamados a la acción se seleccionarán de esta lista. Se deben especificar 1 y un máximo de 5 llamados a la acción.

marketingImages[]

object (AdImageAsset)

Lista de recursos de imagen de marketing que se pueden mostrar con el anuncio. Las imágenes deben ser de 314 x 600 píxeles o 320 x 320 píxeles. Se deben especificar al menos 1 y un máximo de 20 recursos de imagen.

logoImages[]

object (AdImageAsset)

Lista de recursos de imagen del logotipo que pueden mostrarse con el anuncio. Las imágenes deben tener un tamaño de 128 × 128 píxeles y no deben pesar más de 120 KB. Se deben especificar 1 recurso de imagen como mínimo y 5 como máximo.

videos[]

object (AdVideoAsset)

Es la lista de elementos de video de YouTube que se pueden mostrar con el anuncio. Se deben especificar 1 elemento de video como mínimo y 20 elementos como máximo.

path1

string

Primera parte del texto opcional que se puede agregar a la URL del anuncio.

path2

string

Es la segunda parte del texto opcional que se puede agregar a la URL del anuncio. Este campo solo se puede configurar si también se configura path1.

DisplayUploadAdInfo

Es un tipo genérico de anuncio gráfico. El campo displayUploadProductType controla el formato exacto del anuncio, que determina qué tipos de datos se deben incluir en el anuncio.

Representación JSON
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
Campos
displayUploadProductType

enum (DisplayUploadProductType)

El tipo de producto de este anuncio. Consulta los comentarios de la enumeración para obtener más detalles.

Campo de unión media_asset. Los datos de los recursos que conforman el anuncio. Las direcciones (media_asset) solo pueden ser una de las siguientes opciones:
mediaBundle

object (AdMediaBundleAsset)

Es un recurso de paquete de medios que se utilizará en el anuncio. Para obtener información sobre el paquete de medios para HTML5_UPLOAD_AD, consulta https://support.google.com/google-ads/answer/1722096. Los paquetes de medios que forman parte de tipos de productos dinámicos usan un formato especial que se debe crear mediante Google Web Designer. Para obtener más información, consulta https://support.google.com/webdesigner/answer/7543898.

DisplayUploadProductType

Enumera los tipos de productos de carga de anuncios gráficos.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
HTML5_UPLOAD_AD Anuncio subido HTML5 Este tipo de producto requiere que se configure el campo upload_media_bundle en DisplayUploadAdInfo.
DYNAMIC_HTML5_EDUCATION_AD Anuncio HTML5 dinámico para la educación. Este tipo de producto requiere que se configure el campo upload_media_bundle en DisplayUploadAdInfo. Solo se puede usar en una campaña educativa.
DYNAMIC_HTML5_FLIGHT_AD Anuncio de vuelo HTML5 dinámico Este tipo de producto requiere que se configure el campo upload_media_bundle en DisplayUploadAdInfo. Solo se puede utilizar en una campaña de período de publicación.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Anuncio HTML5 dinámico de hoteles y alquileres. Este tipo de producto requiere que se configure el campo upload_media_bundle en DisplayUploadAdInfo. Solo se pueden usar en una campaña de hotel.
DYNAMIC_HTML5_JOB_AD Es un anuncio de empleo HTML5 dinámico. Este tipo de producto requiere que se configure el campo upload_media_bundle en DisplayUploadAdInfo. Solo se puede usar en una campaña de empleo.
DYNAMIC_HTML5_LOCAL_AD Anuncio local HTML5 dinámico. Este tipo de producto requiere que se configure el campo upload_media_bundle en DisplayUploadAdInfo. Solo se pueden usar en una campaña local.
DYNAMIC_HTML5_REAL_ESTATE_AD Es un anuncio de bienes raíces HTML5 dinámico. Este tipo de producto requiere que se configure el campo upload_media_bundle en DisplayUploadAdInfo. Solo se puede usar en una campaña de bienes raíces.
DYNAMIC_HTML5_CUSTOM_AD Anuncio personalizado HTML5 dinámico Este tipo de producto requiere que se configure el campo upload_media_bundle en DisplayUploadAdInfo. Solo se pueden usar en una campaña personalizada.
DYNAMIC_HTML5_TRAVEL_AD Es un anuncio de viajes HTML5 dinámico. Este tipo de producto requiere que se configure el campo upload_media_bundle en DisplayUploadAdInfo. Solo se puede usar en una campaña de viajes.
DYNAMIC_HTML5_HOTEL_AD Anuncio de hotel HTML5 dinámico Este tipo de producto requiere que se configure el campo upload_media_bundle en DisplayUploadAdInfo. Solo se pueden usar en una campaña de hotel.

AppEngagementAdInfo

Los anuncios de participación en la aplicación le permiten redactar textos para alentar una acción específica en la aplicación, como registrarse, realizar una compra o reservar un vuelo. Te permiten enviar a los usuarios a una parte específica de la aplicación donde podrán encontrar lo que buscan de manera más fácil y rápida.

Representación JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Cuando se publique el anuncio, los títulos se seleccionarán de esta lista.

descriptions[]

object (AdTextAsset)

Lista de recursos de texto para las descripciones. Cuando se publique el anuncio, las descripciones se seleccionarán de esta lista.

images[]

object (AdImageAsset)

Lista de recursos de imagen que pueden mostrarse con el anuncio.

videos[]

object (AdVideoAsset)

Es la lista de elementos de video que pueden mostrarse con el anuncio.

ShoppingComparisonListingAdInfo

Un anuncio de comparación de productos

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

string

Es el título del anuncio. Este campo es obligatorio. La longitud permitida es de 25 a 45 caracteres.

SmartCampaignAdInfo

Un anuncio de la campaña inteligente

Representación JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto, cada uno de los cuales corresponde a un título cuando se publica el anuncio. Esta lista consta de un mínimo de 3 recursos de texto y hasta 15.

descriptions[]

object (AdTextAsset)

Lista de recursos de texto, cada uno de los cuales corresponde a una descripción cuando se publica el anuncio. Esta lista consta de un mínimo de 2 recursos y hasta 4 recursos de texto.

AppPreRegistrationAdInfo

Los anuncios de aplicación de registro previo se vinculan a su ficha de aplicación o juego en Google Play y pueden publicarse en Google Play, YouTube (solo anuncios in-stream) y otras aplicaciones y sitios web móviles en la Red de Display. Ayudará a captar el interés de las personas en tu app o juego y generará una base de instalaciones inicial antes del lanzamiento.

Representación JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Campos
headlines[]

object (AdTextAsset)

Lista de recursos de texto para títulos. Cuando se publique el anuncio, los títulos se seleccionarán de esta lista.

descriptions[]

object (AdTextAsset)

Lista de recursos de texto para las descripciones. Cuando se publique el anuncio, las descripciones se seleccionarán de esta lista.

images[]

object (AdImageAsset)

Es la lista de ID de recursos de imagen cuyas imágenes se pueden mostrar con el anuncio.

youtubeVideos[]

object (AdVideoAsset)

Es la lista de ID de activos de video de YouTube cuyos videos se pueden mostrar con el anuncio.

DiscoveryMultiAssetAdInfo

Es un anuncio discovery con varios elementos.

Representación JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
Campos
marketingImages[]

object (AdImageAsset)

Los recursos de imagen de marketing que se utilizarán en el anuncio. Los tipos de imagen válidos son GIF, JPEG y PNG. El tamaño mínimo es de 600 x 314 y la relación de aspecto debe ser de 1.91:1 (+-1%). Obligatorio si la imagen SquareMarketingImages no está presente. Si se combina con squareMarketingImages y portraitMarketingImages, el máximo es 20.

squareMarketingImages[]

object (AdImageAsset)

Recursos de imagen de marketing cuadrados que se usarán en el anuncio. Los tipos de imagen válidos son GIF, JPEG y PNG. El tamaño mínimo es de 300 x 300 y la relación de aspecto debe ser de 1:1 (+-1%). Obligatorio si marketingImages no está presente. Si se combina con marketingImages y portraitMarketingImages, el máximo es 20.

portraitMarketingImages[]

object (AdImageAsset)

Recursos de imagen de marketing vertical que se usarán en el anuncio Los tipos de imagen válidos son GIF, JPEG y PNG. El tamaño mínimo es 480 x 600 y la relación de aspecto debe ser de 4:5 (+-1%). Si se combina con marketingImages y squareMarketingImages, el máximo es 20.

logoImages[]

object (AdImageAsset)

Los recursos de imagen del logotipo que se utilizarán en el anuncio. Los tipos de imagen válidos son GIF, JPEG y PNG. El tamaño mínimo es de 128 x 128 y la relación de aspecto debe ser de 1:1 (+-1%). Se pueden especificar, al menos, 1 y 5 imágenes de logotipo.

headlines[]

object (AdTextAsset)

Recurso de texto del título del anuncio. El ancho máximo de la pantalla es 30. Se pueden especificar, al menos, 1 título y 5 como máximo.

descriptions[]

object (AdTextAsset)

Es el texto descriptivo del anuncio. El ancho máximo de la pantalla es 90. Se puede especificar entre 1 y 5 descripciones, como mínimo.

businessName

string

Es el nombre de la marca o el anunciante. El ancho máximo de la pantalla es 25. Obligatorio.

callToActionText

string

Texto del llamado a la acción.

leadFormOnly

boolean

Es una opción booleana que indica si este anuncio se debe publicar con un formulario de clientes potenciales.

DiscoveryCarouselAdInfo

Anuncio de carrusel discovery

Representación JSON
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
Campos
businessName

string

Obligatorio. Es el nombre de la marca o el anunciante.

logoImage

object (AdImageAsset)

Obligatorio. Imagen del logotipo que se utilizará en el anuncio. El tamaño mínimo es de 128 x 128 y la relación de aspecto debe ser de 1:1 (+-1%).

headline

object (AdTextAsset)

Obligatorio. Es el título del anuncio.

description

object (AdTextAsset)

Obligatorio. Es el texto descriptivo del anuncio.

callToActionText

string

Texto del llamado a la acción.

carouselCards[]

object (AdDiscoveryCarouselCardAsset)

Obligatorio. Tarjetas del carrusel que se mostrarán con el anuncio Mín. 2 máx. 10.

AdDiscoveryCarouselCardAsset

Un recurso de tarjeta del carrusel discovery que se utiliza dentro de un anuncio.

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

string

El nombre del recurso Recursos de esta tarjeta del carrusel discovery.

DiscoveryVideoResponsiveAdInfo

Anuncio responsivo de video discovery

Representación JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
Campos
headlines[]

object (AdTextAsset)

Es la lista de recursos de texto utilizados para el título corto.

longHeadlines[]

object (AdTextAsset)

Es la lista de recursos de texto utilizados para el título largo.

descriptions[]

object (AdTextAsset)

Es la lista de recursos de texto usados para la descripción.

videos[]

object (AdVideoAsset)

Es la lista de elementos de video de YouTube que se usan en el anuncio.

logoImages[]

object (AdImageAsset)

Imagen del logotipo que se utilizará en el anuncio. Los tipos de imagen válidos son GIF, JPEG y PNG. El tamaño mínimo es de 128 x 128 y la relación de aspecto debe ser de 1:1 (+-1%).

breadcrumb1

string

Es la primera parte del texto que aparece en el anuncio con la URL que se muestra.

breadcrumb2

string

La segunda parte del texto que aparece en el anuncio con la URL que se muestra.

businessName

object (AdTextAsset)

Obligatorio. Es el nombre de la marca o el anunciante.

callToActions[]

object (AdCallToActionAsset)

Recursos de tipo CallToActionAsset para el botón "Call To Action" (Llamado a la acción)

AdCallToActionAsset

Un recurso de llamado a la acción que se utiliza dentro de un anuncio.

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

string

El nombre del recurso del recurso de este recurso de llamado a la acción.

TravelAdInfo

Este tipo no tiene campos.

Anuncio de viajes

Métodos

get

Muestra el anuncio solicitado en detalle.

mutate

Actualiza los anuncios.