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