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

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 เสร็จสมบูรณ์
ตรวจสอบสถานะคำเชิญ ใช้ 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 ลูกค้าไม่ได้รับอนุญาตให้ดำเนินการนี้
ProductLinkError.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 สร้างลิงก์ไม่ได้เนื่องจากมีคำเชิญที่รอดำเนินการอยู่แล้ว

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

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

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

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

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