Condividi tramite


AdsApp

Si tratta dell'oggetto di primo livello usato per accedere a un singolo account e gestirlo.

Nota

Questo oggetto sostituisce l'oggetto BingAdsApp . Per il futuro immediato, Script continuerà a supportare BingAdsApp per la compatibilità con le versioni precedenti; tuttavia, è consigliabile aggiornare gli script per usare questo oggetto al più presto.

Metodi

Nome metodo Tipo restituito Descrizione
adGroups AdGroupSelector Ottiene un selettore utilizzato per filtrare l'elenco di gruppi di annunci in questo account.
Annunci AdSelector Ottiene un selettore utilizzato per filtrare l'elenco di annunci in questo account.
Budget BudgetSelector Ottiene un selettore utilizzato per filtrare l'elenco di budget condivisi in questo account.
Campagne CampaignSelector Ottiene un selettore utilizzato per filtrare l'elenco di campagne in questo account.
createLabel(string name, string description, string backgroundColor) Vuoto Crea un'etichetta.
currentAccount Account Ottiene l'account che lo script sta attualmente elaborando.
getExecutionInfo Executioninfo Restituisce informazioni sull'ambiente in cui lo script è attualmente in esecuzione.
Parole chiavi KeywordSelector Ottiene un selettore utilizzato per filtrare l'elenco di parole chiave in questo account.
Etichette LabelSelector Ottiene un selettore utilizzato per filtrare l'elenco di etichette in questo account.
negativeKeywordLists NegativeKeywordListSelector Ottiene un selettore utilizzato per filtrare l'elenco di elenchi di parole chiave negative in questo account.
newNegativeKeywordListBuilder NegativeKeywordListBuilder Ottiene un generatore utilizzato per aggiungere un elenco di parole chiave negative a questo account.
productGroups ProductGroupSelector Ottiene un selettore utilizzato per filtrare l'elenco dei gruppi di prodotti in questo account.
shoppingAdGroups AdGroupSelector Ottiene un selettore utilizzato per filtrare l'elenco di gruppi di annunci usati per l'acquisto in questo account.
shoppingCampaigns CampaignSelector Ottiene un selettore utilizzato per filtrare l'elenco di campagne usate per lo shopping in questo account.
userLists UserListSelector Ottiene un selettore utilizzato per filtrare l'elenco di elenchi di utenti in questo account.

adGroups

Ottiene un selettore utilizzato per filtrare l'elenco di gruppi di annunci in questo account.

Restituisce

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

Annunci

Ottiene un selettore utilizzato per filtrare l'elenco di annunci in questo account.

Restituisce

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

Budget

Ottiene un selettore utilizzato per filtrare l'elenco di budget condivisi in questo account.

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

Restituisce

Tipo Descrizione
BudgetSelector Selettore utilizzato per filtrare l'elenco di budget condivisi nel conto corrente.

Campagne

Ottiene un selettore utilizzato per filtrare l'elenco di campagne in questo account.

Restituisce

Tipo Descrizione
CampaignSelector Selettore utilizzato per filtrare l'elenco di campagne nell'account corrente.

createLabel(string name, string description, string backgroundColor)

Crea un'etichetta.

Per i limiti relativi al numero di etichette che è possibile creare per ogni account, vedere Limiti. Per un esempio che aggiunge un'etichetta a un account, vedere Uso delle etichette.

Argomenti

Nome Tipo Descrizione
Backgroundcolor stringa Facoltativo. Colore di sfondo da usare nell'esperienza utente per l'etichetta. È possibile specificare il colore usando:
  • Numero esadecimale a tre byte nel formato #RRGGBB. Ad esempio, #CB0400.
  • Uno dei 16 nomi di colori CSS noti. Ad esempio, acqua, giallo e fucsia.
Prendere in considerazione l'accessibilità quando si sceglie il colore. Se non specificato, viene scelto automaticamente un colore casuale.
descrizione stringa Facoltativo. Descrizione che descrive l'uso dell'etichetta. La dimensione massima è di 200 caratteri.

Se si specifica backgroundColor, è necessario specificare 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 è di 80 caratteri. Il metodo taglia gli spazi vuoti iniziali e finali dal nome.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

currentAccount

Ottiene l'account che lo script sta attualmente elaborando.

Nota

Per usare questo metodo in uno scenario con più account, selezionare 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 attualmente elaborando. Per informazioni su come usarlo in uno scenario con più account, vedere il metodo select 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

Ottiene un selettore utilizzato per filtrare l'elenco di parole chiave in questo account.

Restituisce

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

Etichette

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

Restituisce

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

negativeKeywordLists

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

Restituisce

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

newNegativeKeywordListBuilder

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

Restituisce

Tipo Descrizione
NegativeKeywordListBuilder Generatore usato per aggiungere un elenco di parole chiave negative all'account corrente.

productGroups

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

Restituisce

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

shoppingAdGroups

Ottiene un selettore utilizzato per filtrare l'elenco di gruppi di annunci usati per l'acquisto in questo account.

Restituisce

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

shoppingCampaigns

Ottiene un selettore utilizzato per filtrare l'elenco di campagne usate per lo shopping in questo account.

Restituisce

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

userLists

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

Restituisce

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

Vedere anche

Accesso con account singolo