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

Google Ads API 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, bạn có thể liên kết theo hai cách.

Quy trình mời

Quy trình mời được sử 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 và tạo lời mời cho 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 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
Tình huống 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ủ Google Ads API sẽ đặt giá trị này thành REQUESTED sau khi hoàn tất thành công 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 đó.
Tình huống 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 ProductLinkInvitation hiện có.

Bạn có thể gặp phải các lỗi thường gặp sau trong quy trình làm việc này:

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 để trực tiếp tạo đườ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 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 đường liên kết đang hoạt động Sử dụng ProductLinkService.removeProductLink để xoá 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.

Bạn có thể gặp phải các lỗi thường gặp sau trong quy trình làm việc này:

Mã lỗi Giải thích
ProductLinkError.CREATION_NOT_PERMITTED Bạn đã 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 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ý.

Bạn có thể truy xuất tất cả các đường liên kết sản phẩm được liên kết với tài khoản Google Ads của mình bằng cách sử dụng truy vấn GAQL đối với tài nguyên product_link.

    SELECT
      product_link.product_link_id,
      product_link.type
    FROM product_link

Trường product_link.type cho biết loại sản phẩm hoặc dịch vụ được liên kết. Tuỳ thuộc vào type, các trường khác trong tài nguyên product_link sẽ được điền sẵn, cung cấp thêm thông tin chi tiết về đường liên kết. Ví dụ: nếu loại là THIRD_PARTY_APP_ANALYTICS, thì trường third_party_app_analytics sẽ chứa thông tin về nhà cung cấp dịch vụ phân tích.

Điều này cho phép bạn lấy danh sách các dịch vụ và ứng dụng bên ngoài được liên kết trực tiếp với tài khoản Google Ads của bạn, chẳng hạn như Google Play, đối tác dữ liệu hoặc nền tảng phân tích ứng dụng bên thứ ba.

Thay đổi đối với AccountLinkService

Nếu bạn 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, thì bạn phải di chuyển ứng dụng hiện có sang một trong các quy trình làm 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.