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:
|
| 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. |