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