AdsApp

นี่คือวัตถุระดับบนสุดที่ใช้เพื่อเข้าถึงและจัดการบัญชีเดียว

หมายเหตุ

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

วิธีการ

ชื่อวิธี ชนิดการส่งคืน คำอธิบาย
adgroups AdGroupSelector ใช้ ตัวเลือก เพื่อกรองรายการกลุ่มโฆษณาในบัญชีนี้
โฆษณา AdSelector ใช้ ตัวเลือก เพื่อกรองรายการโฆษณาในบัญชีนี้
งบประมาณ BudgetSelector รับ ตัวเลือกที่ใช้ ในการกรองรายการงบประมาณที่ใช้ร่วมกันในบัญชีนี้
แคมเปญ CampaignSelector ใช้ตัวเลือกเพื่อกรองรายการแคมเปญในบัญชีนี้
createLabel(string name, string description, string backgroundColor) เป็นโมฆะ สร้างป้ายชื่อ
บัญชีปัจจุบัน บัญชี รับบัญชีที่สคริปต์กําลังประมวลผลอยู่ในขณะนี้
getExecutionInfo ExecutionInfo ส่งกลับข้อมูลเกี่ยวกับสภาพแวดล้อมที่สคริปต์กําลังดําเนินการอยู่
คําสําคัญ KeywordSelector ใช้ตัวเลือกเพื่อกรองรายการคําสําคัญในบัญชีนี้
ป้ายชื่อ LabelSelector ใช้ ตัวเลือก เพื่อกรองรายการป้ายกํากับในบัญชีนี้
negativeKeywordLists NegativeKeywordListSelector ใช้ตัวเลือกเพื่อกรองรายการคําสําคัญเชิงลบในบัญชีนี้
newNegativeKeywordListBuilder NegativeKeywordListBuilder มีตัวสร้างที่ใช้ในการเพิ่มรายการคําสําคัญเชิงลบลงในบัญชีนี้
performanceMaxCampaigns CampaignSelector ใช้ตัวเลือกในการกรองรายการแคมเปญ Performance Max ในบัญชีนี้
productGroups ProductGroupSelector ใช้ตัวเลือกเพื่อกรองรายการกลุ่มผลิตภัณฑ์ในบัญชีนี้
shoppingAdGroups AdGroupSelector รับตัวเลือกที่ใช้ในการกรองรายการกลุ่มโฆษณาที่ใช้สําหรับการช้อปปิ้งในบัญชีนี้
shoppingCampaigns CampaignSelector ใช้ตัวเลือกเพื่อกรองรายการแคมเปญที่ใช้สําหรับการช้อปปิ้งในบัญชีนี้
userLists UserListSelector ใช้ตัวเลือกเพื่อกรองรายการของผู้ใช้ในบัญชีนี้

adgroups

ใช้ ตัวเลือก เพื่อกรองรายการกลุ่มโฆษณาในบัญชีนี้

ส่งกลับ

พิมพ์ คำอธิบาย
AdGroupSelector ตัวเลือกที่ใช้ในการกรองรายการกลุ่มโฆษณาในบัญชีปัจจุบัน

โฆษณา

ใช้ ตัวเลือก เพื่อกรองรายการโฆษณาในบัญชีนี้

ส่งกลับ

พิมพ์ คำอธิบาย
AdSelector ตัวเลือกที่ใช้ในการกรองรายการโฆษณาในบัญชีปัจจุบัน

งบประมาณ

รับ ตัวเลือกที่ใช้ ในการกรองรายการงบประมาณที่ใช้ร่วมกันในบัญชีนี้

วิธีนี้จะส่งกลับเฉพาะงบประมาณที่แชร์เท่านั้น หากต้องการรับงบประมาณที่ไม่ได้แชร์ (แคมเปญแต่ละรายการ) ให้เรียกหาวิธี getBudget ของแคมเปญเฉพาะ งบประมาณของแคมเปญจะไม่ถูกแชร์หากวิธีการส่งisExplicitlySharedกลับเป็นเท็จ

ส่งกลับ

พิมพ์ คำอธิบาย
BudgetSelector ตัวเลือกที่ใช้ในการกรองรายการงบประมาณที่ใช้ร่วมกันในบัญชีปัจจุบัน

แคมเปญ

ใช้ ตัวเลือก เพื่อกรองรายการแคมเปญในบัญชีนี้

ส่งกลับ

พิมพ์ คำอธิบาย
CampaignSelector ตัวเลือกที่ใช้ในการกรองรายการแคมเปญในบัญชีปัจจุบัน

createLabel(string name, string description, string backgroundColor)

สร้างป้ายชื่อ

สําหรับขีดจํากัดของจํานวนป้ายชื่อที่คุณอาจจะสร้างต่อ บัญชี ให้ดูขีดจํากัด สําหรับตัวอย่างที่เพิ่มป้ายชื่อให้กับบัญชี ให้ดู การใช้ป้ายชื่อ

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

ชื่อ พิมพ์ คำอธิบาย
backgroundColor สตริง ไม่บังคับ สีพื้นหลังเพื่อใช้ใน UX สําหรับป้ายชื่อ คุณสามารถระบุสีได้โดยใช้:
  • เลขฐานสิบหกสามไบต์ในรูปแบบ #RRGGBB ตัวอย่างเช่น #CB0400
  • หนึ่งในชื่อสี CSS ที่รู้จักทั้ง 16 ชื่อ ตัวอย่างเช่น น้ําทะเล สีเหลือง และสีโคมญี่ปุ่น
พิจารณาความสามารถในการเข้าถึงเมื่อเลือกสี ถ้าไม่ได้ระบุ ระบบจะเลือกสีแบบสุ่มให้กับคุณ
คําอธิบาย สตริง ไม่บังคับ คําอธิบายที่อธิบายการใช้งานของป้ายชื่อ ขนาดสูงสุดคือ 200 อักขระ

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

ส่งกลับ

พิมพ์ คำอธิบาย
เป็นโมฆะ ไม่ส่งกลับค่าใดๆ

บัญชีปัจจุบัน

รับบัญชีที่สคริปต์กําลังประมวลผลอยู่ในขณะนี้

หมายเหตุ

เมื่อต้องการใช้วิธีนี้ในสถานการณ์แบบหลายบัญชี อันดับแรกให้เลือกบัญชีที่จะจัดการ ถ้าคุณเรียกใช้วิธีนี้ก่อนที่จะเลือกบัญชี การโทรจะส่งกลับค่า Null

ส่งกลับ

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

getExecutionInfo

ส่งกลับข้อมูลเกี่ยวกับสภาพแวดล้อมที่สคริปต์กําลังดําเนินการอยู่

ส่งกลับ:

พิมพ์ คำอธิบาย
ExecutionInfo ข้อมูลเกี่ยวกับสภาพแวดล้อมที่สคริปต์กําลังดําเนินการอยู่

คําสําคัญ

ใช้ ตัวเลือก เพื่อกรองรายการคําสําคัญในบัญชีนี้

ส่งกลับ

พิมพ์ คำอธิบาย
KeywordSelector ตัวเลือกที่ใช้กรองรายการคําสําคัญในบัญชีปัจจุบัน

ป้ายชื่อ

ใช้ ตัวเลือก เพื่อกรองรายการป้ายกํากับในบัญชีนี้

ส่งกลับ

พิมพ์ คำอธิบาย
LabelSelector ตัวเลือกที่ใช้ในการกรองรายการป้ายชื่อในบัญชีปัจจุบัน

negativeKeywordLists

ใช้ ตัวเลือก เพื่อกรองรายการคําสําคัญเชิงลบในบัญชีนี้

ส่งกลับ

พิมพ์ คำอธิบาย
NegativeKeywordListSelector ตัวเลือกที่ใช้ในการกรองรายการคําสําคัญเชิงลบในบัญชีปัจจุบัน

newNegativeKeywordListBuilder

มี ตัวสร้าง ที่ใช้ในการเพิ่มรายการคําสําคัญเชิงลบลงในบัญชีนี้

ส่งกลับ

พิมพ์ คำอธิบาย
NegativeKeywordListBuilder เครื่องมือสร้างใช้เพื่อเพิ่มรายการคําสําคัญเชิงลบลงในบัญชีปัจจุบัน

performanceMaxCampaigns

รับ ตัวเลือกที่ใช้ ในการกรองรายการแคมเปญที่ใช้สําหรับ Performance Max ในบัญชีนี้

ส่งกลับ

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

productGroups

ใช้ ตัวเลือก เพื่อกรองรายการกลุ่มผลิตภัณฑ์ในบัญชีนี้

ส่งกลับ

พิมพ์ คำอธิบาย
ProductGroupSelector ตัวเลือกที่ใช้ในการกรองรายการกลุ่มผลิตภัณฑ์ในบัญชีปัจจุบัน

shoppingAdGroups

รับ ตัวเลือกที่ใช้ ในการกรองรายการกลุ่มโฆษณาที่ใช้สําหรับการช้อปปิ้งในบัญชีนี้

ส่งกลับ

พิมพ์ คำอธิบาย
AdGroupSelector ตัวเลือกที่ใช้เพื่อกรองรายการกลุ่มโฆษณาที่ใช้สําหรับการช้อปปิ้งในบัญชีปัจจุบัน

shoppingCampaigns

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

ส่งกลับ

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

userLists

ใช้ ตัวเลือกเพื่อ กรองรายการของผู้ใช้ในบัญชีนี้

ส่งกลับ

พิมพ์ คำอธิบาย
UserListSelector ตัวเลือกที่ใช้ในการกรองรายการของผู้ใช้ในบัญชีปัจจุบัน

ดูเพิ่มเติม

การเข้าถึงบัญชีผู้ใช้เดียว