Aracılığıyla paylaş

LabelSelector

  • Makale

Hesaptaki etiketlerin listesini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında bilgi için bkz. Seçiciler.

Yöntemler

Yöntem Adı Dönüş Türü Açıklama
Al LabelIterator Etiket listesinde yineleme yapmak için kullanılan bir yineleyici alır.
orderBy(string orderBy) LabelSelector Belirtilen sıralamayı seçili etiketlere uygular.
withCondition(dize koşulu) LabelSelector Etiketlere filtre ölçütleri uygular.
withIds(string[] ids) LabelSelector Belirtilen kimliklere sahip etiketleri alır.
withLimit(int sınırı) LabelSelector Seçim ölçütlerine uyan ilk n etiketi alır.

Al

Etiket listesinde yineleme yapmak için kullanılan bir yineleyici alır.

Döndürür

Tür Açıklama
LabelIterator Seçili etiketler arasında yineleme yapmak için kullanılan bir yineleyici.

orderBy(string orderBy)

Belirtilen sıralamayı seçili etiketlere uygular.

"columnName orderDirection" biçiminde orderBy parametresini belirtin. Burada:

  • columnNamedesteklenen sütunlardan biridir.
  • orderDirection , sonuçları sıralama düzenidir. Sonuçları artan düzende sıralamak için ASC veya azalan düzende sıralamak için DESC olarak ayarlayın. Varsayılan değer ASC'dir.

Örneğin, aşağıdaki çağrı sonuçları etiketin adına göre artan sırada döndürür.

selector = selector.orderBy("Name");

KeywordCount gibi bir sayı sütunu belirtirseniz, seçici sayıya göre ve sonra da artan sırada ada göre sıralar.

Seçiciler varlıkları yalnızca bir alana göre sıralamayı destekler. Varlıkların listesini x alanına göre, x içinde y alanına göre sıralayamayabilirsiniz. Zincirde veya ayrı seçici çağrılarında birden orderBy() fazla çağrı belirtirseniz, Betikler son orderBy() çağrıda belirtilen alanı kullanarak varlık listesini sipariş eder. 

Bağımsız değişken

Name Tür Açıklama
Orderby Dize Uygulanacak sipariş.

Döndürür

Tür Açıklama
LabelSelector Sıralama uygulanmış seçici.

withCondition(Dize koşulu)

Etiketlere filtre ölçütleri uygular.

koşul parametresini şu şekilde belirtin: "columnName işleç değeri":

Işleç

Kullandığınız işleç, sütunun türüne bağlıdır. İşleçler büyük/küçük harfe duyarlıdır. Örneğin, starts_with yerine STARTS_WITH kullanın.

Tamsayılar ve uzun değerler içeren sütunların işleçleri:

<
<=
>
>=
=
!=

Çift değer içeren sütunların işleçleri:

<
>

Dize değerleri içeren sütunların işleçleri:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Numaralandırma değerleri içeren sütunların işleçleri:

=
!=
IN []
NOT_IN []

Dize dizisi içeren sütunların işleçleri:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Etiket filtreleme için desteklenen sütunlar. Sütun adları büyük/küçük harfe duyarlıdır.

Sütun Tür Örnek
Name Dize Etiketin adı.

withCondition("Name = 'foo'")
KeywordCount Dize Etiketle ilişkilendirilmiş anahtar sözcük sayısı.

withCondition("KeywordCount > 5")
AdCount Dize Etiketle ilişkili reklam sayısı.

withCondition("AdCount > 5")
AdGroupCount Dize Etiketle ilişkilendirilmiş reklam gruplarının sayısı.

withCondition("AdGroupCount > 5")
CampaignCount Dize Etiketle ilişkilendirilmiş kampanyaların sayısı.

withCondition("CampaignCount > 5")

Bağımsız değişken

Name Tür Açıklama
Durum Dize Seçiciye eklenecek koşul.

Döndürür

Tür Açıklama
LabelSelector Koşulun uygulandığı seçici.

withIds(string[] ids)

Belirtilen kimliklere sahip etiketleri alır.

Bir seçiciye bir veya daha fazla koşul uygulayabilirsiniz. Bir koşul zinciri and işlemi olarak kabul edilir. Örneğin, varlık yalnızca A koşulu doğruysa ve B koşulu doğruysa seçilir. Örneğin, aşağıdaki çağrı yalnızca 33333 etiketini seçer.

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

Bağımsız değişken

Name Tür Açıklama
Kimlik string[] Etiket kimlikleri dizisi. Sınırlar için bkz. Betik yürütme sınırları.

Döndürür

Tür Açıklama
LabelSelector Kimliklerin uygulandığı seçici.

withLimit(int sınırı)

Seçim ölçütlerine uyan ilk n etiketi alır.

Bağımsız değişken

Name Tür Açıklama
Sınırı Int Döndürülecek etiket sayısı. Gerçek sayı daha az olabilir.

Döndürür

Tür Açıklama
LabelSelector Sınır uygulanmış seçici.

Ayrıca bkz.