BingAdsAccountSelector

Kullanıcının erişimi olan hesapların listesini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında daha fazla bilgi için bkz: Seçiciler.

Örnek kullanım:

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

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

Yöntemler

Yöntem Adı İade Türü Açıklama
executeInParallel(dize functionName, dize optionalCallbackFunctionName) geçersiz Seçicinin döndürdüğü her hesap için işlevi yürütür.
executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput) geçersiz Seçicinin döndürdüğü her hesap için işlevi yürütür.
forDateRange(Object dateFrom, Object dateTo) BingAdsAccountSelector Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular.
forDateRange(dize dateRange) BingAdsAccountSelector Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular.
Almak BingAdsAccountIterator Hesap listesini yinelemek için kullanılan bir yineleyici alır.
orderBy(dize orderBy) BingAdsAccountSelector Belirtilen sıralamayı seçili hesaplara uygular.
withAccountNumbers(string[] accountNumbers) BingAdsAccountSelector Belirtilen hesap numaralarına sahip hesapları alır.
withCondition(dize koşulu) BingAdsAccountSelector Hesaplara filtre ölçütleri uygular.
withIds(string[] ids) BingAdsAccountSelector Belirtilen kimliklere sahip hesapları alır.
withLimit(int limit) BingAdsAccountSelector Seçim ölçütlerine uyan ilk n hesabı alır.

executeInParallel(dize functionName, dize optionalCallbackFunctionName)

Seçicinin döndürdüğü her hesap için işlevi yürütür. İşlev seçilen tüm hesaplar için yürütüldükten sonra, Komut Dosyaları isteğe bağlı geri çağırma işlevini çağırır.

Not

Komut dosyası, komut dosyası her çalıştığında paralel olarak en fazla 50 hesabı yürütebilir. Bu yöntemi bir veya birden çok kez çağırabilirsiniz, ancak tüm çağrıların işlediği toplam hesap sayısı 50'yi geçmemelidir. Bir çağrı, komut dosyası için maksimum 50 hesabı aşarsa, çağrıdaki hesapların hiçbiri yürütülmez. Seçicinin döndürdüğü hesap sayısını sınırlamak için veya withIds yöntemini kullanmayı withLimit göz önünde bulundurun.

functionName işlevi, dize olarak bir değer döndürebilir. Karmaşık bir nesne döndürmek için, nesneyi dizeye dönüştürmek üzere JSON.stringify yöntemini kullanın. Daha sonra dizeyi bir nesneye geri dönüştürmek için JSON.parse yöntemini kullanabilirsiniz. İşleviniz bir değer döndürürse, dönüş değerlerini yakalamak için bir geri çağırma işlevi belirtmeniz gerekir. Aşağıda geri çağırma işlevinin imzası gösterilmektedir. Döndürülen değerler bir ExecutionResult nesneleri dizisi olarak geçirilir .

function myCallback(ExecutionResult[] results)

Aşağıdaki örnek, geri çağırma işlevinde döndürülen değerlerin nasıl işleneceğini gösterir.

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

Bu yöntem bir BingAdsAccountSelector nesnesi döndürmediğinden, bu yöntemin çağrı zincirindeki son seçici yöntemi olduğundan emin olun.

Örneğin, Onaylanmamış reklamları keşfetme başlıklı makaleye göz atın.

Bağımsız değişkenler

Name Tür Açıklama
functionName dize Seçicinin döndürdüğü her hesap için yürütülecek işlevin adı. currentAccount yöntemi, işlevin işlediği hesabı tanımlar.
optionalCallbackFunctionName dize İsteğe bağlı. Tüm hesaplar functionName işlevinin yürütülmesini tamamladıktan sonra yürütülecek işlevin adı. Bu işlev yalnızca bir kez yürütülür.

Geri dönüşler

Tür Açıklama
geçersiz Hiçbir şey döndürmez.

executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput)

Seçicinin döndürdüğü her hesap için işlevi yürütür. İşlev seçilen tüm hesaplar için yürütüldükten sonra, Scripts isteğe bağlı geri çağırma işlevini çağırır.

Not

Komut dosyası, komut dosyası her çalıştığında paralel olarak en fazla 50 hesabı yürütebilir. Bu yöntemi bir veya birden çok kez çağırabilirsiniz, ancak tüm çağrıların işlediği toplam hesap sayısı 50'yi geçmemelidir. Bir çağrı, komut dosyası için maksimum 50 hesabı aşarsa, çağrıdaki hesapların hiçbiri yürütülmez. Seçicinin döndürdüğü hesap sayısını sınırlamak için veya withIds yöntemini kullanmayı withLimit göz önünde bulundurun.

functionName işlevi, dize olarak bir değer döndürebilir. Karmaşık bir nesne döndürmek için, nesneyi dizeye dönüştürmek üzere JSON.stringify yöntemini kullanın. Daha sonra dizeyi bir nesneye geri dönüştürmek için JSON.parse yöntemini kullanabilirsiniz. İşleviniz bir değer döndürürse, dönüş değerlerini yakalamak için bir geri çağırma işlevi belirtmeniz gerekir. Aşağıda geri çağırma işlevinin imzası gösterilmektedir. Döndürülen değerler bir ExecutionResult nesneleri dizisi olarak geçirilir .

function myCallback(ExecutionResult[] results)

Aşağıdaki örnek, geri çağırma işlevinde döndürülen değerlerin nasıl işleneceğini gösterir.

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

İsteğe bağlı giriş parametresini geçirirseniz, functionName işlevinin imzası aşağıda gösterilir.

function myFunction(string optionalInput)

Bu yöntem bir BingAdsAccountSelector nesnesi döndürmediğinden, bu yöntemin çağrı zincirindeki son seçici yöntemi olduğundan emin olun.

Örneğin, Onaylanmamış reklamları keşfetme başlıklı makaleye göz atın.

Bağımsız değişkenler

Name Tür Açıklama
functionName dize Seçicinin döndürdüğü her hesap için yürütülecek işlevin adı. currentAccount yöntemi, işlevin işlediği hesabı tanımlar.
optionalCallbackFunctionName dize İsteğe bağlı. Tüm hesaplar functionName işlevinin yürütülmesini tamamladıktan sonra yürütülecek işlevin adı. Bu işlev yalnızca bir kez yürütülür.
isteğe bağlıGiriş dize İsteğe bağlı. functionName işlevine geçirilecek giriş.

Geri dönüşler

Tür Açıklama
geçersiz Hiçbir şey döndürmez.

forDateRange(Object dateFrom, Object dateTo)

Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular.

Tarih aralığını yalnızca aşağıdaki koşullarda belirtin:

  • Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
  • Seçtiğiniz nesneler için performans verilerini almak istiyorsunuz. Örneğin, yöntemi çağırmayı getStats() planlıyorsanız.

Dizeleri veya nesneleri kullanarak tarih parametrelerini belirtebilirsiniz. Dizeleri kullanmak için, YYYYAAGG biçiminde tarihi belirtin. Nesneler kullanıyorsanız, aşağıdaki alanlarla bir nesne oluşturun:

  • yıl
  • ay
  • Gün

Örneğin:

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

Ay, 1'in Ocak ve 12'nin Aralık olduğu tek tabanlıdır.

Tarih aralığı kapsayıcıdır. Birden çok tarih aralığı belirtirseniz, yalnızca son tarih aralığı kullanılır.

Bağımsız değişkenler

Name Tür Açıklama
dateFrom Nesne Seçiciye eklenecek performans verilerini belirten tarih aralığının başlangıç tarihi.
dateEnd Nesne Seçiciye eklenecek performans verilerini belirten tarih aralığının bitiş tarihi.

Geri dönüşler

Tür Açıklama
BingAdsAccountSelector Tarih aralığı uygulanmış seçici.

forDateRange(Dize dateRange)

Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular.

Desteklenen tarih aralığı değerleri:

  • BUGÜN
  • DÜN
  • 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

Tarih aralığını yalnızca aşağıdaki koşullarda belirtin:

  • Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
  • Seçtiğiniz nesneler için performans verilerini almak istiyorsunuz. Örneğin, yöntemi çağırmayı getStats() planlıyorsanız.

Birden çok tarih aralığı belirtirseniz, yalnızca son tarih aralığı kullanılır.

Bağımsız değişkenler

Name Tür Açıklama
tarih aralığı Dize Seçiciye eklenecek performans verilerini belirten önceden tanımlanmış tarih aralığı dizesi. Önceden tanımlanmış tarih aralığı dizesi büyük/küçük harfe duyarlıdır.

Geri dönüşler

Tür Açıklama
BingAdsAccountSelector Tarih aralığı uygulanmış seçici.

Almak

Hesap listesini yinelemek için kullanılan bir yineleyici alır.

Geri dönüşler

Tür Açıklama
BingAds Hesabı Seçili hesaplarda yineleme yapmak için kullanılan bir yineleyici.

orderBy(dize orderBy)

Belirtilen sıralamayı seçili hesaplara uygular.

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

  • columnNamedesteklenen sütunlardan 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ı Tıklamalara göre artan sırada döndürür.

selector = selector.orderBy("Clicks");

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
BingAdsAccountSelector Sıralama uygulanmış seçici.

withAccountNumbers(string[] accountNumbers)

Belirtilen hesap numaralarına sahip hesapları alır.

Bağımsız değişkenler

Name Tür Açıklama
hesap Numaraları dize[] Hesap numaraları dizisi. Sınırlar için bkz: Komut dosyası yürütme sınırları.

Geri dönüşler

Tür Açıklama
BingAdsAccountSelector Hesap numaralarının uygulandığı seçici.

withCondition(Dize koşulu)

Hesaplara filtre ölçütleri uygular.

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

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

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

Aşağıdakiler, belirtebileceğiniz performans ölçümleri sütunlarıdır.

Sütun Tür Örnek Microsoft Advertising web kullanıcı arabirimi filtresi
Tıklama Dönüşüm Oranı çift kişilik withCondition("ClickConversionRate > 0.25") Dönüşüm Oranı
Tıklamalar uzun withCondition("Clicks >= 33") Tıklamalar
Dönüştürülen Tıklamalar uzun withCondition("ConvertedClicks >= 10") Dönş.
Ücret çift kişilik withCondition("Cost > 3.25")

Maliyet, hesabın para birimi cinsindendir.		 Harcamak
CTR çift kişilik withCondition("Ctr > 0.05")

TO 0..1 aralığındadır, bu nedenle %5'lik bir TO için 0,05'i kullanın.		 TO (Tıklama Oranı)
İzlenimler uzun withCondition("Impressions > 10") Öğr.

Aşağıdakiler, belirtebileceğiniz hesap özellikleridir.

Sütun Tür Örnek Microsoft Advertising web kullanıcı arabirimi filtresi
Para Birimi Kodu dize Hesap tarafından kullanılan para biriminin para birimi kodu. Örneğin, Birleşik Devletler dolar için USD.

withCondition("CurrencyCode = USD")
ManagerCustomerId dize Hesapları yöneten kullanıcının müşteri kimliği.

withCondition("ManagerCustomerId = '123456789'")
Name dize Yönetilen hesabın adı.

withCondition("Name CONTAINS_IGNORE_CASE 'foo'")

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
BingAdsAccountSelector Uygulanan koşulla seçici.

withIds(string[] ids)

Belirtilen kimliklere sahip hesapları 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 hesabını seçer.

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

Bağımsız değişkenler

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

Geri dönüşler

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

withLimit(int limit)

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

Bağımsız değişkenler

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

Geri dönüşler

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

Ayrıca bkz.

  • Last updated on