การแมปช่อง

ใช้การแมปช่องเพื่ออัปเกรดแต่ละขั้นตอนของเวิร์กโฟลว์การลิงก์พาร์ทเนอร์ จาก Google Ads API ไปยัง Data Manager API ดังนี้

การแมปฟิลด์ออบเจ็กต์มีการแมปฟิลด์สำหรับทรัพยากร ที่แสดงออบเจ็กต์ลิงก์พาร์ทเนอร์
การแมปคำขอการจัดการลิงก์มีการแมปฟิลด์สำหรับ คำขอสร้างและลบลิงก์พาร์ทเนอร์
การแมปคำขอการดึงข้อมูลลิงก์มีการแมปฟิลด์สำหรับ การดึงข้อมูลลิงก์พาร์ทเนอร์

การแมปฟิลด์ออบเจ็กต์

ใช้การแมปในตารางเพื่อแมป ProductLink ใน Google Ads API กับ PartnerLink ที่เทียบเท่าใน Data Manager API

`ProductLink` (Google Ads API)	`PartnerLink` (Data Manager API)	หมายเหตุ
`advertising_partner` `data_partner` `google_ads` `merchant_center`	`partner_account`	Data Manager API ไม่มีฟิลด์แยกสำหรับบัญชีที่ลิงก์แต่ละประเภท สำหรับบัญชีทุกประเภท ให้ตั้งค่าฟิลด์ `partner_account` เป็น `ProductAccount` และตั้งค่า `account_type` และ `account_id` เป็น เพื่อระบุบัญชีที่ลิงก์
`product_link_id`	`partner_link_id`
`resource_name`	`name`	ใน Google Ads API `customer_id` ของ `resource_name` ของ `ProductLink` จะระบุว่าบัญชีใดเป็นเจ้าของลิงก์ที่มีอยู่ เมื่อสร้าง `ProductLink` คุณจะระบุเจ้าของลิงก์โดยการตั้งค่า `customer_id` ของ `CreateProductLinkRequest` ใน Data Manager API การรวมกันของ `accountType` และ `accountId` ของ `owning_account` จะระบุว่าบัญชีใดเป็นเจ้าของลิงก์ที่มีอยู่ เมื่อสร้าง `PartnerLink`, คุณจะระบุเจ้าของลิงก์โดยการตั้งค่า `name` เป็นชื่อทรัพยากรของเจ้าของ ดูรายละเอียดได้ที่ชื่อทรัพยากรและ คำขอสร้าง
`type`	`owning_account.account_type`

ชื่อทรัพยากร

Data Manager API ใช้รูปแบบชื่อทรัพยากรที่แตกต่างจาก Google Ads API

Google Ads API

ใน Google Ads API ProductLinkชื่อทรัพยากรจะใช้รูปแบบต่อไปนี้

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

ใน Data Manager API PartnerLink ชื่อทรัพยากรจะใช้รูปแบบต่อไปนี้

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

การแมปคำขอการจัดการลิงก์

ใช้การแมปคำขอในส่วนนี้เพื่อแปลงคำขอสำหรับการสร้าง การลบ และการดึงลิงก์พาร์ทเนอร์

สร้างคำขอ

ต่อไปนี้คือการแมปฟิลด์เพื่อแปลง CreateProductLinkRequest ใน Google Ads API เป็น CreatePartnerLinkRequest ที่เทียบเท่าใน Data Manager API

`CreateProductLinkRequest` (Google Ads API)	`CreatePartnerLinkRequest` (Data Manager API)	หมายเหตุ
`customer_id`	`parent`	ตั้งค่าเป็นชื่อทรัพยากรของบัญชีผู้ลงโฆษณาที่เป็นเจ้าของ
`product_link`	`partner_link`	ตั้งค่าเป็นแหล่งข้อมูล `PartnerLink` ดูการแมปฟิลด์ ออบเจ็กต์

ลบคำขอ

ต่อไปนี้คือการแมปฟิลด์เพื่อแปลง RemoveProductLinkRequest ใน Google Ads API เป็น DeletePartnerLinkRequest ที่เทียบเท่าใน Data Manager API

`RemoveProductLinkRequest` (Google Ads API)	`DeletePartnerLinkRequest` (Data Manager API)	หมายเหตุ
`customer_id`	ไม่มีเทียบเท่า	ฟิลด์ `name` จะห่อหุ้มบัญชีที่เป็นเจ้าของและบัญชีพาร์ทเนอร์ จึงไม่จำเป็นต้องมีฟิลด์เพิ่มเติมนี้
`resource_name`	`name`	ตั้งค่าเป็นชื่อทรัพยากรของ `PartnerLink` ที่ต้องการ นำออก
`validate_only`	ไม่มีเทียบเท่า

การแมปคำขอการดึงข้อมูลลิงก์

แนวทางการดึงลิงก์พาร์ทเนอร์จะแตกต่างกันระหว่าง Google Ads API กับ Data Manager API

Google Ads API

ส่งSearchGoogleAdsRequest ที่มี query WHERE อนุประโยคที่ไม่บังคับของคิวรีจะกำหนดทรัพยากรที่จะแสดง อนุประโยค SELECT ของการค้นหาจะกำหนดช่องที่จะป้อนข้อมูล ในทรัพยากรบางส่วนที่แสดงผล

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...

Data Manager API

ส่ง SearchPartnerLinkRequest ฟิลด์คำขอ filter ที่ไม่บังคับจะกำหนดทรัพยากรที่จะแสดงผล การตอบกลับมีทรัพยากรที่สมบูรณ์พร้อมฟิลด์ทั้งหมดที่ป้อนข้อมูล

ต่อไปนี้คือการแมปฟิลด์เพื่อแปลงSearchGoogleAdsRequest ใน Google Ads API เป็นSearchPartnerLinksRequest ที่เทียบเท่าใน Data Manager API

`SearchGoogleAdsRequest` (Google Ads API)	`SearchPartnerLinksRequest` (Data Manager API)	หมายเหตุ
`customer_id`	`parent`	ตั้งค่าเป็นชื่อทรัพยากรของบัญชีที่จะค้นหา
`page_size`	`page_size`
`page_token`	`page_token`
`query`	`filter`	ตั้งค่า `filter` เพื่อกำหนดทรัพยากรที่จะแสดง Data Manager API จะแสดงผลทรัพยากรที่สมบูรณ์ จึงไม่มีข้อความที่เทียบเท่ากับข้อความใน`SELECT`
`search_settings`	ไม่มีเทียบเท่า
`validate_only`	ไม่มีเทียบเท่า

ดูข้อมูลเพิ่มเติม รวมถึงวิธีสร้างfilterของคำขอSearchPartnerLinksRequestและตั้งค่าส่วนหัวของคำขอสำหรับสถานการณ์ต่างๆ ได้ที่ดึงข้อมูลลิงก์พาร์ทเนอร์

ขั้นตอนในการอัปเกรด