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

Google Ads API รองรับการลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่นๆ คู่มือนี้อธิบายวิธีใช้ API เพื่อลิงก์บัญชี

เมื่อลิงก์บัญชี Google Ads กับบัญชีผลิตภัณฑ์อื่น การลิงก์จะเกิดขึ้นได้ 2 วิธี

ขั้นตอนการส่งคำเชิญ

ขั้นตอนการส่งคำเชิญจะใช้เมื่อคุณมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในบัญชี Google Ads แต่ไม่มีสิทธิ์เข้าถึงบัญชีผลิตภัณฑ์ ขั้นตอนนี้ใช้ได้ใน 2 สถานการณ์ต่อไปนี้

  1. คุณต้องการลิงก์บัญชีทั้ง 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 สร้างลิงก์ไม่ได้เนื่องจากมีคำเชิญที่รอดำเนินการอยู่

คุณสามารถดึงข้อมูลลิงก์ผลิตภัณฑ์ทั้งหมดที่เชื่อมโยงกับบัญชี 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