Aplicación de anuncios

Es el objeto de nivel superior que se usa para acceder a una sola cuenta y administrarla.

Nota:

Este objeto reemplaza al objeto BingAdsApp . En el futuro inmediato, Scripts seguirá siendo compatible con BingAdsApp para la compatibilidad con versiones anteriores; Sin embargo, se recomienda actualizar los scripts para usar este objeto lo antes posible.

Métodos

Nombre del método	Tipo de valor devuelto	Description
Grupos de anuncios	AdGroupSelector	Obtiene un selector que se usa para filtrar la lista de grupos de anuncios de esta cuenta.
Anuncios	AdSelector	Obtiene un selector que se usa para filtrar la lista de anuncios de esta cuenta.
Presupuestos	Selector de presupuesto	Obtiene un selector que se usa para filtrar la lista de presupuestos compartidos de esta cuenta.
campañas	Selector de campaña	Obtiene un selector que se usa para filtrar la lista de campañas de esta cuenta.
createLabel(string name, string description, string backgroundColor)	void	Crea un rótulo.
currentAccount	Account	Obtiene la cuenta que el script está procesando actualmente.
getExecutionInfo	Información de ejecución	Devuelve información sobre el entorno en el que se está ejecutando actualmente el script.
palabras clave	KeywordSelector	Obtiene un selector que se usa para filtrar la lista de palabras clave de esta cuenta.
Etiquetas	LabelSelector	Obtiene un selector que se usa para filtrar la lista de etiquetas de esta cuenta.
negativeKeywordLists	NegativeKeywordListSelector	Obtiene un selector que se usa para filtrar la lista de listas de palabras clave negativas de esta cuenta.
newNegativeKeywordListBuilder	NegativeKeywordListBuilder	Obtiene un generador que se usa para agregar una lista de palabras clave negativas a esta cuenta.
performanceMaxCampaigns	Selector de campaña	Obtiene un selector que se usa para filtrar la lista de campañas máximas de rendimiento de esta cuenta.
productGroups	ProductGroupSelector	Obtiene un selector que se utiliza para filtrar la lista de grupos de productos de esta cuenta.
shoppingAdGroups	AdGroupSelector	Obtiene un selector que se usa para filtrar la lista de grupos de anuncios usados para comprar en esta cuenta.
shoppingCampaigns	Selector de campaña	Obtiene un selector que se usa para filtrar la lista de campañas usadas para comprar en esta cuenta.
userLists	UserListSelector	Obtiene un selector que se usa para filtrar la lista de listas de usuarios de esta cuenta.

Grupos de anuncios

Obtiene un selector que se usa para filtrar la lista de grupos de anuncios de esta cuenta.

Valores devueltos

Tipo	Description
AdGroupSelector	Un selector que se usa para filtrar la lista de grupos de anuncios de la cuenta actual.

Anuncios

Obtiene un selector que se usa para filtrar la lista de anuncios de esta cuenta.

Valores devueltos

Tipo	Description
AdSelector	Selector que se usa para filtrar la lista de anuncios de la cuenta actual.

Presupuestos

Obtiene un selector que se usa para filtrar la lista de presupuestos compartidos de esta cuenta.

Este método devuelve solo presupuestos compartidos. Para obtener presupuestos no compartidos (campañas individuales), llame al método getBudget de la campaña específica. El presupuesto de la campaña no se comparte si el isExplicitlyShared método devuelve un valor falso.

Valores devueltos

Tipo	Description
Selector de presupuesto	Selector que se usa para filtrar la lista de presupuestos compartidos de la cuenta actual.

campañas

Obtiene un selector que se usa para filtrar la lista de campañas de esta cuenta.

Valores devueltos

Tipo	Description
Selector de campaña	Un selector que se usa para filtrar la lista de campañas de la cuenta actual.

createLabel(string name, string description, string backgroundColor)

Crea un rótulo.

Para ver los límites del número de etiquetas que puedes crear por cuenta, consulta Límites. Para ver un ejemplo en el que se agrega una etiqueta a una cuenta, consulte Uso de etiquetas.

Argumentos

Nombre	Tipo	Description
color de fondo	string	Opcional. El color de fondo que se va a usar en la experiencia de usuario para la etiqueta. Puede especificar el color mediante: Un número hexadecimal de tres bytes con el formato #RRGGBB. Por ejemplo, #CB0400. Uno de los 16 nombres de color CSS conocidos. Por ejemplo, aguamarina, amarillo y fucsia. Ten en cuenta la accesibilidad a la hora de elegir el color. Si no se especifica, se elige un color aleatorio para usted.
description	string	Opcional. Una descripción que describe el uso de la etiqueta. El tamaño máximo es de 200 caracteres. Si especifica backgroundColor, debe proporcionar una descripción o una cadena vacía ("").
name	string	Obligatorio. El nombre del sello. El nombre distingue mayúsculas de minúsculas y debe ser único dentro de la cuenta. El tamaño máximo es de 80 caracteres. El método recorta los espacios en blanco iniciales y finales del nombre.

Valores devueltos

Tipo	Description
void	Devuelve el valor nothing.

currentAccount

Obtiene la cuenta que el script está procesando actualmente.

Nota:

Para usar este método en un escenario de varias cuentas, primero selecciona una cuenta para administrar. Si llama a este método antes de seleccionar una cuenta, la llamada devuelve un valor nulo.

Valores devueltos

Tipo	Description
Account	La cuenta que el script está procesando actualmente. Para ver cómo usar esto en un escenario de varias cuentas, vea el método de selección de AccountsApp.

getExecutionInfo

Devuelve información sobre el entorno en el que se está ejecutando actualmente el script.

Valores devueltos:

Tipo	Description
Información de ejecución	Información sobre el entorno en el que se ejecuta actualmente el script.

keywords

Obtiene un selector que se usa para filtrar la lista de palabras clave de esta cuenta.

Valores devueltos

Tipo	Description
KeywordSelector	Un selector que se usa para filtrar la lista de palabras clave de la cuenta actual.

Etiquetas

Obtiene un selector que se usa para filtrar la lista de etiquetas de esta cuenta.

Valores devueltos

Tipo	Description
LabelSelector	Selector que se usa para filtrar la lista de etiquetas de la cuenta actual.

negativeKeywordLists

Obtiene un selector que se usa para filtrar la lista de listas de palabras clave negativas de esta cuenta.

Valores devueltos

Tipo	Description
NegativeKeywordListSelector	Un selector que se usa para filtrar la lista de listas de palabras clave negativas de la cuenta actual.

newNegativeKeywordListBuilder

Obtiene un generador que se usa para agregar una lista de palabras clave negativas a esta cuenta.

Valores devueltos

Tipo	Description
NegativeKeywordListBuilder	Un generador que se usa para agregar una lista de palabras clave negativas a la cuenta actual.

performanceMaxCampaigns

Obtiene un selector que se usa para filtrar la lista de campañas usadas para el rendimiento máximo en esta cuenta.

Valores devueltos

Tipo	Description
Selector de campaña	Selector que se usa para filtrar la lista de campañas usadas para el rendimiento máximo en la cuenta actual.

productGroups

Obtiene un selector que se utiliza para filtrar la lista de grupos de productos de esta cuenta.

Valores devueltos

Tipo	Description
ProductGroupSelector	Selector que se usa para filtrar la lista de grupos de productos de la cuenta actual.

shoppingAdGroups

Obtiene un selector que se usa para filtrar la lista de grupos de anuncios usados para comprar en esta cuenta.

Valores devueltos

Tipo	Description
AdGroupSelector	Un selector que se usa para filtrar la lista de grupos de anuncios usados para comprar en la cuenta actual.

shoppingCampaigns

Obtiene un selector que se usa para filtrar la lista de campañas usadas para comprar en esta cuenta.

Valores devueltos

Tipo	Description
Selector de campaña	Un selector que se usa para filtrar la lista de campañas usadas para comprar en la cuenta actual.

userLists

Obtiene un selector que se usa para filtrar la lista de listas de usuarios de esta cuenta.

Valores devueltos

Tipo	Description
UserListSelector	Selector que se usa para filtrar la lista de listas de usuarios de la cuenta actual.

Vea también

Acceso de cuenta única