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