Di chuyển tính năng liên kết tài khoản

Việc quản lý mối quan hệ giữa các tài khoản đã chuyển từ một phương thức link duy nhất trong Content API for Shopping sang một hệ thống chi tiết và rõ ràng hơn trong Merchant API. API mới sử dụng các tài nguyên chuyên dụng như AccountRelationship và AccountService để xác định các dịch vụ cụ thể mà một tài khoản cung cấp cho tài khoản khác. Để biết thêm thông tin, hãy xem phần Mối quan hệ giữa các tài khoản.

Những điểm khác biệt chính

  • Tài nguyên chuyên dụng cho mối quan hệ và dịch vụ: Trong Merchant API, tài nguyên AccountRelationship xác định mối liên kết giữa nhà cung cấp dịch vụ và người bán, trong khi tài nguyên AccountService chỉ định chính xác dịch vụ đang được cung cấp (ví dụ: accountAggregation). Điều này thay thế các trường linkType và services chung chung trong Content API for Shopping.
  • Phương thức hành động rõ ràng: Thay vì một phương thức link duy nhất có tham số action, Merchant API sử dụng các phương thức riêng biệt để quản lý dịch vụ, chẳng hạn như propose, approve và reject.
  • Liên kết Trang doanh nghiệp trên Google chuyên biệt: Việc liên kết với Trang doanh nghiệp trên Google (trước đây được xử lý bằng cách đặt trường googleMyBusinessLink) hiện có một phương thức chuyên biệt là gbpAccounts.linkGbpAccount.
  • Tạo tài khoản khách hàng dưới dạng một dịch vụ: Việc tạo tài khoản khách hàng trong một tài khoản nâng cao hiện được coi là đề xuất một dịch vụ accountAggregation bằng phương thức accounts.createAndConfigure. Bạn có thể xem thêm thông tin về tài khoản trên trang Merchant Accounts API. Không cần bắt tay vì người dùng có quyền truy cập vào cả tài khoản nâng cao và tài khoản khách hàng.

Yêu cầu

Merchant API cung cấp các điểm cuối cụ thể để quản lý nhiều loại mối liên kết và dịch vụ tài khoản:

URL yêu cầu Merchant API

  • Đề xuất một dịch vụ mới: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Phê duyệt một dịch vụ: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Từ chối dịch vụ: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Liên kết với Trang doanh nghiệp trên Google: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Tạo tài khoản khách hàng (đường liên kết tổng hợp tài khoản): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

Yêu cầu so sánh URL

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Liên kết tài khoản (ví dụ: nền tảng bên thứ ba) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Liên kết với Trang doanh nghiệp trên Google PUT .../v2.1/{merchantId}/accounts/{accountId} (có trường googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
Tạo tài khoản khách hàng POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Phương thức

Phương thức Content API for Shopping Phương thức Merchant API Phạm vi cung cấp và lưu ý
accounts.link accountServices.propose Hãy sử dụng phương thức này để bắt đầu một dịch vụ mới bằng một tài khoản khác.
accounts.link (với action: "approve") accountServices.approve Sử dụng phương thức này để phê duyệt một đề xuất dịch vụ đang chờ xử lý.
accounts.link (với action: "remove") accountServices.reject Sử dụng phương thức này để từ chối một dịch vụ đang chờ xử lý hoặc đã thiết lập.
accounts.insert (đối với tài khoản khách hàng) accounts.createAndConfigure Sử dụng phương thức này với dịch vụ accountAggregation để tạo một tài khoản khách hàng mới trong tài khoản nâng cao.
accounts.update (với googleMyBusinessLink) gbpAccounts.linkGbpAccount Sử dụng phương thức chuyên biệt này để liên kết tài khoản Merchant Center với Trang doanh nghiệp trên Google.
accounts.update (với adsLinks) AccountRelationship tài nguyên Bạn có thể quản lý việc liên kết với Google Ads trên giao diện người dùng Google Ads. Đường liên kết kết quả được biểu thị dưới dạng AccountRelationship trong Merchant API. Bạn có thể xem nhưng không thể tạo trực tiếp.

Thông tin chi tiết về các thay đổi đối với trường

Content API for Shopping Merchant API Mô tả
AccountsLinkRequest.action propose, approve, reject phương thức Trường action duy nhất được thay thế bằng các phương thức API chuyên dụng cho từng thay đổi về trạng thái trong vòng đời của dịch vụ.
AccountsLinkRequest.linkType AccountService.service_type Chuỗi linkType chung được thay thế bằng một trường service_type oneof có cấu trúc trong tài nguyên AccountService, chẳng hạn như productsManagement hoặc accountAggregation
AccountsLinkRequest.services AccountService.service_type Danh sách các dịch vụ dựa trên chuỗi hiện được biểu thị bằng service_type cụ thể được chọn trong tài nguyên AccountService.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider Mã nhận dạng của tài khoản cung cấp dịch vụ hiện được chỉ định trong trường provider của yêu cầu propose.
Account.googleMyBusinessLink LinkGbpAccountRequest Đối tượng chứa thông tin chi tiết về đường liên kết đến Trang doanh nghiệp trên Google được thay thế bằng một thông báo yêu cầu chuyên dụng cho phương thức linkGbpAccount.
Account.adsLinks AccountRelationship Đường liên kết trên Google Ads được biểu thị dưới dạng tài nguyên AccountRelationship, trong đó provider là providers/GOOGLE_ADS. Mối quan hệ này thường được quản lý thông qua giao diện người dùng Google Ads.