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

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

วิธีลิงก์บัญชี

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

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

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

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

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

สถานการณ์	การดำเนินการ	หมายเหตุ
Scenario 1	สร้างคำเชิญ	ใช้วิธี ProductLinkInvitationService.CreateProductLinkInvitation เพื่อสร้างคำเชิญ ไม่ควรตั้งค่า status ของ ProductLinkInvitation เซิร์ฟเวอร์ Google Ads API จะตั้งค่านี้เป็น REQUESTED เมื่อการเรียก API เสร็จสมบูรณ์ เรียบร้อยแล้ว
	ตรวจสอบสถานะของคำเชิญ	ใช้ GoogleAdsService.Search หรือ GoogleAdsService.SearchStream เพื่อค้นหาแหล่งข้อมูล product_link_invitation และตรวจสอบสถานะ
Scenario 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 ต่อไป