Liên kết các tài khoản sản phẩm

API Google Ads hỗ trợ việc liên kết tài khoản Google Ads với các tài khoản sản phẩm khác. Hướng dẫn này giải thích cách sử dụng API để liên kết các tài khoản của bạn.

Khi liên kết tài khoản Google Ads với một tài khoản sản phẩm khác, có hai cách để liên kết.

Quy trình mời

Quy trình mời được dùng khi bạn có quyền quản trị đối với tài khoản Google Ads nhưng không có quyền quản trị đối với tài khoản sản phẩm. Quy trình này hoạt động trong hai trường hợp:

  1. Bạn muốn liên kết hai tài khoản này và tạo lời mời cho một quản trị viên của tài khoản sản phẩm. Quản trị viên tài khoản sản phẩm chấp nhận lời mời để hoàn tất quy trình liên kết tài khoản.
  2. Quản trị viên tài khoản sản phẩm muốn liên kết hai tài khoản này nhưng không có quyền truy cập vào tài khoản Google Ads. Quản trị viên tài khoản sản phẩm tạo lời mời, bạn chấp nhận lời mời và hoàn tất quy trình liên kết.

Các phương thức sau được sử dụng trong trường hợp này:

Trường hợp Hành động Nhận xét
Kịch bản 1 Tạo lời mời Sử dụng phương thức ProductLinkInvitationService.CreateProductLinkInvitation để tạo lời mời. Bạn không nên đặt status của ProductLinkInvitation; máy chủ API Google Ads sẽ đặt giá trị này thành REQUESTED sau khi hoàn tất lệnh gọi API.
Kiểm tra trạng thái của lời mời Sử dụng GoogleAdsService.Search hoặc GoogleAdsService.SearchStream để truy vấn tài nguyên product_link_invitation và kiểm tra trạng thái của tài nguyên đó.
Kịch bản 2 Truy xuất lời mời Sử dụng GoogleAdsService.Search hoặc GoogleAdsService.SearchStream để truy vấn tài nguyên product_link_invitation. Lọc theo status = PENDING_APPROVAL để chấp nhận hoặc từ chối lời mời đang chờ xử lý.
Chấp nhận hoặc từ chối lời mời Sử dụng phương thức ProductLinkInvitationService.UpdateProductLinkInvitation để cập nhật trạng thái của ProductLinkInvitation thành ACCEPTED hoặc REJECTED.
Thu hồi lời mời Sử dụng phương thức ProductLinkInvitationService.RemoveProductLinkInvitation để thu hồi một ProductLinkInvitation hiện có.

Quy trình công việc này có thể gặp phải các lỗi thường gặp sau:

Mã lỗi Giải thích
ProductLinkInvitationError.PERMISSION_DENIED Khách hàng không có quyền thực hiện hành động này.
ProductLinkError.NO_INVITATION_REQUIRED Không thể tạo lời mời vì người dùng đã có quyền quản trị đối với tài khoản được mời. Người dùng nên sử dụng ProductLinkService để tạo trực tiếp một đường liên kết đang hoạt động.

Quy trình liên kết trực tiếp

Quy trình liên kết trực tiếp được sử dụng khi bạn có quyền quản trị đối với cả tài khoản Google Ads và tài khoản sản phẩm. Trong trường hợp này, bạn sẽ liên kết trực tiếp tài khoản Google Ads với tài khoản sản phẩm thay vì gửi lời mời.

Các phương thức sau được sử dụng trong trường hợp này:

Hành động Nhận xét
Tạo đường liên kết đang hoạt động Sử dụng ProductLinkService.createProductLink để tạo ProductLink.
Tắt một đường liên kết đang hoạt động Sử dụng ProductLinkService.removeProductLink để xoá một ProductLink đang hoạt động.
Truy xuất các đường liên kết đang hoạt động Sử dụng GoogleAdsService.Search hoặc GoogleAdsService.SearchStream để truy vấn tài nguyên product_link.

Quy trình công việc này có thể gửi các lỗi thường gặp sau:

Mã lỗi Giải thích
ProductLinkError.CREATION_NOT_PERMITTED Chúng tôi đã cố gắng liên kết tài khoản bằng quy trình liên kết trực tiếp, nhưng quy trình này không được hỗ trợ do thiếu quyền. Người dùng nên sử dụng ProductLinkInvitationService để thực hiện quy trình mời.
ProductLinkError.INVITATION_EXISTS Không thể tạo đường liên kết vì đã có một lời mời đang chờ xử lý.

Thay đổi đối với AccountLinkService

Nếu sử dụng AccountLinkService để liên kết tài khoản Google Ads với một tài khoản sản phẩm khác, bạn phải di chuyển ứng dụng hiện có sang một trong các quy trình công việc được liệt kê trước đó. Đối với các loại đường liên kết sau, hãy di chuyển khỏi AccountLinkService và sử dụng ProductLinkService:

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

Đối với ThirdPartyAppAnalyticsLinkIdentifier, hãy tiếp tục sử dụng AccountLinkService.