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

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

ชื่อทรัพยากรที่ใช้ใน 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)