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

Tuần từ ngày 20 tháng 4 năm 2026

• Đã thêm youtube-affiliate vào danh sách tên chương trình hiện có trong accounts.programs mô tả tài nguyên.
• Bật API chương trình cho chương trình tiếp thị liên kết của YouTube Shopping. Dành cho người kiểm tra đáng tin cậy.

Tuần từ ngày 6 tháng 4 năm 2026

• Đã thêm trạng thái WAITING vào Trạng thái phê duyệt. Đối với Dịch vụ so sánh giá (CSS), WAITING là trạng thái chuyển tiếp giữa PENDING và ESTABLISHED. Trạng thái này được dùng khi CSS ban đầu cần thời gian để thực hiện mọi thao tác dọn dẹp cần thiết trước khi tài khoản được chuyển hoàn toàn sang CSS mới.

Tuần từ ngày 16 tháng 3 năm 2026

• Ra mắt phương thức CreateTestAccount trong API Tài khoản. Phương thức này cho phép nhà phát triển tạo tài khoản thử nghiệm chuyên dụng theo phương thức lập trình, hoạt động trong một môi trường hộp cát biệt lập, cung cấp một không gian an toàn để phát triển và kiểm thử các hoạt động tích hợp.

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

• CreateAndConfigureAccountRequest hiện cung cấp các dịch vụ mới có thể được định cấu hình trong quá trình thiết lập tài khoản. Bạn phải chỉ định chính xác một trong các dịch vụ AccountAggregation, AccountManagement và ComparisonShopping. Ngoài ra, bạn có thể chỉ định số lượng tuỳ ý các dịch vụ ProductsManagement và CampaignsManagement. Tuy nhiên, không được có 2 dịch vụ như vậy có cùng nhà cung cấp và mã tài khoản bên ngoài.

• Phương thức AccountsService.CreateAndConfigure hiện cung cấp một chế độ cài đặt để kiểm soát việc có nên gửi email xác minh hay không.

• CreateAndConfigureAccountRequest.AddAccountService hiện có trường external_account_id (trường này đã tồn tại trên tài nguyên AccountService) . Bạn có thể chỉ định trường này cùng với các dịch vụ CampaignsManagement và ProductsManagement.

• Đã thêm dịch vụ ComparisonShopping vào tài nguyên AccountService. Hãy xem https://support.google.com/merchants/answer/12653197 để biết thêm thông tin.

• Giờ đây, bạn có thể đặt bí danh cho mối quan hệ trong quá trình tạo tài khoản bằng cách sử dụng trường setAlias trong CreateAndConfigureAccountRequest.

• Đã thêm phương thức VerifySelf vào UserService cho phép cập nhật trạng thái từ PENDING thành VERIFIED cho tài nguyên User đại diện cho người dùng thực hiện lệnh gọi.

• Ra mắt trường radius_area mới trong tải trọng Region của API Khu vực. Trường này cho phép người bán tạo khu vực bằng cách sử dụng khu vực bán kính.

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

• Phát hành phiên bản v1alpha cho API Dịch vụ.
• Ra mắt trường product_filters mới trong tải trọng CampaignManagement của API Dịch vụ. Trường này cho phép người bán chỉ chia sẻ một nhóm con của nguồn cấp dữ liệu với tài khoản Google Ads, dựa trên một số điều kiện lọc về các thuộc tính của sản phẩm của người bán. Đây là một tính năng chỉ dành cho một số ít người bán được đưa vào danh sách cho phép.

Tuần từ ngày 25 tháng 8 năm 2025

• Đã thêm các phương thức hàng loạt mới vào API Khu vực:
  • BatchCreateRegions: Cho phép tạo nhiều khu vực trong một yêu cầu.
  • BatchUpdateRegions: Cho phép cập nhật nhiều khu vực trong một yêu cầu.
  • BatchDeleteRegions: Cung cấp khả năng xoá nhiều khu vực theo tên trong một yêu cầu.

Tuần 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 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ị duy nhất có thể là CAN_UPLOAD_PRODUCTS. Bộ lọc này cho phép bạn truy xuất các tài khoản có thể tải sản phẩm lên. Điều này có nghĩa là 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ó thể đọc. Người dùng có quyền truy cập chỉ có thể đọc có thể xem dữ liệu người bán nhưng không thể sửa đổi dữ liệu đó.

Tuần từ ngày 19 tháng 5 năm 2025

• Đã cập nhật tài liệu cho API chương trình, xoá câu lệnh 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 từ ngày 12 tháng 5 năm 2025

• Ra mắt tài nguyên Chính sách trả 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ả 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.
• 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ệ Hợp tác nguồn cấp dữ liệu đị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.
• Phát hành loại dịch vụ LocalListingManagement trong AccountService, liên kết nhóm địa điểm kinh doanh đượ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 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 dịch vụ cho nhà cung cấp dịch vụ.

Tuần từ ngày 14 tháng 4 năm 2025

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

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

• Đã làm rõ rằng AccountsService.ListSubAccounts cần được gọi bằng cách sử dụng định dạng accounts/... (thay vì providers/...). Điều này là để tránh việc phương thức này nằm ngoài phạm vi accounts (nghĩa là GET accounts/123:listSubAccounts thay vì GET providers/123:listSubAccounts).

Tuần 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 trong tuần từ ngày 2 tháng 12 năm 2024 và hiện không dùng được. Đ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 còn hoạt động 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 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. Các nội dung cập nhật này bao gồm:

• Đổi tên trường:
  • begin hiện là start_date.
  • end hiện là 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:

• Thông tin cập nhật về mặt hàng
• Cải thiện hình ảnh
• Cải thiện thông tin vận chuyển

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

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. Phương thức này trả về tất cả các tài khoản mà người dùng có quyền truy cập, không chỉ các 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 hiện có vào accounts.programs phần mô tả tài nguyên.

• 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 bắc cầu) 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 thao tác đọc mạnh.

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

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

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

Trường user của thông báo CreateUserRequest hiện đượ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 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 được chuyển từ cấp relationship sang cấp service. Vì vậy, bộ lọc relationship(externalAccountId = "foo") giờ đây 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 dùng nữa và sẽ gửi 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 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à tham chiếu 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.

Nhà cung cấp trong ListSubAccountsRequest hiện phải 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 là để 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ể thực hiện việc này, nhưng giờ đây, lỗi này mang tính mô tả hơn và trường đượ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 của 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 của các trường update_mask trong yêu cầu cập nhật để chỉ rõ 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 Business cho các nhà 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.

Đặt update_mask là không bắt buộc trong suốt API phụ Tài khoản (ví dụ: thông tin nhận dạng doanh nghiệp, thông tin doanh nghiệp, trang chủ, v.v.) và 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 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