ลําดับชั้นของชื่อ
ชื่อทรัพยากรที่ใช้ใน Google Ads API จะเป็นลําดับชั้น ซึ่งแสดงถึงการจัดระเบียบเอนทิตีภายใน Google Ads ทรัพยากรเกือบทั้งหมดเป็นทรัพยากรย่อยของทรัพยากร Customer ซึ่งแสดงให้เห็นว่าการเรียก API เกือบทุกรายการต้องกําหนดเป้าหมายไปยังบัญชี Google Ads ที่เฉพาะเจาะจง ตัวอย่างเช่น แคมเปญ กลุ่มโฆษณา โฆษณา และคีย์เวิร์ดล้วนเป็นทรัพยากรย่อยของทรัพยากรลูกค้าระดับรูท
| ทรัพยากร | ชื่อทรัพยากร |
|---|---|
| ลูกค้า | customers/1234567890
|
| แคมเปญ | customers/1234567890/campaigns/8765432109
|
| กลุ่มโฆษณา : | 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 พื้นฐานเดียวกันนี้ แต่ชื่อทรัพยากรจะสัมพันธ์กับบัญชีที่ใช้เข้าถึง