LabelSelector
Contiene i metodi per filtrare e ordinare un elenco di etichette nell'account. Per informazioni sui selettori, vedere Selettori.
Metodi
Nome metodo | Tipo restituito | Descrizione |
---|---|---|
Ottieni | LabelIterator | Ottiene un iteratore utilizzato per scorrere l'elenco di etichette. |
orderBy(string orderBy) | LabelSelector | Applica l'ordinamento specificato alle etichette selezionate. |
withCondition(string condition) | LabelSelector | Applica i criteri di filtro alle etichette. |
withIds(string[] ids) | LabelSelector | Ottiene le etichette con gli ID specificati. |
withLimit(int limit) | LabelSelector | Ottiene le prime n etichette che corrispondono ai criteri di selezione. |
Ottieni
Ottiene un iteratore utilizzato per scorrere l'elenco di etichette.
Restituisce
Tipo | Descrizione |
---|---|
LabelIterator | Iteratore usato per scorrere le etichette selezionate. |
orderBy(string orderBy)
Applica l'ordinamento specificato alle etichette selezionate.
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 al nome dell'etichetta.
selector = selector.orderBy("Name");
Se si specifica una colonna count, ad esempio KeywordCount, il selettore ordina in base al conteggio e quindi per nome in ordine crescente.
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
Nome | Tipo | Descrizione |
---|---|---|
Orderby | stringa | Ordinamento da applicare. |
Restituisce
Tipo | Descrizione |
---|---|
LabelSelector | Selettore con ordinamento applicato. |
withCondition(String condition)
Applica i criteri di filtro alle etichette.
Specificare il parametro condition nel formato "columnName operator value" dove:
- columnName è una delle colonne supportate.
- 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 delle etichette. Ai nomi delle colonne viene applicata la distinzione tra maiuscole e minuscole.
Colonna | Tipo | Esempio |
---|---|---|
Nome | stringa | Nome dell'etichetta.withCondition("Name = 'foo'") |
KeywordCount | stringa | Numero di parole chiave associate all'etichetta.withCondition("KeywordCount > 5") |
AdCount | stringa | Numero di annunci associati all'etichetta.withCondition("AdCount > 5") |
AdGroupCount | stringa | Numero di gruppi di annunci associati all'etichetta.withCondition("AdGroupCount > 5") |
CampaignCount | stringa | Numero di campagne associate all'etichetta.withCondition("CampaignCount > 5") |
Argomenti
Nome | Tipo | Descrizione |
---|---|---|
Condizione | stringa | Condizione da aggiungere al selettore. |
Restituisce
Tipo | Descrizione |
---|---|
LabelSelector | Selettore con la condizione applicata. |
withIds(string[] ids)
Ottiene le etichette 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'etichetta 33333.
AdsApp.labels()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
Argomenti
Nome | Tipo | Descrizione |
---|---|---|
Id | string[] | Matrice di ID etichetta. Per i limiti, vedere Limiti di esecuzione dello script. |
Restituisce
Tipo | Descrizione |
---|---|
LabelSelector | Selettore con gli ID applicati. |
withLimit(int limit)
Ottiene le prime n etichette che corrispondono ai criteri di selezione.
Argomenti
Nome | Tipo | Descrizione |
---|---|---|
Limite | int | Numero di etichette da restituire. Il numero effettivo può essere minore. |
Restituisce
Tipo | Descrizione |
---|---|
LabelSelector | Selettore con limite applicato. |