Ghi chú phát hành API Tài khoản người bán

Tuần bắt đầu từ ngày 1 tháng 7 năm 2025

  • Ra mắt tài nguyên CheckoutSettings cho phép người dùng API tạo, cập nhật, xoá, nhận checkoutSettings.

Tuần bắt đầu từ ngày 26 tháng 5 năm 2025

  • Giờ đây, bạn có thể lọc tài khoản theo capabilities. Hiện tại, giá trị có thể có duy nhất là CAN_UPLOAD_PRODUCTS. Bộ lọc này cho phép bạn truy xuất những tài khoản có thể tải sản phẩm lên. Điều này có nghĩa là giờ đây, bạn có thể sử dụng các mệnh đề sau ở cấp tài khoản:

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS Để biết thêm thông tin, hãy xem hướng dẫn lọc.

  • Ra mắt quyền truy cập chỉ đọc. Người dùng có quyền truy cập chỉ đọc có thể xem dữ liệu người bán nhưng không thể sửa đổi dữ liệu đó.

Tuần bắt đầu từ ngày 19 tháng 5 năm 2025

  • Cập nhật tài liệu về API chương trình, xoá nội dung không chính xác rằng các phương thức Enable/Disable chỉ dành cho người dùng quản trị.

Tuần bắt đầu từ ngày 12 tháng 5 năm 2025

  • Ra mắt tài nguyên Chính sách trả lại hàng trực tuyến, cho phép người dùng API tạo, cập nhật và xoá chính sách trả lại hàng.
  • Ra mắt OmnichannelSettingsService và tài nguyên OmnichannelSetting, cho phép người dùng API quản lý trải nghiệm đa kênh của họ.
  • Ra mắt LfpProvidersService và tài nguyên LfpProvider, cho phép người dùng API quản lý mối quan hệ Đối tác nguồn cấp dữ liệu tại địa phương.
  • Ra mắt GbpAccountsService và tài nguyên GbpAccount cho phép người dùng API quản lý Trang doanh nghiệp trên Google.
    • Khởi chạy LocalListingManagement loại dịch vụ trong AccountService, liên kết nhóm doanh nghiệp được dùng cho Quảng cáo kho hàng tại địa phương hoặc Trang thông tin miễn phí tại địa phương.

Tuần bắt đầu từ ngày 28 tháng 4 năm 2025

  • Ra mắt tài nguyên AccountService và AccountRelationship, cho phép người dùng API quản lý mối quan hệ và thiết lập các dịch vụ cho nhà cung cấp dịch vụ.

Tuần bắt đầu từ ngày 14 tháng 4 năm 2025

  • TermsOfServiceService.AcceptTermsOfService hiện trả về TermsOfServiceAgremeentState đã được chấp nhận trong một loại phản hồi.

  • Động từ của thao tác TermsOfServiceService.AcceptTermsOfService hiện là POST (trước đây là GET).

  • Làm rõ rằng cần gọi AccountsService.ListSubAccounts bằng định dạng accounts/... (thay vì providers/...). Điều này nhằm tránh phương thức này nằm ngoài phạm vi accounts (tức là GET accounts/123:listSubAccounts thay vì GET providers/123:listSubAccounts).

Tuần bắt đầu từ ngày 31 tháng 3 năm 2025

  • Đối với việc lọc tài khoản, bộ lọc externalAccountId đã được thông báo là không dùng nữa kể từ tuần ngày 2 tháng 12 năm 2024 và hiện không dùng được nữa. Điều này có nghĩa là giờ đây, bạn chỉ có thể lọc theo externalAccountId ở cấp service. Bộ lọc như relationship(externalAccountId = "foo") sẽ không hoạt động nữa và cần được biểu thị dưới dạng relationship(service(externalAccountId = "foo")).

  • Làm rõ trong tài liệu AccountsService rằng bạn không thể tạo tài khoản độc lập.

Tuần bắt đầu từ ngày 3 tháng 3 năm 2025

– accounts.onlineReturnPolicies#SeasonalOverride đã được tái cấu trúc để cải thiện tính rõ ràng và nhất quán. Những thay đổi này bao gồm:

  • Đổi tên trường:
    • begin đổi tên thành start_date
    • end đổi tên thành end_date
  • Xoá trường:
    • Đã xoá trường policy không dùng nữa.

– Nhà phát triển nên cập nhật mã để phản ánh những thay đổi này.

Ra mắt dịch vụ AutomaticImprovements mà bạn có thể dùng để quản lý những nội dung sau:

Để biết thêm thông tin, hãy xem bài viết Bật tính năng cải thiện tự động.

Tuần từ ngày 17 tháng 2 năm 2025

Đã xoá vị từ callerHasAccessToProviderFilter() khỏi bộ lọc tài khoản.

Tuần từ ngày 10 tháng 2 năm 2025

  • Cải thiện tài liệu cho phương thức AccountsService.List. Thao tác này trả về tất cả tài khoản mà người dùng có quyền truy cập, chứ không chỉ tài khoản độc lập.

  • Thêm thời hạn mặc định là 10 phút cho tất cả các phương thức RPC.

  • Thêm danh sách tên chương trình có sẵn vào phần mô tả tài nguyên accounts.programs.

  • User.accessRights hiện là REQUIRED, ảnh hưởng đến cả phương thức UserService.Create và AccountsService.CreateAndConfigure.

Tuần từ ngày 27 tháng 1 năm 2025

AccountsService.ListAccounts (và AccountsService.ListSubAccounts một cách gián tiếp) hiện trả về các tài khoản theo cách nhất quán cuối cùng thay vì là một lượt đọc mạnh.

Tuần từ ngày 20 tháng 1 năm 2025

Trường users của CreateAndConfigureAccountRequest không còn dùng nữa mà thay bằng user mới. CreateUserRequest được tham chiếu có chứa trường parent không bắt buộc trong ngữ cảnh của CreateAndConfigureAccountRequest.

Tuần bắt đầu từ ngày 6 tháng 1 năm 2025

Giờ đây, trường user của thông báo CreateUserRequest được đánh dấu chính xác là OPTIONAL.

Trường domain trong các lỗi được trả về hiện được điền sẵn bằng merchantapi.googleapis.com thay vì global

Tuần từ ngày 2 tháng 12 năm 2024

Đối với việc lọc tài khoản, vị từ externalAccountId sẽ được chuyển đến cấp service từ cấp relationship. Vì vậy, bộ lọc relationship(externalAccountId = "foo") giờ đây sẽ cần được viết dưới dạng relationship(service(externalAccountId = "foo")). Định dạng cũ vẫn được hỗ trợ để đảm bảo khả năng tương thích ngược, nhưng đã không còn được dùng nữa và sẽ gây ra lỗi trong tương lai gần. Tất cả tài liệu sẽ chỉ đề cập đến định dạng mới.

Tuần từ ngày 18 tháng 11 năm 2024

Nhà cung cấp trong trường CreateAndConfigureAccountRequest.service.provider hiện cũng có thể là một trong các nhà cung cấp providers/GOOGLE_ADS hoặc providers/GOOGLE_BUSINESS_PROFILE. Các tài khoản khác phải được gọi là providers/123 (thay vì accounts/123). Điều này có nghĩa là trường này không còn được chú thích là thông tin tham chiếu về tài khoản nữa. Tuy nhiên, bạn vẫn có thể sử dụng tên tài khoản như accounts/123 để đảm bảo khả năng tương thích ngược.

Giờ đây, trình cung cấp trong ListSubAccountsRequest sẽ có dạng providers/123, nhưng để đảm bảo khả năng tương thích ngược, bạn vẫn có thể sử dụng accounts/123.

Tuần từ ngày 4 tháng 11 năm 2024

Đánh dấu promotions_consent REQUIRED (từ OPTIONAL) trong tài nguyên BusinessIdentity. Điều này chỉ ảnh hưởng đến phương thức cập nhật. Điều này nhằm làm rõ rằng bạn không thể cập nhật promotions_consent thành UNSPECIFIED. Trước đây, bạn không thể làm việc này, nhưng giờ đây, lỗi này có nội dung mô tả cụ thể hơn và trường này được chú thích chính xác.

Tuần từ ngày 28 tháng 10 năm 2024

Cải thiện tài liệu về nhiều tài nguyên của API phụ Tài khoản, chẳng hạn như User, Homepage, BusinessInfo, v.v.

Tuần từ ngày 21 tháng 10 năm 2024

Cải thiện tài liệu về các trường update_mask trong yêu cầu cập nhật để chỉ ra cụ thể những trường được hỗ trợ cho việc cập nhật.

Đã thêm đường liên kết đến trung tâm trợ giúp của Google Doanh nghiệp cho các hãng vận chuyển được hỗ trợ vào tài liệu bên ngoài của tài nguyên ShippingSettings

Tuần từ ngày 14 tháng 10 năm 2024

Đánh dấu provider là REQUIRED trong AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

Bạn có thể đặt update_mask là không bắt buộc trong toàn bộ API phụ về Tài khoản (ví dụ: danh tính doanh nghiệp, thông tin doanh nghiệp, trang chủ, v.v.) và áp dụng hồi tố cho tài nguyên ConversionSources.

Thêm tham số overwrite vào ClaimHomepageRequest.

Tuần từ ngày 30 tháng 9 năm 2024

Ra mắt tham số "force" cho phương thức "Accounts.delete".

Tuần từ ngày 23 tháng 9 năm 2024

Đánh dấu region_code và kind là REQUIRED trong RetrieveLatestTermsOfServiceRequest.

Tuần từ ngày 16 tháng 9 năm 2024

Thay đổi loại của tham số time_zone thành chuỗi trong ListAccountIssuesRequest

Tuần bắt đầu từ ngày 12 tháng 8 năm 2024

Đã thêm trường korean_business_registration_number vào tài nguyên BusinessInfo.

Tuần từ ngày 27 tháng 5 năm 2024

Ra mắt phiên bản thử nghiệm của API phụ Tài khoản