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

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 ต่อไป