การแมปช่อง

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

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

Data Manager API ต้องใช้ข้อมูลเข้าสู่ระบบที่มีขอบเขตแตกต่างจาก 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

ส่ง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 และตั้งค่าส่วนหัวของคำขอสำหรับสถานการณ์ต่างๆ

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