Google Ads API รองรับการลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่นๆ คู่มือนี้อธิบายวิธีใช้ API เพื่อลิงก์บัญชี
วิธีลิงก์บัญชี
เมื่อลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่น การลิงก์จะเกิดขึ้นได้ 2 วิธี
ขั้นตอนการเชิญ
ใช้ขั้นตอนการเชิญเมื่อคุณมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในบัญชี Google Ads แต่ไม่มีสิทธิ์เข้าถึงบัญชีผลิตภัณฑ์ ขั้นตอนการทำงานนี้ใช้ได้ใน 2 สถานการณ์ ดังนี้
- คุณต้องการลิงก์บัญชีทั้ง 2 บัญชีและสร้างคำเชิญสำหรับผู้ดูแลระบบของบัญชีผลิตภัณฑ์ ผู้ดูแลบัญชีผลิตภัณฑ์ยอมรับคำเชิญเพื่อทำกระบวนการลิงก์บัญชีให้เสร็จสมบูรณ์
- ผู้ดูแลระบบบัญชีผลิตภัณฑ์ต้องการลิงก์บัญชีทั้งสอง แต่ไม่มีสิทธิ์เข้าถึงบัญชี Google Ads ผู้ดูแลระบบบัญชีผลิตภัณฑ์จะสร้างคำเชิญ และคุณต้องยอมรับคำเชิญและทำกระบวนการลิงก์ให้เสร็จสมบูรณ์
ใช้วิธีการต่อไปนี้ในสถานการณ์นี้
| สถานการณ์ | การดำเนินการ | หมายเหตุ |
|---|---|---|
| สถานการณ์ที่ 1 | สร้างคำเชิญ | ใช้เมธอด
ProductLinkInvitationService.CreateProductLinkInvitation เพื่อสร้างคำเชิญ ไม่ควรตั้งค่า status ของ
ProductLinkInvitation เนื่องจากเซิร์ฟเวอร์ Google Ads API จะตั้งค่านี้เป็น REQUESTED เมื่อการเรียก API เสร็จสมบูรณ์ เมื่อสร้างคำเชิญสำหรับพาร์ทเนอร์ด้านโฆษณา (AdvertisingPartnerLinkInvitationIdentifier) คุณต้องระบุ advertising_partner_properties.allowed_domain ตั้งแต่ v25 เป็นต้นไป (และไม่บังคับใน v24 และเวอร์ชันก่อนหน้า) |
| ตรวจสอบสถานะของคำเชิญ | ใช้ 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 |
ลูกค้าไม่มีสิทธิ์ดำเนินการนี้ |
ProductLinkInvitationError.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 |
สร้างลิงก์ไม่ได้เนื่องจากมีคำเชิญที่รอดำเนินการอยู่แล้ว |
ดึงข้อมูลลิงก์ผลิตภัณฑ์ที่มีอยู่
คุณสามารถดึงข้อมูลลิงก์ผลิตภัณฑ์ทั้งหมดที่เชื่อมโยงกับบัญชี Google Ads โดยใช้คําค้นหา GAQL กับทรัพยากร product_link
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
ฟิลด์ product_link.type จะระบุประเภทของผลิตภัณฑ์หรือบริการที่ลิงก์
ระบบจะป้อนข้อมูลในช่องอื่นๆ ภายในทรัพยากร product_link โดยขึ้นอยู่กับ type เพื่อให้รายละเอียดเพิ่มเติมเกี่ยวกับลิงก์ ตัวอย่างเช่น หากประเภทคือ DATA_PARTNER ช่อง data_partner จะมีข้อมูลเกี่ยวกับบัญชีพาร์ทเนอร์ด้านข้อมูลที่ลิงก์
วิธีนี้ช่วยให้คุณได้รับรายการบริการภายนอกและบัญชีผลิตภัณฑ์ที่ลิงก์กับบัญชี Google Ads โดยตรง เช่น Merchant Center, Google Ads, พาร์ทเนอร์ด้านโฆษณา หรือพาร์ทเนอร์ด้านข้อมูล
การเปลี่ยนแปลงใน AccountLinkService
หากคุณใช้ AccountLinkService เพื่อลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่น คุณต้องย้ายข้อมูลแอปพลิเคชันที่มีอยู่ไปยังเวิร์กโฟลว์รายการใดรายการหนึ่งที่ระบุไว้ก่อนหน้านี้ สำหรับลิงก์ประเภทต่อไปนี้ ให้ย้ายออกจาก AccountLinkService และใช้ ProductLinkService
สำหรับ ThirdPartyAppAnalyticsLinkIdentifier ให้ใช้ AccountLinkService ต่อไป