ลิงก์บัญชีผลิตภัณฑ์

Google Ads API รองรับการลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่นๆ คู่มือนี้อธิบายวิธีใช้ API เพื่อลิงก์บัญชี

เมื่อลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่น การลิงก์จะเกิดขึ้นได้ 2 วิธี ที่แตกต่างกัน

ขั้นตอนการเชิญ

ใช้ขั้นตอนการเชิญเมื่อคุณมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในบัญชี Google Ads แต่ไม่มีสิทธิ์เข้าถึงบัญชีผลิตภัณฑ์ โฟลว์นี้จะทำงานใน 2 สถานการณ์ต่อไปนี้

  1. คุณต้องการลิงก์ 2 บัญชีและสร้างคำเชิญสำหรับผู้ดูแลระบบบัญชีผลิตภัณฑ์ ผู้ดูแลบัญชีผลิตภัณฑ์ยอมรับคำเชิญเพื่อดำเนินการกระบวนการเชื่อมต่อให้เสร็จสมบูรณ์
  2. ผู้ดูแลบัญชีผลิตภัณฑ์ต้องการลิงก์ 2 บัญชีนี้ แต่ไม่มีสิทธิ์เข้าถึงบัญชี Google Ads ผู้ดูแลบัญชีผลิตภัณฑ์ สร้างคำเชิญ จากนั้นคุณยอมรับคำเชิญและ ทําตามกระบวนการเชื่อมต่อให้เสร็จสมบูรณ์

ในสถานการณ์นี้ ให้ใช้วิธีการต่อไปนี้

สถานการณ์ การดำเนินการ หมายเหตุ
สถานการณ์ที่ 1 สร้างคำเชิญ ใช้วิธี ProductLinkInvitationService.CreateProductLinkInvitation เพื่อสร้างคำเชิญ ไม่ควรตั้งค่า status ของ ProductLinkInvitation เซิร์ฟเวอร์ Google Ads API จะตั้งค่านี้เป็น REQUESTED เมื่อการเรียก API เสร็จสมบูรณ์ เรียบร้อยแล้ว เมื่อสร้างคำเชิญสำหรับพาร์ทเนอร์โฆษณา (AdvertisingPartnerLinkInvitationIdentifier) advertising_partner_properties.allowed_domain จะต้องระบุตั้งแต่ v25 เป็นต้นไป (และไม่บังคับใน v24 และเวอร์ชันก่อนหน้า)
ตรวจสอบสถานะของคำเชิญ ใช้ GoogleAdsService.Search หรือ GoogleAdsService.SearchStream เพื่อค้นหาแหล่งข้อมูล product_link_invitation และตรวจสอบสถานะ
สถานการณ์ที่ 2 ดึงข้อมูลคำเชิญ ใช้ GoogleAdsService.Search หรือ GoogleAdsService.SearchStream เพื่อค้นหาแหล่งข้อมูล product_link_invitation กรองหา status = PENDING_APPROVAL เพื่อยอมรับหรือปฏิเสธ คำเชิญที่รอดำเนินการ
ยอมรับหรือปฏิเสธคำเชิญ ใช้วิธี ProductLinkInvitationService.UpdateProductLinkInvitation เพื่อ อัปเดตสถานะของ ProductLinkInvitation เป็น ACCEPTED หรือ REJECTED
เพิกถอนคำเชิญ ใช้เมธอด ProductLinkInvitationService.RemoveProductLinkInvitation เพื่อ เพิกถอน ProductLinkInvitation ที่มีอยู่

ข้อผิดพลาดที่พบบ่อยต่อไปนี้อาจเกิดขึ้นในเวิร์กโฟลว์นี้

รหัสข้อผิดพลาด คำอธิบาย
ProductLinkInvitationError.PERMISSION_DENIED ลูกค้าไม่มีสิทธิ์ดำเนินการนี้
ProductLinkInvitationError.NO_INVITATION_REQUIRED สร้างคำเชิญไม่ได้เนื่องจากผู้ใช้มีสิทธิ์เข้าถึงระดับผู้ดูแลระบบ ในบัญชีที่ได้รับเชิญอยู่แล้ว ผู้ใช้ควรใช้ ProductLinkService เพื่อ สร้างลิงก์ที่ใช้งานอยู่โดยตรง

โฟลว์การลิงก์โดยตรง

ใช้ขั้นตอนการลิงก์โดยตรงเมื่อคุณมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบทั้ง บัญชี Google Ads และบัญชีผลิตภัณฑ์ ในกรณีนี้ ให้ลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์โดยตรงแทนการส่งคำเชิญ

ในสถานการณ์นี้ ให้ใช้วิธีการต่อไปนี้

การดำเนินการ หมายเหตุ
สร้างลิงก์ที่ใช้งานได้ ใช้ ProductLinkService.CreateProductLink เพื่อสร้าง ProductLink
ปิดใช้ลิงก์ที่ใช้งานอยู่ ใช้ ProductLinkService.RemoveProductLink เพื่อนำ ProductLink ที่ ใช้งานอยู่ออก
ดึงข้อมูลลิงก์ที่ใช้งานอยู่ ใช้ GoogleAdsService.Search หรือ GoogleAdsService.SearchStream เพื่อค้นหาแหล่งข้อมูล product_link

ข้อผิดพลาดที่พบบ่อยต่อไปนี้อาจเกิดขึ้นในเวิร์กโฟลว์นี้

รหัสข้อผิดพลาด คำอธิบาย
ProductLinkError.CREATION_NOT_PERMITTED มีการพยายามลิงก์บัญชีโดยใช้โฟลว์ลิงก์โดยตรง แต่ระบบไม่รองรับเนื่องจากไม่มีสิทธิ์ ผู้ใช้ควรใช้ ProductLinkInvitationService เพื่อทำขั้นตอนการเชิญแทน
ProductLinkError.INVITATION_EXISTS สร้างลิงก์ไม่ได้เนื่องจากมีคำเชิญที่รอดำเนินการอยู่แล้ว

คุณสามารถดึงลิงก์ผลิตภัณฑ์ทั้งหมดที่เชื่อมโยงกับบัญชี Google Ads ได้โดยใช้ คําค้นหา GAQL กับแหล่งข้อมูล product_link

SELECT
  product_link.product_link_id,
  product_link.type
FROM product_link

ฟิลด์ product_link.type จะระบุประเภทผลิตภัณฑ์หรือบริการที่ลิงก์ ฟิลด์อื่นๆ ภายในทรัพยากร product_link จะได้รับการป้อนข้อมูลตาม type เพื่อให้รายละเอียดเพิ่มเติมเกี่ยวกับลิงก์ ตัวอย่างเช่น หากประเภทคือ DATA_PARTNER ฟิลด์ data_partner จะมีข้อมูลเกี่ยวกับ บัญชีพาร์ทเนอร์ด้านข้อมูลที่ลิงก์

ซึ่งจะช่วยให้คุณได้รับรายการบริการภายนอกและบัญชีผลิตภัณฑ์ที่ลิงก์ กับบัญชี Google Ads โดยตรง เช่น Merchant Center, Google Ads, พาร์ทเนอร์ด้านโฆษณา หรือพาร์ทเนอร์ด้านข้อมูล

การเปลี่ยนแปลงใน AccountLinkService

หากใช้ AccountLinkService เพื่อลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่น คุณต้องย้ายข้อมูลแอปพลิเคชันที่มีอยู่ไปยังเวิร์กโฟลว์ใดเวิร์กโฟลว์หนึ่ง ที่ระบุไว้ก่อนหน้านี้ สำหรับลิงก์ประเภทต่อไปนี้ ให้ย้ายข้อมูลออกจาก AccountLinkService แล้วใช้ ProductLinkService แทน

สำหรับ ThirdPartyAppAnalyticsLinkIdentifier ให้ใช้ AccountLinkService ต่อไป

ก่อนหน้า
จัดการคําเชิญให้สิทธิ์เข้าถึงของผู้ใช้
ถัดไป
ลิงก์ YouTube