BingAdsAccountSelector

Contiene i metodi per filtrare e ordinare l'elenco di account a cui l'utente ha accesso. Per informazioni sui selettori, vedere Selettori.

Utilizzo di esempio:

    var accounts = AccountsApp.accounts()
        .withCondition("Name CONTAINS_IGNORE_CASE 'PARTIAL ACCOUNT NAME GOES HERE'")
        .get();

    while (accounts.hasNext()) {
        var account = accounts.next();
    }

Metodi

executeInParallel(string functionName, string optionalCallbackFunctionName)

Esegue la funzione per ogni account restituito dal selettore. Dopo l'esecuzione della funzione per tutti gli account selezionati, Script chiama la funzione di callback facoltativa.

La funzione functionName può restituire un valore come stringa. Per restituire un oggetto complesso, usare il metodo JSON.stringify per convertire l'oggetto in una stringa. È quindi possibile usare il metodo JSON.parse per convertire nuovamente la stringa in un oggetto . Se la funzione restituisce un valore, è necessario specificare una funzione di callback per acquisire i valori restituiti. Di seguito viene illustrata la firma della funzione di callback. I valori restituiti vengono passati come matrice di oggetti ExecutionResult .

function myCallback(ExecutionResult[] results)

Nell'esempio seguente viene illustrato come elaborare i valori restituiti nella funzione di callback.

function myCallback(results) {
    for (var result of results) {
        var object = JSON.parse(result.getReturnValue());
    }
}

Poiché questo metodo non restituisce un oggetto BingAdsAccountSelector , assicurarsi che questo metodo sia l'ultimo metodo del selettore nella catena di chiamate.

Per un esempio, vedi Individuazione degli annunci non approvati.

Argomenti

Restituisce

executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput)

Esegue la funzione per ogni account restituito dal selettore. Dopo l'esecuzione della funzione per tutti gli account selezionati, Script chiama la funzione di callback facoltativa.

La funzione functionName può restituire un valore come stringa. Per restituire un oggetto complesso, usare il metodo JSON.stringify per convertire l'oggetto in una stringa. È quindi possibile usare il metodo JSON.parse per convertire nuovamente la stringa in un oggetto . Se la funzione restituisce un valore, è necessario specificare una funzione di callback per acquisire i valori restituiti. Di seguito viene illustrata la firma della funzione di callback. I valori restituiti vengono passati come matrice di oggetti ExecutionResult .

function myCallback(ExecutionResult[] results)

Nell'esempio seguente viene illustrato come elaborare i valori restituiti nella funzione di callback.

function myCallback(results) {
    for (var result of results) {
        var object = JSON.parse(result.getReturnValue());
    }
}

Se si passa il parametro di input facoltativo, di seguito viene illustrata la firma della funzione functionName .

function myFunction(string optionalInput)

Poiché questo metodo non restituisce un oggetto BingAdsAccountSelector , assicurarsi che questo metodo sia l'ultimo metodo del selettore nella catena di chiamate.

Per un esempio, vedi Individuazione degli annunci non approvati.

Argomenti

Restituisce

forDateRange(Object dateFrom, Object dateTo)

Applica le date di inizio e fine per la selezione delle metriche delle prestazioni.

Specificare un intervallo di date solo se:

• Si applicano condizioni o si ordinano i campi delle metriche delle prestazioni di riferimento.
• Si vogliono ottenere i dati sulle prestazioni per gli oggetti da selezionare. Ad esempio, se si prevede di chiamare il getStats() metodo .

È possibile specificare i parametri di data usando stringhe o oggetti . Per utilizzare le stringhe, specificare la data nel formato AAAAMMGG. Se si usano oggetti , creare un oggetto con i campi seguenti:

• Anno
• Mese
• Giorno

Ad esempio:

var date = {year: 2018, month: 5, day: 13};

Il mese è in base uno, dove 1 è gennaio e 12 dicembre.

L'intervallo di date è inclusivo. Se si specificano più intervalli di date, viene usato solo l'ultimo intervallo di date.

Argomenti

Restituisce

forDateRange(String dateRange)

Applica l'intervallo di date predefinito per la selezione delle metriche delle prestazioni.

Valori dell'intervallo di date supportati:

• OGGI
• IERI
• LAST_WEEK
• LAST_BUSINESS_WEEK
• LAST_7_DAYS
• THIS_WEEK_SUN_TODAY
• LAST_14_DAYS
• LAST_30_DAYS
• LAST_WEEK_SUN_SAT
• THIS_MONTH
• LAST_MONTH
• ALL_TIME

Specificare un intervallo di date solo se:

• Si applicano condizioni o si ordinano i campi delle metriche delle prestazioni di riferimento.
• Si vogliono ottenere i dati sulle prestazioni per gli oggetti da selezionare. Ad esempio, se si prevede di chiamare il getStats() metodo .

Se si specificano più intervalli di date, viene usato solo l'ultimo intervallo di date.

Argomenti

Restituisce

Ottieni

Ottiene un iteratore utilizzato per scorrere l'elenco di account.

Restituisce

orderBy(string orderBy)

Applica l'ordinamento specificato agli account selezionati.

Specificare il parametro orderBy nel formato "columnName orderDirection" dove:

• columnName è una delle colonne supportate.
• orderDirection è l'ordine in cui ordinare i risultati. Impostare su ASC per ordinare i risultati in ordine crescente o DESC per ordinare i risultati in ordine decrescente. Il valore predefinito è ASC.

Ad esempio, la chiamata seguente restituisce risultati in ordine crescente in base a Clic.

selector = selector.orderBy("Clicks");

I selettori supportano l'ordinamento delle entità in base a un solo campo. Non è possibile ordinare l'elenco di entità per campo x e all'interno di x per campo y e così via. Se si specificano più chiamate orderBy() in una catena o in chiamate selettore separate, Script ordina l'elenco di entità usando il campo specificato nell'ultima orderBy() chiamata. 

Argomenti

Restituisce

withAccountNumbers(string[] accountNumbers)

Ottiene gli account con i numeri di account specificati.

Argomenti

Restituisce

withCondition(String condition)

Applica criteri di filtro agli account.

Specificare il parametro condition nel formato "columnName operator value" dove:

• columnName è una delle colonne supportate. Se columName è impostato su un nome di colonna della metrica delle prestazioni, è necessario specificare un intervallo di date usando forDateRange(String dateRange) o forDateRange(Object dateFrom, Object dateTo).
• operator è uno degli operatori supportati.

Operatori

L'operatore usato dipende dal tipo della colonna. Gli operatori fanno distinzione tra maiuscole e minuscole. Ad esempio, usare STARTS_WITH anziché starts_with.

Operatori per le colonne che contengono valori interi e valori lunghi:

<
<=
>
>=
=
!=

Operatori per le colonne che contengono valori double:

<
>

Operatori per le colonne che contengono valori stringa:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operatori per le colonne che contengono valori di enumerazione:

=
!=
IN []
NOT_IN []

Operatori per le colonne che contengono una matrice di stringhe:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colonne supportate per il filtro degli account. Ai nomi delle colonne viene applicata la distinzione tra maiuscole e minuscole.

Di seguito sono riportate le colonne delle metriche delle prestazioni che è possibile specificare.

Di seguito sono riportate le proprietà dell'account che è possibile specificare.

Argomenti

Restituisce

withIds(string[] ids)

Ottiene gli account con gli ID specificati.

È possibile applicare una o più condizioni a un selettore. Una catena di condizioni è considerata un'operazione AND. Ad esempio, l'entità viene selezionata solo se la condizione A è true E la condizione B è true. Ad esempio, la chiamata seguente seleziona solo l'account 33333.

AccountsApp.accounts()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);
    .get();

Argomenti

Restituisce

withLimit(int limit)

Ottiene i primi n account che corrispondono ai criteri di selezione.

Argomenti

Restituisce

Vedere anche

• AccountsApp.accounts()
• BingAdsAccountIterator
• Accesso a più account