ลำดับชั้นของชื่อ
ชื่อทรัพยากรที่ใช้ใน Google Ads API เป็นแบบลำดับชั้น ซึ่งจำลองการจัดระเบียบของเอนทิตีภายใน Google Ads ทรัพยากรเกือบทั้งหมดเป็นทรัพยากรย่อยของทรัพยากร Customer ซึ่งสะท้อนให้เห็นความจริงที่ว่าการเรียก API เกือบทุกรายการต้องกำหนดเป้าหมายบัญชี Google Ads บัญชีใดบัญชีหนึ่ง เช่น แคมเปญ กลุ่มโฆษณา โฆษณา และคีย์เวิร์ดเป็นทรัพยากรย่อยทั้งหมดของทรัพยากรลูกค้าระดับรูท
| ทรัพยากร | ชื่อทรัพยากร |
|---|---|
| ลูกค้า | customers/1234567890
|
| แคมเปญ | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
รหัสทรัพยากร
เอนทิตี Google Ads (ลูกค้า แคมเปญ ฯลฯ) จะกล่าวถึงด้วยชื่อทรัพยากรตลอด API อย่างไรก็ตาม โปรดทราบว่าชื่อทรัพยากรเองอาจมีรหัสทรัพยากรที่เป็นตัวเลขที่ไม่ซ้ำกันซึ่งจะระบุออบเจ็กต์แต่ละรายการในลำดับชั้น ในกรณีเหล่านี้ การแยกวิเคราะห์ชื่อทรัพยากรเพื่อดึงรหัสทรัพยากรเหล่านี้และประกอบรหัสใหม่อาจเป็นประโยชน์
เช่น ตรวจสอบชื่อทรัพยากร AdGroupAd จากตารางก่อนหน้า ดังนี้
customers/1234567890/adGroupAds/54321098765~2109876543210
ซึ่งคุณแบ่งออกได้เป็นรหัสทรัพยากรแต่ละรายการ (คั่นด้วยรหัสคอลเล็กชัน) ดังนี้
| คอมโพเนนต์ชื่อทรัพยากร | |||||||
|---|---|---|---|---|---|---|---|
| รหัสทรัพยากร |
|
||||||
| รหัสคอลเล็กชัน |
|
||||||
การแยกวิเคราะห์รหัสส่วนบุคคลจะช่วยให้คุณสามารถดึงข้อมูลชื่อทรัพยากรใหม่เพื่ออ้างอิง
ลูกค้าของโฆษณาของกลุ่มโฆษณา (customers/1234567890) หรือกลุ่มโฆษณา
(customers/1234567890/adGroupAds/54321098765)
ตัวระบุของออบเจ็กต์ที่แชร์
ออบเจ็กต์ส่วนใหญ่ใน API จะเชื่อมโยงกับลูกค้า Google Ads แต่ละราย แต่ก็มีออบเจ็กต์บางประเภทที่แชร์ระหว่างหลายบัญชีได้ ในทางปฏิบัติคือสิ่งต่างๆ เช่น รายการคีย์เวิร์ดเชิงลบหรือการกระทําที่ถือเป็น Conversion ข้ามบัญชี ซึ่งมักสร้างขึ้นโดยผู้จัดการและแชร์กับบัญชีลูกค้าจํานวนมาก
ชื่อทรัพยากรของออบเจ็กต์เหล่านี้จะแตกต่างกันไปขึ้นอยู่กับบัญชีที่คุณส่งการเรียก API
ตัวอย่าง: การกระทำที่ถือเป็น Conversion ข้ามบัญชี
สมมติว่าเรามีบัญชีดูแลจัดการ 987-654-3210 ที่แชร์การกระทำที่ถือเป็น Conversion ข้ามบัญชีกับหนึ่งในบัญชีลูกค้า 123-456-7890:
การเรียก API ไปยังบัญชีดูแลจัดการเพื่ออัปเดตกรอบเวลามองย้อนกลับของการกระทำที่ถือเป็น Conversion จะอ้างอิงออบเจ็กต์ที่ใช้ร่วมกันโดยใช้ชื่อทรัพยากร: customers/9876543210/conversionActions/257733534 เป็นต้น
การเรียก API ไปยังบัญชีลูกค้าเพื่อเลือกใช้การกระทำที่ถือเป็น Conversion ที่แชร์จะเป็นการอ้างอิงโดยใช้ชื่อทรัพยากร ดังนี้
customers/1234567890/conversionActions/257733534
การกระทำนี้เป็นการกระทำที่ถือเป็น Conversion เดียวกันที่เกี่ยวข้อง แต่ชื่อทรัพยากรของการกระทำดังกล่าวสัมพันธ์กับบัญชีที่ใช้เข้าถึงการกระทำนั้น