การแมปช่อง

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

การตรวจสอบสิทธิ์

Data Manager API ต้องใช้ข้อมูลเข้าสู่ระบบที่มีขอบเขตแตกต่างจาก Google Ads API คุณต้องสร้างข้อมูลเข้าสู่ระบบใหม่ที่มี ขอบเขต Data Manager API สำหรับการจัดการ ลิงก์พาร์ทเนอร์

การแมปช่องออบเจ็กต์

ใช้การแมปในตารางเพื่อแมป a 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 ใน the 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

ส่ง SearchPartnerLinksRequest ช่องคำขอ 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 และตั้งค่าส่วนหัวของคำขอสำหรับสถานการณ์ต่างๆ ได้ที่ดึงข้อมูลลิงก์พาร์ทเนอร์

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