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

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

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

ทรัพยากร ชื่อทรัพยากร
ลูกค้า customers/1234567890
แคมเปญ customers/1234567890/campaigns/8765432109
AdGroup 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)