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

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 สร้างลิงก์ไม่ได้เนื่องจากมีคำเชิญที่รอดำเนินการอยู่แล้ว

คุณสามารถดึงลิงก์ผลิตภัณฑ์ทั้งหมดที่เชื่อมโยงกับบัญชี Google Ads ได้โดยใช้ การค้นหา GAQL กับแหล่งข้อมูล product_link

    SELECT
      product_link.product_link_id,
      product_link.type
    FROM product_link

ฟิลด์ product_link.type จะระบุประเภทผลิตภัณฑ์หรือบริการที่ลิงก์ ฟิลด์อื่นๆ ภายในทรัพยากร product_link จะได้รับการป้อนข้อมูลตาม type เพื่อให้รายละเอียดเพิ่มเติมเกี่ยวกับลิงก์ เช่น หากประเภทเป็น THIRD_PARTY_APP_ANALYTICS ช่อง third_party_app_analytics จะมี ข้อมูลเกี่ยวกับผู้ให้บริการวิเคราะห์

ซึ่งจะช่วยให้คุณได้รับรายการบริการและแอปพลิเคชันภายนอกที่ลิงก์กับบัญชี Google Ads โดยตรง เช่น Google Play, พาร์ทเนอร์ด้านข้อมูล หรือแพลตฟอร์มข้อมูลวิเคราะห์แอปของบุคคลที่สาม

การเปลี่ยนแปลงใน AccountLinkService

หากคุณใช้ AccountLinkService เพื่อลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่น คุณต้องย้ายข้อมูลแอปพลิเคชันที่มีอยู่ไปยังเวิร์กโฟลว์ใดเวิร์กโฟลว์หนึ่ง ที่ระบุไว้ก่อนหน้านี้ สำหรับลิงก์ประเภทต่อไปนี้ ให้ย้ายข้อมูลออกจาก AccountLinkService และใช้ ProductLinkService

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

สำหรับ ThirdPartyAppAnalyticsLinkIdentifier ให้ใช้ AccountLinkService ต่อไป

ก่อนหน้า
จัดการคําเชิญให้สิทธิ์เข้าถึงของผู้ใช้
ถัดไป
ลิงก์ YouTube