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.
Cách liên kết tài khoản
Khi liên kết một tài khoản Google Ads với một tài khoản sản phẩm khác, có 2 cách liên kết khác nhau.
Quy trình gửi lời mời
Sử dụng quy trình gửi lời mời 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 2 trường hợp:
- Bạn muốn liên kết hai tài khoản 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.
- 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, sau đó bạn chấp nhận lời mời và hoàn tất quy trình liên kết.
Hãy sử dụng các phương thức sau 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 khi hoàn tất thành công lệnh gọi API. Khi tạo lời mời cho Đối tác quảng cáo (AdvertisingPartnerLinkInvitationIdentifier), bạn phải sử dụng advertising_partner_properties.allowed_domain kể từ phiên bản 25 (và không bắt buộc trong phiên bản 24 trở về trước). |
| 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
một 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ó. |
Các lỗi thường gặp sau đây có thể xảy ra trong quy trình 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. |
ProductLinkInvitationError.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 một đường liên kết đang hoạt động. |
Quy trình liên kết trực tiếp
Sử dụng quy trình liên kết trực tiếp 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, hãy 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.
Hãy sử dụng các phương thức sau 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. |
Các lỗi phổ biến sau đây có thể xảy ra trong quy trình này:
| Mã lỗi | Giải thích |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Đã có một nỗ lực 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ý. |
Truy xuất các đường liên kết đến sản phẩm hiện có
Bạn có thể truy xuất tất cả các đường liên kết đến 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 một 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à DATA_PARTNER, thì trường data_partner sẽ chứa thông tin về tài khoản đối tác dữ liệu được liên kết.
Thao tác này cho phép bạn lấy danh sách các dịch vụ bên ngoài và tài khoản sản phẩm đượ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ư Merchant Center, Google Ads, Đối tác quảng cáo hoặc đối tác dữ liệu.
Thay đổi đối với AccountLinkService
Nếu sử dụng AccountLinkService để liên kết mộ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 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:
Đối với ThirdPartyAppAnalyticsLinkIdentifier, hãy tiếp tục sử dụng AccountLinkService.