ลำดับชั้นของชื่อ
ชื่อทรัพยากรที่ใช้ใน 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
ซึ่งคุณแบ่งออกได้เป็นรหัสทรัพยากรแต่ละรายการ (คั่นด้วยรหัสคอลเล็กชัน) ดังนี้
คอมโพเนนต์ชื่อทรัพยากร | |||||||
---|---|---|---|---|---|---|---|
รหัสทรัพยากร |
|
||||||
รหัสคอลเล็กชัน |
|
การแยกวิเคราะห์รหัสส่วนบุคคลจะช่วยให้คุณสามารถดึงข้อมูลชื่อทรัพยากรใหม่เพื่ออ้างอิง
ลูกค้าของโฆษณาของกลุ่มโฆษณา (customers/1234567890
) หรือกลุ่มโฆษณา
(customers/1234567890/adGroupAds/54321098765
)