Di chuyển hoạt động quản lý tài khoản

Accounts API được chia thành một tập hợp tài nguyên để giúp bạn quản lý tài khoản Merchant Center hiệu quả hơn, đồng thời kiểm soát chính xác hơn các khía cạnh khác nhau của tài khoản.

Hướng dẫn này giải thích những thay đổi chính và giúp bạn di chuyển quy trình tích hợp quản lý tài khoản hiện có từ Content API for Shopping sang Merchant API.

Từ một tài nguyên đến nhiều tài nguyên

Trong Content API for Shopping, tài nguyên Account là một đối tượng nguyên khối chứa mọi thông tin, từ tên tài khoản và URL của trang web cho đến danh sách người dùng và thông tin doanh nghiệp.

Merchant API chia tài nguyên này thành nhiều tài nguyên nhỏ hơn, tập trung hơn. Thay đổi này giúp các lệnh gọi API trở nên hiệu quả và có mục tiêu hơn. Ví dụ: để chỉ cập nhật địa chỉ doanh nghiệp, giờ đây, bạn sẽ gửi yêu cầu PATCH đến tài nguyên BusinessInfo thay vì cập nhật toàn bộ đối tượng Account.

Sau đây là thông tin tóm tắt về cách các khái niệm trong tài nguyên Account của Content API for Shopping liên kết với các tài nguyên mới trong Merchant API:

Các chức năng mới

Merchant API cũng ra mắt các tính năng mới để quản lý tài khoản mà Content API for Shopping không có:

  • Điều khoản dịch vụ: Truy xuất và chấp nhận Điều khoản dịch vụ theo phương thức lập trình bằng cách sử dụng tài nguyên TermsOfService và TermsOfServiceAgreementState.
  • Tạo tài khoản: Phương thức accounts.createAndConfigure hiện hỗ trợ việc tạo tài khoản có mối quan hệ (chẳng hạn như accountManagement), đặt alias và loại bỏ quy trình xác minh email bằng trường user.verificationMailSettings.verificationMailMode để ưu tiên quy trình xác minh dựa trên API bằng phương thức accounts.verifySelf mới.
  • Truy cập vào tài khoản bằng bí danh: Truy cập vào tài khoản bằng định dạng providerId~accountAlias, giúp các doanh nghiệp quản lý nhiều tài khoản có thể sử dụng giá trị nhận dạng tài khoản của riêng họ một cách nhất quán.

Yêu cầu

Bảng này cung cấp thông tin so sánh tổng hợp về URL yêu cầu cho các nhiệm vụ quản lý tài khoản phổ biến giữa Content API for Shopping và Merchant API.

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Lấy tài khoản GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Lấy tài khoản theo bí danh đại diện Không có sẵn trực tiếp GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
Liệt kê tài khoản phụ GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
Tạo tài khoản phụ POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
Cập nhật dữ liệu tài khoản PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} PATCH trên tài nguyên thích hợp. Ví dụ: để cập nhật tên tài khoản, hãy làm như sau: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Xoá tài khoản phụ DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Xác nhận quyền sở hữu trang web POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
Liên kết tài khoản POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

Quản lý thông tin tài khoản chính

Tài nguyên Account trong Merchant API chứa thông tin chi tiết thiết yếu của tài khoản Merchant Center, chẳng hạn như tên, mã nhận dạng và chế độ cài đặt cơ bản.

Yêu cầu so sánh

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Lấy thông tin tài khoản GET /content/v2.1/{merchantId}/accounts/{accountId} (truy cập vào các thuộc tính cốt lõi như name, adult_content) GET /accounts/v1/accounts/{account}
Tạo tài khoản phụ POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
Cập nhật thông tin tài khoản PUT /content/v2.1/{merchantId}/accounts/{accountId} (đang cập nhật các thuộc tính cốt lõi) PATCH /accounts/v1/accounts/{account}
Xoá tài khoản phụ DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

So sánh chi tiết các trường

Content API for Shopping (Account) Merchant API (Account) Ghi chú
id account_id Mã nhận dạng dạng số hiện là trường chỉ có đầu ra. Giá trị nhận dạng chính là name của tài nguyên.
name account_name Tên tài khoản mà con người có thể đọc được.
language language_code Tên trường hiện là language_code.

Quản lý thông tin doanh nghiệp

Sử dụng tài nguyên BusinessInfo để quản lý thông tin công khai về doanh nghiệp của bạn, chẳng hạn như địa chỉ và thông tin liên hệ của bộ phận dịch vụ khách hàng. Thao tác này sẽ thay thế đối tượng businessInformation trong Content API for Shopping.

Yêu cầu so sánh

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Lấy thông tin doanh nghiệp GET /content/v2.1/{merchantId}/accounts/{accountId} (truy cập vào thuộc tính business_information) GET /accounts/v1/accounts/{account}/businessInfo
Cập nhật thông tin doanh nghiệp PUT /content/v2.1/{merchantId}/accounts/{accountId} (đang cập nhật thuộc tính business_information) PATCH /accounts/v1/accounts/{account}/businessInfo

So sánh chi tiết các trường

Content API for Shopping (business_information) Merchant API (BusinessInfo) Ghi chú
phone_number phone Trường này hiện là phone và sử dụng google.type.PhoneNumber.
customer_service.url customer_service.uri Tên trường hiện là uri.

Quản lý trang chủ của bạn

Để quản lý URL trang web của cửa hàng, cũng như thực hiện quy trình xác minh và xác nhận quyền sở hữu, hãy sử dụng tài nguyên Homepage. Trường này thay thế trường websiteUrl và phương thức accounts.claimwebsite trong Content API for Shopping.

Yêu cầu so sánh

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Lấy URL trang chủ GET /content/v2.1/{merchantId}/accounts/{accountId} (truy cập vào thuộc tính website_url) GET /accounts/v1/accounts/{account}/homepage
Cập nhật URL trang chủ PUT /content/v2.1/{merchantId}/accounts/{accountId} (đang cập nhật thuộc tính website_url) PATCH /accounts/v1/accounts/{account}/homepage
Trang chủ của thông báo xác nhận quyền sở hữu POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
Huỷ xác nhận quyền sở hữu trang chủ Không có POST /accounts/v1/accounts/{account}/homepage:unclaim

So sánh chi tiết các trường

Content API for Shopping (Account) Merchant API (Homepage) Ghi chú
website_url uri URL trang chủ của cửa hàng.
Không có sẵn trực tiếp claimed Trường boolean là true nếu trang chủ đã được xác nhận quyền sở hữu.

Quản lý người dùng

Tài nguyên User cho phép bạn quản lý những người có thể truy cập vào tài khoản Merchant Center. Thao tác này sẽ thay thế mảng users trong tài nguyên Account. Điểm khác biệt chính là quy trình tạo người dùng. Trong Merchant API, khi bạn thêm người dùng, hệ thống sẽ gửi lời mời. Người dùng phải chấp nhận lời mời thì mới có thể truy cập vào tài khoản.

Yêu cầu so sánh

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Liệt kê người dùng GET /content/v2.1/{merchantId}/accounts/{accountId} (truy cập vào thuộc tính users) GET /accounts/v1/accounts/{account}/users
Tạo người dùng PUT /content/v2.1/{merchantId}/accounts/{accountId} (đang cập nhật thuộc tính users) POST /accounts/v1/accounts/{account}/users
Cập nhật người dùng PUT /content/v2.1/{merchantId}/accounts/{accountId} (đang cập nhật thuộc tính users) PATCH /accounts/v1/accounts/{account}/users/{email}
Xóa người dùng PUT /content/v2.1/{merchantId}/accounts/{accountId} (đang cập nhật thuộc tính users) DELETE /accounts/v1/accounts/{account}/users/{email}

So sánh chi tiết các trường

Content API for Shopping (đối tượng mảng users) Merchant API (tài nguyên User) Ghi chú
email_address name (ở định dạng accounts/{account}/users/{email}) Email của người dùng hiện là một phần của tên tài nguyên.
admin, order_manager, reporting_manager, v.v. access_rights Quyền truy cập hiện được hợp nhất vào một trường enum lặp lại.
Không có state Một trường mới chỉ có đầu ra cho biết người dùng là PENDING hay VERIFIED.

Quản lý mối quan hệ và dịch vụ của tài khoản

Trong Content API for Shopping, các mối quan hệ được quản lý bằng accounts.link. Merchant API giới thiệu một mô hình rõ ràng hơn với các tài nguyên AccountService và AccountRelationship, yêu cầu quy trình bắt tay (đề xuất và chấp nhận).

Yêu cầu so sánh

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Liên kết tài khoản POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
Liệt kê các tài khoản được liên kết GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships và GET /accounts/v1/accounts/{account}/services

So sánh chi tiết các trường

Content API for Shopping (AccountLink) Merchant API (AccountService, AccountRelationship) Ghi chú
linked_account_id provider (bằng AccountService) Mã của tài khoản cung cấp dịch vụ.
service service_type (bằng AccountService) Loại dịch vụ được cung cấp (ví dụ: ACCOUNT_AGGREGATION).
status handshake.approval_state (bằng AccountService) Trạng thái của đường liên kết (ví dụ: PENDING, ESTABLISHED).

Chế độ cài đặt thuế của tài khoản

Dịch vụ accounttax của Content API for Shopping không có trong Merchant API. Bạn không cần phải cung cấp thuế bán hàng ở Hoa Kỳ nữa. Để biết thêm thông tin, hãy xem bài viết Thông tin cập nhật về quy cách dữ liệu sản phẩm của Merchant Center năm 2025.

Quản lý thông tin nhận dạng doanh nghiệp

Sử dụng tài nguyên BusinessIdentity để tự khai báo các thuộc tính về doanh nghiệp của bạn. Thao tác này sẽ thay thế đối tượng businessIdentity trong Content API for Shopping.

Yêu cầu so sánh

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Lấy thông tin nhận dạng doanh nghiệp GET /content/v2.1/{merchantId}/accounts/{accountId} (truy cập vào thuộc tính business_identity) GET /accounts/v1/accounts/{account}/businessIdentity
Cập nhật thông tin nhận dạng doanh nghiệp PUT /content/v2.1/{merchantId}/accounts/{accountId} (đang cập nhật thuộc tính business_identity) PATCH /accounts/v1/accounts/{account}/businessIdentity

So sánh chi tiết các trường

Content API for Shopping (business_identity) Merchant API (BusinessIdentity) Ghi chú
black_owned.self_identified (boolean) black_owned.identity_declaration (enum) Boolean được thay thế bằng enum (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) để khai báo rõ ràng hơn. Điều này áp dụng cho tất cả các thuộc tính nhận dạng.
include_for_promotions (boolean) promotions_consent (enum) Một boolean chung được thay thế bằng một enum mô tả chi tiết hơn (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED).

Liệt kê tài khoản

Trong Content API for Shopping, loại tài khoản nâng cao duy nhất là "Tài khoản nhiều khách hàng (MCA)" và loại tài khoản này hiển thị một phương thức accounts.list để liệt kê các tài khoản của Tài khoản nhiều khách hàng nhất định. Tài khoản nâng cao trong Merchant API mạnh mẽ hơn nhiều, cho phép nhiều loại tài khoản và mối quan hệ hơn. Để cho phép di chuyển dễ dàng đối với các tài khoản nâng cao, Merchant API cung cấp một phương thức tương đương trực tiếp với phương thức accounts.list của Content API for Shopping dưới dạng phương thức accounts.listSubaccounts. Chúng tôi sẽ ra mắt một phương thức accounts.list mới và mạnh mẽ hơn, cho phép lọc tài khoản nâng cao.

Yêu cầu so sánh

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Liệt kê các tài khoản của một tài khoản nâng cao GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
Liệt kê tất cả tài khoản có thể truy cập Không có GET /accounts/v1/accounts

So sánh chi tiết các trường (Tham số yêu cầu)

Content API for Shopping (accounts.list) Merchant API (accounts.listSubaccounts) Ghi chú
merchant_id (tham số đường dẫn) provider (tham số đường dẫn) Mã của tài khoản nâng cao ở định dạng accounts/{account}.
max_results page_size Số lượng tài khoản tối đa cần trả về.
Trước
Refactor code for concurrent requests
Tiếp
Migrate accountstatuses to Account Issues