AdsApp

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

Nota:

Este objeto reemplaza el objeto BingAdsApp . En el futuro inmediato, scripts seguirán admitiendo 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	Descripción
adGroups	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	BudgetSelector	Obtiene un selector usado para filtrar la lista de presupuestos compartidos de esta cuenta.
Campañas	CampaignSelector	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	ExecutionInfo	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 usado para filtrar la lista de etiquetas de esta cuenta.
negativeKeywordLists	NegativeKeywordListSelector	Obtiene un selector usado para filtrar la lista de listas de palabras clave negativas en esta cuenta.
newNegativeKeywordListBuilder	NegativeKeywordListBuilder	Obtiene un generador usado para agregar una lista de palabras clave negativas a esta cuenta.
productGroups	ProductGroupSelector	Obtiene un selector que se usa 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 que se usan para realizar compras en esta cuenta.
shoppingCampaigns	CampaignSelector	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.

adGroups

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

Valores devueltos

Tipo	Descripción
AdGroupSelector	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	Descripción
AdSelector	Selector que se usa para filtrar la lista de anuncios de la cuenta actual.

Presupuestos

Obtiene un selector usado para filtrar la lista de presupuestos compartidos de esta cuenta.

Este método solo devuelve 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 false.

Valores devueltos

Tipo	Descripción
BudgetSelector	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	Descripción
CampaignSelector	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 conocer los límites del número de etiquetas que puede crear por cuenta, consulte Límites. Para obtener un ejemplo que agrega una etiqueta a una cuenta, consulte Uso de etiquetas.

Argumentos

Nombre	Tipo	Descripción
Backgroundcolor	string	Opcional. 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 en el formulario, #RRGGBB. Por ejemplo, #CB0400. Uno de los 16 nombres de color CSS conocidos. Por ejemplo, aqua, amarillo y fuchsia. Tenga en cuenta la accesibilidad al elegir el color. Si no se especifica, se elige un color aleatorio para usted.
description	string	Opcional. 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. Nombre de la etiqueta. 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 el espacio en blanco inicial y final del nombre.

Valores devueltos

Tipo	Descripción
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, seleccione primero una cuenta para administrar. Si llama a este método antes de seleccionar una cuenta, la llamada devuelve null.

Valores devueltos

Tipo	Descripción
Account	Cuenta que el script está procesando actualmente. Para ver cómo usar esto en un escenario de varias cuentas, consulte el método select de AccountsApp.

getExecutionInfo

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

Valores devueltos:

Tipo	Descripción
ExecutionInfo	Información sobre el entorno en el que se está ejecutando actualmente el script.

keywords

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

Valores devueltos

Tipo	Descripción
KeywordSelector	Selector que se usa para filtrar la lista de palabras clave de la cuenta actual.

Etiquetas

Obtiene un selector usado para filtrar la lista de etiquetas de esta cuenta.

Valores devueltos

Tipo	Descripción
LabelSelector	Selector que se usa para filtrar la lista de etiquetas de la cuenta actual.

negativeKeywordLists

Obtiene un selector usado para filtrar la lista de listas de palabras clave negativas en esta cuenta.

Valores devueltos

Tipo	Descripción
NegativeKeywordListSelector	Selector que se usa para filtrar la lista de listas de palabras clave negativas en la cuenta actual.

newNegativeKeywordListBuilder

Obtiene un generador usado para agregar una lista de palabras clave negativas a esta cuenta.

Valores devueltos

Tipo	Descripción
NegativeKeywordListBuilder	Generador que se usa para agregar una lista de palabras clave negativas a la cuenta actual.

productGroups

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

Valores devueltos

Tipo	Descripción
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 que se usan para realizar compras en esta cuenta.

Valores devueltos

Tipo	Descripción
AdGroupSelector	Selector que se usa para filtrar la lista de grupos de anuncios que se usan para realizar compras 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	Descripción
CampaignSelector	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	Descripción
UserListSelector	Selector que se usa para filtrar la lista de listas de usuarios de la cuenta actual.

Consulte también

Acceso a una sola cuenta