BingAdsAccountSelector
Kullanıcının erişimi olan hesap listesini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında 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ı | Dönüş Türü | Açıklama |
---|---|---|
executeInParallel(string functionName, string optionalCallbackFunctionName) | Void | Seçicinin döndürdüğü her hesap için işlevi yürütür. |
executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput) | Void | 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(string dateRange) | BingAdsAccountSelector | Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular. |
Al | BingAdsAccountIterator | Hesap listesinde yineleme yapmak için kullanılan bir yineleyici alır. |
orderBy(string 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 sınırı) | BingAdsAccountSelector | Seçim ölçütlerine uyan ilk n hesabı alır. |
executeInParallel(string functionName, string optionalCallbackFunctionName)
Seçicinin döndürdüğü her hesap için işlevi yürütür. İşlev tüm seçili hesaplar için yürütüldükten sonra Betikler isteğe bağlı geri çağırma işlevini çağırır.
Not
Betik her çalıştırıldığında paralel olarak en fazla 50 hesap yürütebilir. Bu yöntemi bir veya birden çok kez çağırabilirsiniz, ancak tüm çağrı işlemlerinin toplam hesap sayısı 50'yi geçmemelidir. Bir çağrı betik için en fazla 50 hesap sınırını aşarsa, çağrıdaki hesapların hiçbiri yürütülür. 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 JSON.stringify yöntemini kullanarak nesneyi dizeye dönüştürü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 ExecutionResult nesnelerinin dizisi olarak geçirilir.
function myCallback(ExecutionResult[] results)
Aşağıdaki örnekte geri çağırma işlevinde döndürülen değerlerin nasıl işlendiği gösterilmektedir.
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.
Bir örnek için bkz. Onaylanmamış reklamları bulma.
Bağımsız değişken
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şlemekte olduğu hesabı tanımlar. |
optionalCallbackFunctionName | Dize | Isteğe bağlı. Tüm hesaplar functionName işlevini yürütmeyi tamamladıktan sonra yürütülecek işlevin adı. Bu işlev yalnızca bir kez yürütülür. |
Döndürür
Tür | Açıklama |
---|---|
Void | 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 tüm seçili hesaplar için yürütülürken, Betikler isteğe bağlı geri çağırma işlevini çağırır.
Not
Betik her çalıştırıldığında paralel olarak en fazla 50 hesap yürütebilir. Bu yöntemi bir veya birden çok kez çağırabilirsiniz, ancak tüm çağrı işlemlerinin toplam hesap sayısı 50'yi geçmemelidir. Bir çağrı betik için en fazla 50 hesap sınırını aşarsa, çağrıdaki hesapların hiçbiri yürütülür. 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 JSON.stringify yöntemini kullanarak nesneyi dizeye dönüştürü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 ExecutionResult nesnelerinin dizisi olarak geçirilir.
function myCallback(ExecutionResult[] results)
Aşağıdaki örnekte geri çağırma işlevinde döndürülen değerlerin nasıl işlendiği gösterilmektedir.
function myCallback(results) {
for (var result of results) {
var object = JSON.parse(result.getReturnValue());
}
}
İsteğe bağlı giriş parametresini geçirirseniz, aşağıda functionName işlevinin imzası 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.
Bir örnek için bkz. Onaylanmamış reklamları bulma.
Bağımsız değişken
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şlemekte olduğu hesabı tanımlar. |
optionalCallbackFunctionName | Dize | Isteğe bağlı. Tüm hesaplar functionName işlevini yürütmeyi tamamladıktan sonra yürütülecek işlevin adı. Bu işlev yalnızca bir kez yürütülür. |
optionalInput | Dize | Isteğe bağlı. functionName işlevine geçirilebilecek giriş. |
Döndürür
Tür | Açıklama |
---|---|
Void | Hiçbir şey döndürmez. |
forDateRange(Object dateFrom, Object dateTo)
Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular.
Yalnızca aşağıdakiler için bir tarih aralığı belirtin:
- Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
- Seçtiğiniz nesnelerin performans verilerini almak istiyorsunuz. Örneğin, yöntemini çağırmayı
getStats()
planlıyorsanız.
Dizeleri veya nesneleri kullanarak tarih parametrelerini belirtebilirsiniz. Dizeleri kullanmak için YYYYMMDD biçimindeki tarihi belirtin. Nesneleri kullanıyorsanız, aşağıdaki alanlara sahip 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şken
Name | Tür | Açıklama |
---|---|---|
dateFrom | Nesne | Seçiciye eklenecek performans verilerini belirten tarih aralığının başlangıç tarihi. |
dateTo | Nesne | Seçiciye eklenecek performans verilerini belirten tarih aralığının bitiş tarihi. |
Döndürür
Tür | Açıklama |
---|---|
BingAdsAccountSelector | Tarih aralığı uygulanmış seçici. |
forDateRange(String 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
Yalnızca aşağıdakiler için bir tarih aralığı belirtin:
- Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
- Seçtiğiniz nesnelerin performans verilerini almak istiyorsunuz. Örneğin, yöntemini çağırmayı
getStats()
planlıyorsanız.
Birden çok tarih aralığı belirtirseniz, yalnızca son tarih aralığı kullanılır.
Bağımsız değişken
Name | Tür | Açıklama |
---|---|---|
dateRange | 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. |
Döndürür
Tür | Açıklama |
---|---|
BingAdsAccountSelector | Tarih aralığı uygulanmış seçici. |
Al
Hesap listesinde yineleme yapmak için kullanılan bir yineleyici alır.
Döndürür
Tür | Açıklama |
---|---|
BingAdsAccount | Seçili hesaplarda yineleme yapmak için kullanılan bir yineleyici. |
orderBy(string orderBy)
Belirtilen sıralamayı seçili hesaplara 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ı Tıklamalar'a göre sonuçları 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, 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 |
---|---|
BingAdsAccountSelector | Sıralama uygulanmış seçici. |
withAccountNumbers(string[] accountNumbers)
Belirtilen hesap numaralarına sahip hesapları alır.
Bağımsız değişken
Name | Tür | Açıklama |
---|---|---|
accountNumbers | string[] | Hesap numaraları dizisi. Sınırlar için bkz. Betik yürütme sınırları. |
Döndürür
Tür | Açıklama |
---|---|
BingAdsAccountSelector | Hesap numaralarının uygulandığı seçici. |
withCondition(Dize koşulu)
Hesaplara filtre ölçütleri uygular.
koşul parametresini şu şekilde belirtin: "columnName işleç değeri":
- columnNamedesteklenen sütunlardan biridir. columName bir performans ölçümü sütun adına ayarlandıysa, forDateRange(String dateRange) veya forDateRange(Object dateFrom, Object dateTo) kullanarak bir tarih aralığı belirtmeniz gerekir.
- işleç desteklenen işleçlerden biridir.
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
Hesap filtreleme için desteklenen sütunlar. Sütun adları büyük/küçük harfe duyarlıdır.
Aşağıda, belirteceğiniz performans ölçümleri sütunları yer alır.
Sütun | Tür | Örnek | Microsoft Advertising web kullanıcı arabirimi filtresi |
---|---|---|---|
ClickConversionRate | Çift | withCondition("ClickConversionRate > 0.25") |
Dışbükey Oran |
Tıklama | Uzun | withCondition("Clicks >= 33") |
Tıklama |
ConvertedClicks | Uzun | withCondition("ConvertedClicks >= 10") |
Dönş. |
Ücret | Çift | withCondition("Cost > 3.25") Maliyet, hesabın para birimindedir. |
Harcamak |
Ctr | Çift | withCondition("Ctr > 0.05") CTR 0..1 aralığındadır, bu nedenle %5 CTR için 0,05 kullanın. |
CTR |
Gösterim | Uzun | withCondition("Impressions > 10") |
Impr. |
Aşağıda, belirteceğiniz hesap özellikleri yer alır.
Sütun | Tür | Örnek | Microsoft Advertising web kullanıcı arabirimi filtresi |
---|---|---|---|
CurrencyCode | 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şken
Name | Tür | Açıklama |
---|---|---|
Durum | Dize | Seçiciye eklenecek koşul. |
Döndürür
Tür | Açıklama |
---|---|
BingAdsAccountSelector | Koşulun uygulandığı seçici. |
withIds(string[] ids)
Belirtilen kimliklere sahip hesapları 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 hesabını seçer.
AccountsApp.accounts()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
.get();
Bağımsız değişken
Name | Tür | Açıklama |
---|---|---|
Kimlik | string[] | Hesap kimlikleri dizisi. Sınırlar için bkz. Betik yürütme sınırları. |
Döndürür
Tür | Açıklama |
---|---|
BingAdsAccountSelector | Kimliklerin uygulandığı seçici. |
withLimit(int sınırı)
Seçim ölçütlerine uyan ilk n hesabı alır.
Bağımsız değişken
Name | Tür | Açıklama |
---|---|---|
Sınırı | Int | Döndürülecek hesap sayısı. Gerçek sayı daha az olabilir. |
Döndürür
Tür | Açıklama |
---|---|
BingAdsAccountSelector | Sınır uygulanmış seçici. |