API Google Ads hỗ trợ 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 phiên bản 16 để liên kết các tài khoản.
Cách liên kết tài khoả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 tài khoản theo 2 cách.
Quy trình lời mời
Quy trình lời mời được dùng khi bạn có quyền quản trị vào tài khoản Google Ads nhưng không có quyền truy cập vào 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 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 sẽ 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, 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 sẽ tạo lời mời và bạn chấp nhận lời mời cũng như hoàn tất quá 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 | Hãy 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 lệnh gọi API hoàn tất thành công. |
| 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
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 một
ProductLinkInvitation hiện có. |
Trong quy trình này, bạn có thể gặp phải các lỗi thường gặp sau đâ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 |
Bạn 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
Quy trình liên kết trực tiếp được 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 một đườ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. |
Trong quy trình này, bạn có thể gặp phải các lỗi thường gặp sau đâ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 cách này không được hỗ trợ do thiếu quyền. Thay vào đó, người dùng nên sử dụng ProductLinkInvitationService để thực hiện quy trình lời mời.
|
ProductLinkError.INVITATION_EXISTS |
Bạn không thể tạo đường liên kết vì đã có lời mời đang chờ xử lý. |
Các thay đổi đối với AccountLinkService và MerchantCenterLinkService
Nếu trước đây đã sử dụng MerchantCenterLinkService hoặc 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 cần di chuyển ứng dụng hiện có sang một trong các quy trình công việc nêu trên. Bảng sau đây cho thấy trạng thái di chuyển:
| Loại liên kết | Được hỗ trợ trong các dịch vụ mới? | Dịch vụ hỗ trợ bắt đầu có hiệu lực kể từ | Nhận xét |
|---|---|---|---|
DataPartnerIdentifier |
Có | v15 | Di chuyển khỏi MerchantCenterLinkService |
GoogleAdsIdentifier |
Có | v16 | Di chuyển khỏi AccountLinkService |
MerchantCenterIdentifier |
Có | v16 | Di chuyển khỏi AccountLinkService |
AdvertisingPartnerIdentifier |
Có | v16 | Di chuyển khỏi AccountLinkService |
ThirdPartyAppAnalyticsLinkIdentifier |
Không | – | Tiếp tục sử dụng AccountLinkService |