ลำดับชั้นของชื่อ
ชื่อทรัพยากรที่ใช้ใน 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 พื้นฐานเดียวกัน แต่ชื่อทรัพยากรจะสัมพันธ์กับบัญชีที่ใช้เข้าถึง