ลำดับชั้นของชื่อ
ชื่อทรัพยากรที่ใช้ใน 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
ซึ่งสามารถแบ่งออกเป็นรหัสทรัพยากรแต่ละรายการ (คั่นด้วย รหัสคอลเล็กชัน) ดังนี้
| คอมโพเนนต์ชื่อทรัพยากร | |||||||
|---|---|---|---|---|---|---|---|
| รหัสทรัพยากร |
|
||||||
| รหัสคอลเล็กชัน |
|
||||||
การแยกวิเคราะห์ ID แต่ละรายการจะให้คุณดึงข้อมูลชื่อทรัพยากรใหม่ๆ มาใช้อ้างอิงได้
ลูกค้าของกลุ่มโฆษณา (customers/1234567890) หรือกลุ่มโฆษณาของกลุ่มโฆษณานั้น
(customers/1234567890/adGroupAds/54321098765)
ตัวระบุของออบเจ็กต์ที่แชร์
ออบเจ็กต์ส่วนใหญ่ใน API เชื่อมโยงกับ Google Ads ที่เฉพาะเจาะจงรายการเดียว ลูกค้า แต่ก็มีออบเจ็กต์บางประเภทที่แชร์ระหว่าง หลายบัญชี ซึ่งในทางปฏิบัติคือสิ่งต่างๆ เช่น คีย์เวิร์ดเชิงลบ items หรือข้ามบัญชี การกระทําที่ถือเป็น Conversion ที่ ซึ่งมักจะสร้างโดยผู้จัดการ แล้วแชร์กับบัญชีลูกค้าจำนวนมาก
ชื่อทรัพยากรของออบเจ็กต์เหล่านี้จะแตกต่างกัน ขึ้นอยู่กับ บัญชีที่คุณส่งการเรียก API ไปให้
ตัวอย่าง: การกระทำที่ถือเป็น Conversion ข้ามบัญชี
สมมติว่าเรามีบัญชีดูแลจัดการ 987-654-3210 ที่แชร์ข้ามบัญชี
การกระทำที่ถือเป็น Conversion ด้วยบัญชีลูกค้าบัญชีใดบัญชีหนึ่ง 123-456-7890:
การเรียก API ไปยังบัญชีดูแลจัดการเพื่ออัปเดต Conversion เป็นต้น
กรอบเวลามองย้อนกลับของการดำเนินการจะอ้างอิงออบเจ็กต์ที่แชร์โดยใช้ชื่อทรัพยากร:
customers/9876543210/conversionActions/257733534
การเรียก API ไปยังบัญชีลูกค้าเพื่อเลือกใช้
การกระทำที่ถือเป็น Conversion จะอ้างอิงการกระทำนั้นโดยใช้ชื่อทรัพยากร:
customers/1234567890/conversionActions/257733534
นี่คือการกระทำที่ถือเป็น Conversion ที่เกี่ยวข้องเดียวกัน แต่ชื่อทรัพยากรมีความเกี่ยวข้อง กับบัญชีที่ใช้ในการเข้าใช้งาน