UserListSelector

Hesaptaki kullanıcı listelerinin listesini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında daha fazla bilgi için bkz: Seçiciler.

Yöntemler

Yöntem Adı İade Türü Açıklama
Almak UserListIterator Kullanıcı listeleri listesinde yineleme yapmak için kullanılan bir yineleyici alır.
orderBy(dize orderBy) UserListSelector Belirtilen sıralamayı seçili kullanıcı listelerine uygular.
withCondition(dize koşulu) UserListSelector Kullanıcı listelerine filtre ölçütleri uygular.
withIds(string[] ids) UserListSelector Belirtilen kimliklere sahip kullanıcı listelerini alır.
withLimit(int limit) UserListSelector Seçim ölçütleriyle eşleşen ilk n kullanıcı listesini alır.

Almak

Kullanıcı listeleri listesinde yineleme yapmak için kullanılan bir yineleyici alır.

Geri dönüşler

Tür Açıklama
UserListIterator Seçili kullanıcı listelerinde yineleme yapmak için kullanılan yineleyici.

orderBy(dize orderBy)

Belirtilen sıralamayı seçili kullanıcı listelerine uygular.

orderBy parametresini "columnName orderDirection" biçiminde belirtin; burada:

  • columnName , [desteklenen sütunlar](#supported-user list-columns) biridir.
  • orderDirection , sonuçların sıralandığı sıradır. Sonuçları azalan sırada sıralamak için ASC olarak veya sonuçları azalan sırada sıralamak için DESC olarak ayarlayın. Varsayılan değer ASC'dir.

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

selector = selector.orderBy("Name");

Seçiciler, varlıkları yalnızca bir alana göre sıralamayı destekler. Varlıkların listesini x alanına göre ve x içinde y alanına göre sıralayamazsınız. Bir zincirde veya ayrı seçici çağrılarında birden fazla orderBy() çağrı belirtirseniz, Betikler son orderBy() çağrıda belirtilen alanı kullanarak varlıkların listesini sıralar. 

Bağımsız değişkenler

Name Tür Açıklama
orderBy dize Uygulanacak sipariş.

Geri dönüşler

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

withCondition(Dize koşulu)

Kullanıcı listelerine filtre ölçütleri uygular.

"columnName işleç değeri" biçiminde koşul parametresini belirtin, burada:

  • columnName , [desteklenen sütunlar](#supported-user list-columns) biridir.
  • operatörü desteklenen operatörlerden biridir.

Operatörler

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

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

<
<=
>
>=
=
!=

Ç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 []

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

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Kullanıcı listesi filtreleme için desteklenen sütunlar. Sütun adları büyük/küçük harf duyarlıdır.

Sütun Tür Örnek
Açıklama dize Kullanıcı listesinin açıklaması.

withCondition("Description = 'foo'")
Üyelik Yaşam Süresi int Microsoft Advertising'in bu kullanıcı listesi tanımıyla eşleşen eylemleri araması gerekir.

withCondition("MembershipLifeSpan > 10")
Name dize Kullanıcı listesinin adı.

withCondition("Name = 'foo'")
SizeForAudienceNetwork uzun Audience ağındaki kullanıcı listesinin boyutu.

withCondition("SizeForAudienceNetwork > 1000")
SizeForSearch uzun Audience ağındaki kullanıcı listesinin boyutu.

withCondition("SizeForSearch > 1000")
Tür dize Kullanıcı listesinin türetilmiş türü. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • GÖRENEK
  • CUSTOMER_LIST
  • IN_MARKET
  • MANTIKSAL işlevi
  • ÜRÜN
  • RULE_BASED
  • BENZER
Bu örnekte yalnızca müşteri listeleri döndürülür.

withCondition("Type = CUSTOMER_LIST")

Bağımsız değişkenler

Name Tür Açıklama
Şart dize Seçiciye eklenecek koşul.

Geri dönüşler

Tür Açıklama
UserListSelector Uygulanan koşulla seçici.

withIds(string[] ids)

Belirtilen kimliklere sahip kullanıcı listelerini alır.

Bir seçiciye bir veya daha fazla koşul uygulayabilirsiniz. Koşullar 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 numaralı kullanıcı listesini seçer.

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

Bağımsız değişkenler

Name Tür Açıklama
kimlikler dize[] Kullanıcı listesi kimlikleri dizisi. Sınırlar için bkz: Komut dosyası yürütme sınırları.

Geri dönüşler

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

withLimit(int limit)

Seçim ölçütleriyle eşleşen ilk n kullanıcı listesini alır.

Bağımsız değişkenler

Name Tür Açıklama
sınırlamak int Döndürülecek kullanıcı listelerinin sayısı. Gerçek sayı daha az olabilir.

Geri dönüşler

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

Ayrıca bkz.

  • Last updated on