ลำดับชั้นของชื่อ
ชื่อทรัพยากรที่ใช้ใน 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 ไปยังบัญชีดูแลจัดการเพื่ออัปเดตระยะเวลา Lookback ของการกระทําที่ถือเป็น Conversion เป็นต้น จะอ้างอิงออบเจ็กต์ที่แชร์โดยใช้ชื่อทรัพยากร:customers/9876543210/conversionActions/257733534
การเรียก API ไปยังบัญชีลูกค้าเพื่อเลือกใช้การกระทําที่ถือเป็น Conversion ที่แชร์จะอ้างอิงโดยใช้ชื่อทรัพยากร:
customers/1234567890/conversionActions/257733534
นี่คือการกระทำที่ถือเป็น Conversion พื้นฐานเดียวกัน แต่ชื่อทรัพยากรจะสัมพันธ์กับบัญชีที่ใช้เข้าถึง