Partilhar via


Seletor de Etiquetas

Contém os métodos para filtrar e ordenar uma lista de etiquetas na conta. Para obter informações sobre seletores, consulte Seletores.

Métodos

Nome do Método Tipo de Devolução Descrição
obter LabelIterator Obtém um iterador utilizado para iterar através da lista de etiquetas.
orderBy(string orderBy) Seletor de Etiquetas Aplica a ordenação especificada às etiquetas selecionadas.
withCondition(condição de cadeia) Seletor de Etiquetas Aplica critérios de filtro às etiquetas.
withIds(string[] ids) Seletor de Etiquetas Obtém etiquetas com os IDs especificados.
withLimit(int limit) Seletor de Etiquetas Obtém as n etiquetas superiores que correspondem aos critérios de seleção.

obter

Obtém um iterador utilizado para iterar através da lista de etiquetas.

Devoluções

Tipo Descrição
LabelIterator Um iterador utilizado para iterar através das etiquetas selecionadas.

orderBy(string orderBy)

Aplica a ordenação especificada às etiquetas selecionadas.

Especifique o parâmetro orderBy no formulário "columnName orderDirection" em que:

  • columnName é uma das colunas suportadas.
  • orderDirection é a ordem para ordenar os resultados. Defina como ASC para ordenar os resultados por ordem ascendente ou DESC para ordenar os resultados por ordem descendente. A predefinição é ASC.

Por exemplo, a chamada seguinte devolve resultados por ordem ascendente pelo nome da etiqueta.

selector = selector.orderBy("Name");

Se especificar uma coluna de contagem, como KeywordCount, o seletor ordena por contagem e, em seguida, por nome por ordem ascendente.

Os seletores suportam a ordenação de entidades apenas por um campo. Não pode ordenar a lista de entidades por campo x e dentro de x por campo y, etc. Se especificar mais do que uma orderBy() chamada numa cadeia ou em chamadas de seletor separadas, os scripts ordenam a lista de entidades utilizando o campo especificado na última orderBy() chamada. 

Argumentos

Name Tipo Descrição
orderBy cadeia A ordenação a aplicar.

Devoluções

Tipo Descrição
Seletor de Etiquetas Seletor com ordenação aplicada.

withCondition(Condição de cadeia)

Aplica critérios de filtro às etiquetas.

Especifique o parâmetro condition no formulário "columnName operator value" em que:

Operadores

O operador que utilizar depende do tipo da coluna. Os operadores são sensíveis às maiúsculas e minúsculas. Por exemplo, utilize STARTS_WITH em vez de starts_with.

Operadores para colunas que contêm números inteiros e valores longos:

<
<=
>
>=
=
!=

Operadores para colunas que contêm valores duplos:

<
>

Operadores para colunas que contêm valores de cadeia:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operadores para colunas que contêm valores de enumeração:

=
!=
IN []
NOT_IN []

Operadores para colunas que contêm uma matriz de cadeias:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colunas suportadas para filtragem de etiquetas. Os nomes das colunas são sensíveis às maiúsculas e minúsculas.

Coluna Tipo Exemplos:
Name cadeia O nome da etiqueta.

withCondition("Name = 'foo'")
KeywordCount cadeia O número de palavras-chave associadas à etiqueta.

withCondition("KeywordCount > 5")
AdCount cadeia O número de anúncios associados à etiqueta.

withCondition("AdCount > 5")
AdGroupCount cadeia O número de grupos de anúncios associados à etiqueta.

withCondition("AdGroupCount > 5")
CampaignCount cadeia O número de campanhas associadas à etiqueta.

withCondition("CampaignCount > 5")

Argumentos

Name Tipo Descrição
condição cadeia A condição a adicionar ao seletor.

Devoluções

Tipo Descrição
Seletor de Etiquetas Seletor com a condição aplicada.

withIds(string[] ids)

Obtém etiquetas com os IDs especificados.

Pode aplicar uma ou mais condições a um seletor. Uma cadeia de condições é considerada uma operação E. Por exemplo, a entidade só é selecionada se a condição A for verdadeira E a condição B for verdadeira. Por exemplo, a chamada seguinte seleciona apenas a etiqueta 33333.

AdsApp.labels()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Argumentos

Name Tipo Descrição
IDs cadeia[] Uma matriz de IDs de etiqueta. Para obter limites, veja Limites de execução de scripts.

Devoluções

Tipo Descrição
Seletor de Etiquetas Seletor com os IDs aplicados.

withLimit(int limit)

Obtém as n etiquetas superiores que correspondem aos critérios de seleção.

Argumentos

Name Tipo Descrição
limite int O número de etiquetas a devolver. O número real pode ser menor.

Devoluções

Tipo Descrição
Seletor de Etiquetas Seletor com limite aplicado.

Consulte também