Google Ads API รองรับการลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่นๆ คู่มือนี้จะอธิบายวิธีใช้ API เวอร์ชัน 16 เพื่อลิงก์บัญชี
วิธีลิงก์บัญชี
เมื่อลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่น คุณจะลิงก์ได้ 2 วิธีด้วยกัน
ขั้นตอนการเชิญ
ระบบจะใช้ขั้นตอนการส่งคำเชิญเมื่อคุณมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในบัญชี Google Ads แต่ไม่ใช่บัญชีผลิตภัณฑ์ ขั้นตอนนี้ใช้ได้ใน 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 และ MerchantCenterLinkService
หากก่อนหน้านี้คุณใช้ MerchantCenterLinkService หรือ AccountLinkService เพื่อลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่น คุณจะต้องย้ายข้อมูลแอปพลิเคชันที่มีอยู่ไปยังเวิร์กโฟลว์หนึ่งที่แสดงไว้ก่อนหน้านี้ ตารางต่อไปนี้แสดงสถานะการย้ายข้อมูล
| ประเภทลิงก์ | มีการรองรับในบริการใหม่ไหม | รับการสนับสนุนตั้งแต่วันที่ | หมายเหตุ |
|---|---|---|---|
DataPartnerIdentifier |
ใช่ | v15 | ย้ายข้อมูลออกจาก MerchantCenterLinkService |
GoogleAdsIdentifier |
ใช่ | v16 | ย้ายข้อมูลออกจาก AccountLinkService |
MerchantCenterIdentifier |
ใช่ | v16 | ย้ายข้อมูลออกจาก AccountLinkService |
AdvertisingPartnerIdentifier |
ใช่ | v16 | ย้ายข้อมูลออกจาก AccountLinkService |
ThirdPartyAppAnalyticsLinkIdentifier |
ไม่ได้ | – | ใช้ AccountLinkService ต่อไป |