AdsApp

Questo è l'oggetto di primo livello utilizzato per accedere e gestire un singolo account.

Nota

Questo oggetto sostituisce l'oggetto BingAdsApp . Per l'immediato futuro, Scripts continuerà a supportare BingAdsApp per la compatibilità con le versioni precedenti. Tuttavia, ti invitiamo ad aggiornare gli script per usare questo oggetto non appena possibile.

Metodi

Nome metodo	Tipo restituito	Descrizione
adGroups	AdGroupSelector	Usa un selettore per filtrare l'elenco dei gruppi di annunci presenti nell'account.
annunci pubblicitari	AdSelector	Usa un selettore per filtrare l'elenco degli annunci in questo account.
budget	Selettore budget	Viene usato un selettore per filtrare l'elenco dei budget condivisi nell'account.
campagne	CampaignSelector	Usa un selettore per filtrare l'elenco delle campagne in questo account.
createLabel(nome stringa, descrizione stringa, stringa backgroundColor)	void	Crea un'etichetta.
currentAccount	Account	Ottiene l'account che lo script sta elaborando.
getExecutionInfo	ExecutionInfo	Restituisce informazioni sull'ambiente in cui lo script è attualmente in esecuzione.
Parole chiave	KeywordSelector	Usa un selettore per filtrare l'elenco di parole chiave dell'account.
etichette	LabelSelector	Ottiene un selettore usato per filtrare l'elenco di etichette in questo account.
negativeKeywordLists	NegativeKeywordListSelector	Usa un selettore per filtrare l'elenco di elenchi di parole chiave negative in questo account.
newNegativeKeywordListBuilder	NegativeKeywordListBuilder	Ottiene un builder utilizzato per aggiungere un elenco di parole chiave negative a questo account.
performanceMaxCampaigns	CampaignSelector	Usa un selettore per filtrare l'elenco delle campagne Performance Max in questo account.
Gruppi di prodotti	ProductGroupSelector	Ottiene un selettore usato per filtrare l'elenco dei gruppi di prodotti in questo account.
shoppingAdGroups	AdGroupSelector	Ottiene un selettore usato per filtrare l'elenco di gruppi di annunci usati per gli acquisti in questo account.
shoppingCampaigns	CampaignSelector	Ottiene un selettore usato per filtrare l'elenco delle campagne usate per gli acquisti in questo account.
userLists	UserListSelector	Ottiene un selettore usato per filtrare l'elenco degli elenchi di utenti in questo account.

adGroups

Usa un selettore per filtrare l'elenco dei gruppi di annunci presenti nell'account.

Restituisce

Tipo	Descrizione
AdGroupSelector	Selettore usato per filtrare l'elenco di gruppi di annunci nell'account corrente.

annunci pubblicitari

Usa un selettore per filtrare l'elenco degli annunci in questo account.

Restituisce

Tipo	Descrizione
AdSelector	Selettore usato per filtrare l'elenco degli annunci nell'account corrente.

budget

Viene usato un selettore per filtrare l'elenco dei budget condivisi nell'account.

Questo metodo restituisce solo i budget condivisi. Per ottenere budget non condivisi (singole campagne), chiamare il metodo getBudget della campagna specifica. Il budget della campagna non viene condiviso se il isExplicitlyShared metodo restituisce false.

Restituisce

Tipo	Descrizione
Selettore budget	Selettore usato per filtrare l'elenco di budget condivisi nell'account corrente.

campagne

Usa un selettore per filtrare l'elenco delle campagne in questo account.

Restituisce

Tipo	Descrizione
CampaignSelector	Selettore usato per filtrare l'elenco delle campagne nell'account corrente.

createLabel(nome stringa, descrizione stringa, stringa backgroundColor)

Crea un'etichetta.

Per i limiti del numero di etichette che puoi creare per account, consulta Limiti. Per un esempio di aggiunta di un'etichetta a un account, vedere Utilizzo delle etichette.

Argomenti

Nome	Tipo	Descrizione
backgroundColor	stringa	Facoltativo. Colore di sfondo da usare nell'esperienza utente per l'etichetta. È possibile specificare il colore utilizzando: Numero esadecimale a tre byte nel formato #RRGGBB. Ad esempio, #CB0400. Uno dei 16 nomi di colore CSS conosciuti. Ad esempio, acqua, giallo e fucsia. Considerare l'accessibilità quando si sceglie il colore. Se non viene specificato, viene scelto un colore casuale.
descrizione	stringa	Facoltativo. Descrizione che descrive l'uso dell'etichetta. La dimensione massima è 200 caratteri. Se si specifica backgroundColor, è necessario fornire una descrizione o una stringa vuota ("").
Nome	stringa	Obbligatorio. Nome dell'etichetta. Il nome fa distinzione tra maiuscole e minuscole e deve essere univoco all'interno dell'account. La dimensione massima è 80 caratteri. Il metodo elimina gli spazi bianchi iniziali e finali dal nome.

Restituisce

Tipo	Descrizione
void	Non restituisce nulla.

currentAccount

Ottiene l'account che lo script sta elaborando.

Nota

Per usare questo metodo in uno scenario con più account, seleziona prima di tutto un account da gestire. Se si chiama questo metodo prima di selezionare un account, la chiamata restituisce Null.

Restituisce

Tipo	Descrizione
Account	Account che lo script sta elaborando. Per informazioni su come usare questa funzionalità in uno scenario con più account, vedere il metodo di selezione di AccountsApp.

getExecutionInfo

Restituisce informazioni sull'ambiente in cui lo script è attualmente in esecuzione.

Restituisce:

Tipo	Descrizione
ExecutionInfo	Informazioni sull'ambiente in cui lo script è attualmente in esecuzione.

keywords

Usa un selettore per filtrare l'elenco di parole chiave dell'account.

Restituisce

Tipo	Descrizione
KeywordSelector	Selettore usato per filtrare l'elenco di parole chiave nell'account corrente.

etichette

Ottiene un selettore usato per filtrare l'elenco di etichette in questo account.

Restituisce

Tipo	Descrizione
LabelSelector	Selettore usato per filtrare l'elenco di etichette nell'account corrente.

negativeKeywordLists

Usa un selettore per filtrare l'elenco di elenchi di parole chiave negative in questo account.

Restituisce

Tipo	Descrizione
NegativeKeywordListSelector	Selettore usato per filtrare l'elenco di elenchi di parole chiave negative nell'account corrente.

newNegativeKeywordListBuilder

Ottiene un builder utilizzato per aggiungere un elenco di parole chiave negative a questo account.

Restituisce

Tipo	Descrizione
NegativeKeywordListBuilder	Un generatore usato per aggiungere un elenco di parole chiave negative al conto corrente.

performanceMaxCampaigns

Ottiene un selettore usato per filtrare l'elenco delle campagne usate per Performance Max in questo account.

Restituisce

Tipo	Descrizione
CampaignSelector	Selettore usato per filtrare l'elenco delle campagne usate per Performance Max nell'account corrente.

Gruppi di prodotti

Ottiene un selettore usato per filtrare l'elenco dei gruppi di prodotti in questo account.

Restituisce

Tipo	Descrizione
ProductGroupSelector	Selettore utilizzato per filtrare l'elenco di gruppi di prodotti nell'account corrente.

shoppingAdGroups

Ottiene un selettore usato per filtrare l'elenco di gruppi di annunci usati per gli acquisti in questo account.

Restituisce

Tipo	Descrizione
AdGroupSelector	Selettore usato per filtrare l'elenco di gruppi di annunci usati per gli acquisti nell'account corrente.

shoppingCampaigns

Ottiene un selettore usato per filtrare l'elenco delle campagne usate per gli acquisti in questo account.

Restituisce

Tipo	Descrizione
CampaignSelector	Selettore usato per filtrare l'elenco delle campagne usate per gli acquisti nell'account corrente.

userLists

Ottiene un selettore usato per filtrare l'elenco degli elenchi di utenti in questo account.

Restituisce

Tipo	Descrizione
UserListSelector	Selettore usato per filtrare l'elenco degli elenchi di utenti nell'account corrente.

Vedere anche

Accesso singolo all'account