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(วัตถุ dateFrom, วัตถุ dateTo)	BingAdsAccountSelector	ใช้วันที่เริ่มต้นและสิ้นสุดสําหรับการเลือกเมตริกประสิทธิภาพ
forDateRange(สตริง dateRange)	BingAdsAccountSelector	ใช้ช่วงวันที่ที่กําหนดไว้ล่วงหน้าสําหรับการเลือกเมตริกประสิทธิภาพ
รับ	BingAdsAccountIterator	รับตัวทําซ้ําที่ใช้ในการดําเนินการวนซ้ําผ่านรายการบัญชี
orderBy(สตริง orderBy)	BingAdsAccountSelector	นําการเรียงลําดับที่ระบุไปใช้กับบัญชีที่เลือก
withAccountNumbers(string[], accountNumbers)	BingAdsAccountSelector	รับบัญชีที่มีหมายเลขบัญชีที่ระบุ
withCondition(เงื่อนไขสตริง)	BingAdsAccountSelector	ใช้เกณฑ์การกรองกับลูกค้าองค์กร
withIds(string[], ids)	BingAdsAccountSelector	รับบัญชีที่มี ID ที่ระบุ
withLimit(int limit)	BingAdsAccountSelector	รับบัญชี N อันดับแรกที่ตรงกับเกณฑ์การคัดเลือก

executeInParallel(string functionName, string optionalCallbackFunctionName)

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

หมายเหตุ

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

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

function myCallback(ExecutionResult[] results)

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

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เมธอด OR withIds

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

function myCallback(ExecutionResult[] results)

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

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(วัตถุ dateFrom, วัตถุ dateTo)

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

ระบุช่วงวันที่ก็ต่อเมื่อ:

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

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

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

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

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

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

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

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

ชื่อ	พิมพ์	คำอธิบาย
วันที่จาก	วัตถุ	วันที่เริ่มต้นของช่วงวันที่ที่ระบุข้อมูลประสิทธิภาพที่จะรวมอยู่ในตัวเลือก
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() ธอด

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

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

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

ส่งกลับ

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

รับ

รับตัว ทําซ้ํา ที่ใช้ในการดําเนินการวนซ้ําผ่านรายการบัญชี

ส่งกลับ

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

orderBy(สตริง orderBy)

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

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

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

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

selector = selector.orderBy("Clicks");

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

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

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

ส่งกลับ

พิมพ์	คำอธิบาย
BingAdsAccountSelector	ตัวเลือกที่มีการเรียงลําดับ

withAccountNumbers(string[], accountNumbers)

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

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

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

ส่งกลับ

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

withCondition(String condition)

ใช้เกณฑ์การกรองกับลูกค้าองค์กร

ระบุพารามิเตอร์ เงื่อนไข ในรูปแบบ "columnName operator value" โดยที่:

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

ตัวดําเนินการ

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

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

<
<=
>
>=
=
!=

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

<
>

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

=
!=
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 Advertising
ClickConversionRate	สองเท่า	withCondition("ClickConversionRate > 0.25")	Conv. Rate
คลิก	แบบยาว	withCondition("Clicks >= 33")	คลิก
ConvertedClicks	แบบยาว	withCondition("ConvertedClicks >= 10")	Conv.
ต้นทุน	สองเท่า	withCondition("Cost > 3.25") ค่าใช้จ่ายเป็นสกุลเงินของบัญชี	การใช้จ่าย
Ctr	สองเท่า	withCondition("Ctr > 0.05") CTR อยู่ในช่วง 0..1 ดังนั้นใช้ 0.05 สําหรับ CTR 5%	CTR
ความประทับใจ	แบบยาว	withCondition("Impressions > 10")	ความหมาย

ต่อไปนี้คือคุณสมบัติของบัญชีที่คุณสามารถระบุได้

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

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

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

ส่งกลับ

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

withIds(string[], ids)

รับบัญชีที่มี ID ที่ระบุ

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

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

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

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

ส่งกลับ

พิมพ์	คำอธิบาย
BingAdsAccountSelector	ตัวเลือกที่มี ID ที่นําไปใช้

withLimit(int limit)

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

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

ชื่อ	พิมพ์	คำอธิบาย
ขีดจํากัด	int	จํานวนบัญชีที่จะส่งคืน จํานวนจริงอาจน้อยกว่า

ส่งกลับ

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

ดูเพิ่มเติม

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