ชื่อทรัพยากร

ลําดับชั้นของชื่อ

ชื่อทรัพยากรที่ใช้ใน Search Ads 360 Reporting API จะเป็นแบบลำดับชั้น ซึ่งจำลองการจัดระเบียบของเอนทิตีภายใน Search Ads 360 ทรัพยากรเกือบทั้งหมดเป็นทรัพยากรย่อยของทรัพยากร Customer ซึ่งแสดงถึงความจริงที่ว่าการเรียก API เกือบทุกรายการต้องกำหนดเป้าหมายไปยังบัญชี Search Ads 360 ที่เฉพาะเจาะจง ตัวอย่างเช่น แคมเปญ กลุ่มโฆษณา โฆษณา และคีย์เวิร์ดล้วนเป็นทรัพยากรย่อยของทรัพยากรลูกค้าระดับรูท

ทรัพยากร ชื่อทรัพยากร
ลูกค้า customers/1234567890
แคมเปญ customers/1234567890/campaigns/8765432109
กลุ่มโฆษณา : customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210

รหัสทรัพยากร

เอนทิตี Search Ads 360 Reporting API (ลูกค้า แคมเปญ ฯลฯ) จะมีการเรียกด้วยชื่อทรัพยากรทั่วทั้ง API อย่างไรก็ตาม โปรดทราบว่าชื่อทรัพยากรเองอาจมีรหัสทรัพยากรที่เป็นตัวเลขที่ไม่ซ้ำกันซึ่งจะระบุออบเจ็กต์แต่ละรายการในลำดับชั้น ในกรณีเหล่านี้ คุณอาจต้องแยกวิเคราะห์ชื่อทรัพยากรเพื่อดึงรหัสทรัพยากรเหล่านี้ออกมาและรวบรวมรหัสใหม่

ตัวอย่างเช่น ให้ตรวจสอบชื่อทรัพยากร AdGroupAd จากตารางก่อนหน้า

customers/1234567890/adGroupAds/54321098765~2109876543210

ซึ่งสามารถแยกออกเป็นรหัสทรัพยากรแต่ละรายการ (คั่นด้วยรหัสคอลเล็กชัน) ดังนี้

คอมโพเนนต์ชื่อทรัพยากร
รหัสทรัพยากร
รหัสลูกค้า:
"1234567890"
รหัสกลุ่มโฆษณา
"54321098765"
รหัสโฆษณาของกลุ่มโฆษณา:
"2109876543210"
รหัสคอลเล็กชัน
"customers"
"adGroupAds"

การแยกวิเคราะห์รหัสแต่ละรายการช่วยให้คุณสร้างชื่อทรัพยากรใหม่เพื่ออ้างอิงลูกค้าของโฆษณากลุ่มโฆษณา (customers/1234567890) หรือกลุ่มโฆษณา (customers/1234567890/adGroupAds/54321098765) ได้