BingAdsAccountSelector

ประกอบด้วยวิธีการกรองและการจัดลําดับรายการของบัญชีที่ผู้ใช้มีสิทธิ์เข้าถึง สําหรับข้อมูลเกี่ยวกับตัวเลือก ดูตัวเลือก

การใช้งานตัวอย่าง:

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

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

วิธี

ชื่อเมธอด	ชนิดการส่งกลับ	คำอธิบาย
executeInParallel(string functionName, string optionalCallbackFunctionName)	โมฆะ	ดําเนินการฟังก์ชันสําหรับแต่ละบัญชีที่ตัวเลือกส่งกลับ
executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput)	โมฆะ	ดําเนินการฟังก์ชันสําหรับแต่ละบัญชีที่ตัวเลือกส่งกลับ
forDateRange(Object dateFrom, Object dateTo)	BingAdsAccountSelector	ใช้วันที่เริ่มต้นและวันที่สิ้นสุดสําหรับการเลือกเมตริกประสิทธิภาพการทํางาน
forDateRange(สตริง dateRange)	BingAdsAccountSelector	ใช้ช่วงวันที่ที่กําหนดไว้ล่วงหน้าสําหรับการเลือกเมตริกประสิทธิภาพการทํางาน
รับ	BingAdsAccountIterator	รับตัวทําซ้ําที่ใช้ในการทําซ้ําผ่านรายการของบัญชี
orderBy(string orderBy)	BingAdsAccountSelector	ใช้การเรียงลําดับที่ระบุกับบัญชีที่เลือก
withAccountNumbers(string[] accountNumbers)	BingAdsAccountSelector	รับบัญชีด้วยหมายเลขบัญชีที่ระบุ
withCondition(เงื่อนไขสตริง)	BingAdsAccountSelector	ใช้เงื่อนไขตัวกรองกับบัญชี
withIds(string[] ids)	BingAdsAccountSelector	รับบัญชีที่มีรหัสที่ระบุ
withLimit(ขีดจํากัด Int)	BingAdsAccountSelector	เรียกดูบัญชี n อันดับแรกที่ตรงกับเกณฑ์การเลือก

executeInParallel(string functionName, string optionalCallbackFunctionName)

ดําเนินการฟังก์ชันสําหรับแต่ละบัญชีที่ตัวเลือกส่งกลับ หลังจากฟังก์ชันถูกดําเนินการสําหรับบัญชีที่เลือกทั้งหมด สคริปต์จะเรียกใช้ฟังก์ชันเรียกกลับที่เลือกได้

หมายเหตุ

สคริปต์อาจดําเนินการสูงสุด 50 บัญชีในแบบขนานแต่ละครั้งที่เรียกใช้สคริปต์ คุณสามารถเรียกเมธอดนี้ได้หนึ่งครั้งหรือหลายครั้ง แต่จํานวนบัญชีผู้ใช้ทั้งหมดที่เรียกกระบวนการเรียกทั้งหมดต้องไม่เกิน 50 ถ้าการเรียกเกินบัญชี 50 สูงสุดสําหรับสคริปต์ ไม่มีบัญชีใดในการเรียกจะถูกดําเนินการ หากต้องการจํากัดจํานวนบัญชีที่ตัวเลือกส่งกลับ ให้พิจารณาการใช้withLimitวิธีการ หรือwithIds

ฟังก์ชัน functionName อาจส่งกลับค่าเป็นสตริง เมื่อต้องการส่งกลับวัตถุที่ซับซ้อน ให้ใช้เมธอด JSON.stringify เพื่อแปลงวัตถุเป็นสตริง จากนั้นคุณสามารถใช้เมธอด JSON.parse เพื่อแปลงสตริงกลับเป็นวัตถุได้ ถ้าฟังก์ชันของคุณส่งกลับค่า คุณต้องระบุฟังก์ชันเรียกกลับเพื่อจับค่าที่ส่งกลับ ต่อไปนี้แสดงลายเซ็นของฟังก์ชันการเรียกกลับ ค่าที่ส่งกลับจะถูกส่งผ่านเป็นอาร์เรย์ของวัตถุ ExecutionResult

function myCallback(ExecutionResult[] results)

ตัวอย่างต่อไปนี้แสดงวิธีการประมวลผลค่าที่ส่งกลับในฟังก์ชันเรียกกลับ

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

เนื่องจากวิธีนี้ไม่ส่งกลับวัตถุ BingAdsAccountSelector ตรวจสอบให้แน่ใจว่าวิธีนี้เป็นเมธอดตัวเลือกสุดท้ายในสายการเรียก

ตัวอย่างเช่น ดูการค้นพบโฆษณาที่ไม่ได้รับอนุมัติ

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
functionName	สาย อักขระ	ชื่อของฟังก์ชันที่จะดําเนินการสําหรับแต่ละบัญชีที่ตัวเลือกส่งกลับ เมธอด currentAccount ระบุบัญชีที่ฟังก์ชันกําลังประมวลผล
optionalCallbackFunctionName	สาย อักขระ	เสริม ชื่อของฟังก์ชันที่จะดําเนินการหลังจากที่บัญชีทั้งหมดเสร็จสิ้นการดําเนินการฟังก์ชัน functionName ฟังก์ชันนี้ดําเนินการเพียงครั้งเดียว

กลับ

ชนิด	คำอธิบาย
โมฆะ	ไม่ส่งกลับอะไรเลย

executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput)

ดําเนินการฟังก์ชันสําหรับแต่ละบัญชีที่ตัวเลือกส่งกลับ หลังจากฟังก์ชันดําเนินการสําหรับบัญชีที่เลือกทั้งหมด สคริปต์จะเรียกใช้ฟังก์ชันเรียกกลับที่เลือกได้

หมายเหตุ

สคริปต์อาจดําเนินการสูงสุด 50 บัญชีในแบบขนานแต่ละครั้งที่เรียกใช้สคริปต์ คุณสามารถเรียกเมธอดนี้ได้หนึ่งครั้งหรือหลายครั้ง แต่จํานวนบัญชีผู้ใช้ทั้งหมดที่เรียกกระบวนการเรียกทั้งหมดต้องไม่เกิน 50 ถ้าการเรียกเกินบัญชี 50 สูงสุดสําหรับสคริปต์ ไม่มีบัญชีใดในการเรียกจะถูกดําเนินการ หากต้องการจํากัดจํานวนบัญชีที่ตัวเลือกส่งกลับ ให้พิจารณาการใช้withLimitวิธีการ หรือwithIds

ฟังก์ชัน functionName อาจส่งกลับค่าเป็นสตริง เมื่อต้องการส่งกลับวัตถุที่ซับซ้อน ให้ใช้เมธอด JSON.stringify เพื่อแปลงวัตถุเป็นสตริง จากนั้นคุณสามารถใช้เมธอด JSON.parse เพื่อแปลงสตริงกลับเป็นวัตถุได้ ถ้าฟังก์ชันของคุณส่งกลับค่า คุณต้องระบุฟังก์ชันเรียกกลับเพื่อจับค่าที่ส่งกลับ ต่อไปนี้แสดงลายเซ็นของฟังก์ชันการเรียกกลับ ค่าที่ส่งกลับจะถูกส่งผ่านเป็นอาร์เรย์ของวัตถุ ExecutionResult

function myCallback(ExecutionResult[] results)

ตัวอย่างต่อไปนี้แสดงวิธีการประมวลผลค่าที่ส่งกลับในฟังก์ชันเรียกกลับ

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

ถ้าคุณส่งผ่านพารามิเตอร์การป้อนข้อมูลที่เลือกได้ รายการต่อไปนี้จะแสดงลายเซ็นของฟังก์ชัน functionName

function myFunction(string optionalInput)

เนื่องจากวิธีนี้ไม่ส่งกลับวัตถุ BingAdsAccountSelector ตรวจสอบให้แน่ใจว่าวิธีนี้เป็นเมธอดตัวเลือกสุดท้ายในสายการเรียก

ตัวอย่างเช่น ดูการค้นพบโฆษณาที่ไม่ได้รับอนุมัติ

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
functionName	สาย อักขระ	ชื่อของฟังก์ชันที่จะดําเนินการสําหรับแต่ละบัญชีที่ตัวเลือกส่งกลับ เมธอด currentAccount ระบุบัญชีที่ฟังก์ชันกําลังประมวลผล
optionalCallbackFunctionName	สาย อักขระ	เสริม ชื่อของฟังก์ชันที่จะดําเนินการหลังจากที่บัญชีทั้งหมดเสร็จสิ้นการดําเนินการฟังก์ชัน functionName ฟังก์ชันนี้ดําเนินการเพียงครั้งเดียว
optionalInput	สาย อักขระ	เสริม ข้อมูลป้อนเข้าเพื่อส่งผ่านไปยังฟังก์ชัน functionName

กลับ

ชนิด	คำอธิบาย
โมฆะ	ไม่ส่งกลับอะไรเลย

forDateRange(Object dateFrom, Object dateTo)

ใช้วันที่เริ่มต้นและวันที่สิ้นสุดสําหรับการเลือกเมตริกประสิทธิภาพการทํางาน

ระบุช่วงวันที่เฉพาะเมื่อ:

• คุณใช้เงื่อนไขหรือการจัดลําดับที่อ้างอิงเขตข้อมูลเมตริกประสิทธิภาพการทํางาน
• คุณต้องการรับข้อมูลประสิทธิภาพการทํางานสําหรับวัตถุที่คุณกําลังเลือก ตัวอย่างเช่น หากคุณวางแผนที่จะเรียกใช้ getStats() วิธีการ

คุณสามารถระบุพารามิเตอร์วันที่โดยใช้สตริงหรือวัตถุได้ เมื่อต้องการใช้สตริง ให้ระบุวันที่ในแบบฟอร์ม YYYYMMDD ถ้าคุณใช้วัตถุ ให้สร้างวัตถุที่มีเขตข้อมูลต่อไปนี้:

• ปี
• เดือน
• วัน

ตัวอย่างเช่น:

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

เดือนจะเป็นแบบหนึ่งโดยที่ 1 คือมกราคมและ 12 คือธันวาคม

ช่วงวันที่รวมอยู่ด้วย ถ้าคุณระบุช่วงวันที่หลายช่วง จะใช้ช่วงวันที่ล่าสุดเท่านั้น

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
dateFrom	วัตถุ	วันที่เริ่มต้นของช่วงวันที่ที่ระบุข้อมูลประสิทธิภาพการทํางานที่จะรวมไว้ในตัวเลือก
dateTo	วัตถุ	วันที่สิ้นสุดของช่วงวันที่ที่ระบุข้อมูลประสิทธิภาพการทํางานที่จะรวมไว้ในตัวเลือก

กลับ

ชนิด	คำอธิบาย
BingAdsAccountSelector	ตัวเลือกที่มีการใช้ช่วงวันที่

forDateRange(String dateRange)

ใช้ช่วงวันที่ที่กําหนดไว้ล่วงหน้าสําหรับการเลือกเมตริกประสิทธิภาพการทํางาน

ค่าช่วงวันที่ที่สนับสนุน:

• วันนี้
• เมื่อวานนี้
• 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

ระบุช่วงวันที่เฉพาะเมื่อ:

• คุณใช้เงื่อนไขหรือการจัดลําดับที่อ้างอิงเขตข้อมูลเมตริกประสิทธิภาพการทํางาน
• คุณต้องการรับข้อมูลประสิทธิภาพการทํางานสําหรับวัตถุที่คุณกําลังเลือก ตัวอย่างเช่น หากคุณวางแผนที่จะเรียกใช้ getStats() วิธีการ

ถ้าคุณระบุช่วงวันที่หลายช่วง จะใช้ช่วงวันที่ล่าสุดเท่านั้น

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
dateRange	สตริง	สตริงช่วงวันที่ที่กําหนดไว้ล่วงหน้าที่ระบุข้อมูลประสิทธิภาพการทํางานที่จะรวมไว้ในตัวเลือก สตริงช่วงวันที่ที่กําหนดไว้ล่วงหน้าต้องตรงตามตัวพิมพ์ใหญ่-เล็ก

กลับ

ชนิด	คำอธิบาย
BingAdsAccountSelector	ตัวเลือกที่มีการใช้ช่วงวันที่

รับ

รับ ตัวทําซ้ํา ที่ใช้ในการทําซ้ําผ่านรายการของบัญชี

กลับ

ชนิด	คำอธิบาย
BingAdsAccount	ตัวทําซ้ําที่ใช้เพื่อทําซ้ําผ่านบัญชีที่เลือก

orderBy(string orderBy)

ใช้การเรียงลําดับที่ระบุกับบัญชีที่เลือก

ระบุพารามิเตอร์ orderBy ในแบบฟอร์ม "columnName orderDirection" ที่:

• columnName เป็นหนึ่งในคอลัมน์ที่ได้รับการสนับสนุน
• orderDirection คือลําดับการเรียงลําดับผลลัพธ์ ตั้งค่าเป็น ASC เพื่อเรียงลําดับผลลัพธ์จากน้อยไปหามากหรือ DESC เพื่อเรียงลําดับผลลัพธ์จากมากไปหาน้อย ค่าเริ่มต้นคือ ASC

ตัวอย่างเช่น การเรียกต่อไปนี้จะส่งกลับผลลัพธ์จากน้อยไปหามากโดยการคลิก

selector = selector.orderBy("Clicks");

ตัวเลือกสนับสนุนการจัดลําดับเอนทิตีตามเขตข้อมูลเดียวเท่านั้น คุณไม่สามารถจัดลําดับรายการของเอนทิตีตามเขตข้อมูล x และภายใน x ตามเขตข้อมูล y และอื่น ๆ ถ้าคุณระบุการเรียกมากกว่าหนึ่งorderBy()ครั้งในสายโซ่ หรือในการเรียกตัวเลือกที่แยกต่างหาก Scripts จะจัดลําดับรายการของเอนทิตีโดยใช้เขตข้อมูลที่ระบุในการเรียกใช้ครั้งล่าสุดorderBy() 

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
orderBy	สาย อักขระ	การเรียงลําดับที่จะนําไปใช้

กลับ

ชนิด	คำอธิบาย
BingAdsAccountSelector	ตัวเลือกที่มีการใช้การจัดลําดับ

withAccountNumbers(string[] accountNumbers)

รับบัญชีด้วยหมายเลขบัญชีที่ระบุ

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
accountNumbers	string[]	อาร์เรย์ของหมายเลขบัญชี สําหรับขีดจํากัด ดูขีดจํากัดการดําเนินการสคริปต์

กลับ

ชนิด	คำอธิบาย
BingAdsAccountSelector	ตัวเลือกที่ใช้หมายเลขบัญชี

withCondition(เงื่อนไขสตริง)

ใช้เงื่อนไขตัวกรองกับบัญชี

ระบุพารามิเตอร์ เงื่อนไข ในแบบฟอร์ม "ค่าตัวดําเนินการ columnName" ที่:

• columnName เป็นหนึ่งในคอลัมน์ที่ได้รับการสนับสนุน ถ้า columName ถูกตั้งค่าเป็นชื่อคอลัมน์เมตริกประสิทธิภาพการทํางาน คุณต้องระบุช่วงวันที่โดยใช้ forDateRange(String dateRange) หรือ forDateRange(Object dateFrom, Object dateTo)
• ตัวดําเนินการ เป็นหนึ่งใน ตัวดําเนินการที่ได้รับการสนับสนุน

ผู้ ประกอบการ

ตัวดําเนินการที่คุณใช้ขึ้นอยู่กับชนิดของคอลัมน์ ตัวดําเนินการต้องตรงตามตัวพิมพ์ใหญ่-เล็ก ตัวอย่างเช่น ใช้ STARTS_WITH แทน starts_with

ตัวดําเนินการสําหรับคอลัมน์ที่มีจํานวนเต็มและค่ายาว:

<
<=
>
>=
=
!=

ตัวดําเนินการสําหรับคอลัมน์ที่มีค่าสองค่า:

<
>

ตัวดําเนินการสําหรับคอลัมน์ที่มีค่าสตริง:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

ตัวดําเนินการสําหรับคอลัมน์ที่มีค่าการแจงนับ:

=
!=
IN []
NOT_IN []

ตัวดําเนินการสําหรับคอลัมน์ที่มีอาร์เรย์ของสตริง:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

คอลัมน์ที่ได้รับการสนับสนุนสําหรับการกรองบัญชี ชื่อคอลัมน์ต้องตรงตามตัวพิมพ์ใหญ่-เล็ก

ต่อไปนี้คือคอลัมน์เมตริกประสิทธิภาพการทํางานที่คุณอาจระบุ

คอลัมน์	ชนิด	ตัว อย่าง เช่น	ตัวกรอง UI เว็บโฆษณาของ Microsoft
ClickConversionRate	คู่	withCondition("ClickConversionRate > 0.25")	อัตรารวม
คลิ ก	ยาว	withCondition("Clicks >= 33")	คลิ ก
ConvertedClicks	ยาว	withCondition("ConvertedClicks >= 10")	รวมรายการ
ต้น ทุน	คู่	withCondition("Cost > 3.25") ต้นทุนอยู่ในสกุลเงินของบัญชี	ใช้
Ctr	คู่	withCondition("Ctr > 0.05") CTR อยู่ในช่วง 0..1 ดังนั้นให้ใช้ 0.05 สําหรับ 5% CTR	Ctr
อิมเพรสชัน	ยาว	withCondition("Impressions > 10")	Impr.

ต่อไปนี้คือคุณสมบัติบัญชีผู้ใช้ที่คุณอาจระบุ

คอลัมน์	ชนิด	ตัว อย่าง เช่น	ตัวกรอง UI เว็บโฆษณาของ Microsoft
CurrencyCode	สาย อักขระ	รหัสสกุลเงินของสกุลเงินที่ใช้โดยบัญชี ตัวอย่างเช่น USD สําหรับดอลลาร์สหรัฐ withCondition("CurrencyCode = USD")
ManagerCustomerId	สาย อักขระ	รหัสลูกค้าของผู้ใช้ที่จัดการบัญชี withCondition("ManagerCustomerId = '123456789'")
ชื่อ	สาย อักขระ	ชื่อของบัญชีผู้ใช้ที่มีการจัดการ withCondition("Name CONTAINS_IGNORE_CASE 'foo'")

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
เงื่อนไข	สาย อักขระ	เงื่อนไขที่จะเพิ่มลงในตัวเลือก

กลับ

ชนิด	คำอธิบาย
BingAdsAccountSelector	ตัวเลือกที่มีการใช้เงื่อนไข

withIds(string[] ids)

รับบัญชีที่มีรหัสที่ระบุ

คุณอาจใช้เงื่อนไขอย่างน้อยหนึ่งข้อกับตัวเลือก ห่วงโซ่ของเงื่อนไขถือว่าเป็นการดําเนินการ AND ตัวอย่างเช่น เอนทิตีจะถูกเลือกเฉพาะเมื่อเงื่อนไข A เป็นจริงและเงื่อนไข B เป็นจริง ตัวอย่างเช่น การเรียกใช้ต่อไปนี้เลือกเฉพาะบัญชี 33333 เท่านั้น

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

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
รหัส	string[]	อาร์เรย์ของรหัสบัญชี สําหรับขีดจํากัด ดูขีดจํากัดการดําเนินการสคริปต์

กลับ

ชนิด	คำอธิบาย
BingAdsAccountSelector	ตัวเลือกที่มีการใช้รหัส

withLimit(ขีดจํากัด Int)

เรียกดูบัญชี n อันดับแรกที่ตรงกับเกณฑ์การเลือก

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
จำกัด	Int	จํานวนบัญชีที่จะส่งคืน ตัวเลขจริงอาจน้อยกว่า

กลับ

ชนิด	คำอธิบาย
BingAdsAccountSelector	ตัวเลือกที่มีการใช้ขีดจํากัด

ดูเพิ่มเติม

• AccountsApp.accounts()
• BingAdsAccountIterator
• การเข้าถึงแบบหลายบัญชี