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 các tài nguyên để giúp bạn quản lý tài khoản Merchant Center hiệu quả hơn với khả năng kiểm soát chính xác hơn trên nhiều khía cạnh 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 chế độ 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ứ, từ tên tài khoản và URL trang web cho đến danh sách người dùng và thông tin doanh nghiệp.

Merchant API chia việc này thành nhiều tài nguyên nhỏ hơn và tập trung hơn. Thay đổi này cho phép thực hiện các lệnh gọi API hiệu quả và nhắm đến mục tiêu cụ thể hơn. Ví dụ: để chỉ cập nhật địa chỉ doanh nghiệp, giờ đây, bạn có thể đưa ra yêu cầu PATCH đối với 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 Content API for Shopping Account tương ứng 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 giới thiệu các chức 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ụ: Lấy 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 các tài nguyên TermsOfService và TermsOfServiceAgreementState.
  • Quyền truy cập vào tài khoản bằng biệt hiệu: Truy cập vào tài khoản bằng định dạng providerId~accountAlias, cung cấp một cách nhất quán cho những doanh nghiệp quản lý nhiều tài khoản để sử dụng mã nhận dạng tài khoản của riêng họ.

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 tác 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
Nhận tài khoản GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Nhận tài khoản theo bí danh 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: 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 cơ bản về tài khoản

Tài nguyên Account trong Merchant API chứa các thông tin chi tiết thiết yếu của một 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.

So sánh yêu cầu

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Xem thông tin chi tiết về 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}

Thông tin so sánh chi tiết về các trường

Content API for Shopping (Account) Merchant API (Account) Ghi chú
id account_id Mã dạng số hiện là một trường chỉ có thể xuất. Giá trị nhận dạng chính là tài nguyên name.
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.

So sánh yêu cầu

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} (cập nhật thuộc tính business_information) PATCH /accounts/v1/accounts/{account}/businessInfo

Thông tin so sánh chi tiết về 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ủ

Để quản lý URL trang web của cửa hàng và 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. Thao tác này sẽ thay thế trường websiteUrl và phương thức accounts.claimwebsite trong Content API for Shopping.

So sánh yêu cầu

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} (cập nhật thuộc tính website_url) PATCH /accounts/v1/accounts/{account}/homepage
Trang chủ 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

Thông tin so sánh chi tiết về 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 Một trường boolean có giá trị 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, việc thêm người dùng sẽ gửi một 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.

So sánh yêu cầu

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} (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} (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} (cập nhật thuộc tính users) DELETE /accounts/v1/accounts/{account}/users/{email}

Thông tin so sánh chi tiết về 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 Giờ đây, các quyền truy cập được hợp nhất thành một trường enum lặp lại.
Không có state Một trường chỉ có thể xuất mới cho biết liệu người dùng có phải là PENDING hay VERIFIED.

Quản lý mối quan hệ và dịch vụ 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).

So sánh yêu cầu

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

Thông tin so sánh chi tiết về các trường

Content API for Shopping (AccountLink) Merchant API (AccountService, AccountRelationship) Ghi chú
linked_account_id provider (trong AccountService) Mã nhận dạng của tài khoản cung cấp dịch vụ.
service service_type (trong AccountService) Loại dịch vụ được cung cấp (ví dụ: ACCOUNT_AGGREGATION).
status handshake.approval_state (trong 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 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ý danh tính 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.

So sánh yêu cầu

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} (cập nhật thuộc tính business_identity) PATCH /accounts/v1/accounts/{account}/businessIdentity

Thông tin so sánh chi tiết về 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 một enum (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) để khai báo rõ ràng hơn. Quy tắc 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) Giá trị 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 cung cấp phương thức accounts.list để liệt kê các tài khoản phụ của Tài khoản nhiều khách hàng đã cho. 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 đơn giản cho 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 accounts.list của Content API for Shopping dưới dạng phương thức accounts.listSubaccounts. Chúng tôi sắp 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.

So sánh yêu cầu

Nội dung mô tả yêu cầu Content API for Shopping Merchant API
Liệt kê tài khoản phụ 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

Thông tin so sánh chi tiết về 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ã nhận dạng 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ề.