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

Tuần từ ngày 26 tháng 10 năm 2026

  • Làm rõ tài liệu về phương thức accounts.homepage.unclaim và trường claimed của tài nguyên Homepage. Nếu một tài khoản kế thừa trạng thái xác nhận quyền sở hữu trang chủ từ tài khoản nâng cao, thì unclaim sẽ trả về một phản hồi thành công, nhưng trang chủ vẫn được xác nhận quyền sở hữu. Nếu chính tài khoản đó được miễn xác nhận quyền sở hữu, thì unclaim sẽ trả về lỗi FAILED_PRECONDITION.

Tuần từ ngày 28 tháng 9 năm 2026

  • Thêm youtube_affiliate_management làm loại dịch vụ vào tài nguyên AccountService trong v1alpha. Lưu ý: Tính năng Quản lý đơn vị liên kết trên YouTube là một tính năng có quyền truy cập hạn chế.

  • Ra mắt phiên bản Alpha của dịch vụ LoyaltyPrograms mà bạn có thể dùng để quản lý chương trình khách hàng thân thiết. Tính năng này chỉ dành cho một số người bán. Để biết thêm thông tin, hãy xem bài viết Tổng quan về chương trình khách hàng thân thiết.

  • Thêm trường home_page_uri chỉ có thể đọc vào tài nguyên accounts để trả về URI của trang chủ cửa hàng.

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

  • Thêm "ucp_checkout_management" làm loại dịch vụ vào tài nguyên dịch vụ tài khoản. Lưu ý: Tính năng thanh toán qua UCP là một tính năng có quyền truy cập hạn chế.
  • Thêm tính năng hỗ trợ cho chương trình "ucp-integration" (quyền truy cập bị hạn chế).
  • Thêm tính năng hỗ trợ cho loại điều khoản dịch vụ "ucp_integration".

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

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 có sẵn cho nội dung mô tả tài nguyên accounts.programs.
  • 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 thử nghiệm đáng tin cậy.

Tuần bắt đầu 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. Được sử dụng khi CSS ban đầu cần thời gian để thực hiện mọi hoạt động 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 Accounts API. Điều 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 tách biệt giống như hộp cát, mang đến một không gian an toàn để phát triển và thử nghiệm 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 mà bạn có thể đị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 thuộc tính AccountAggregation, AccountManagement và ComparisonShopping. Ngoài ra, bạn có thể chỉ định số lượng dịch vụ ProductsManagement và CampaignsManagement tuỳ ý. Tuy nhiên, không được có hai dịch vụ như vậy có cùng mã 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ó một 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 dịch vụ 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ột 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 cuộc gọi.

  • Ra mắt trường radius_area mới trong tải trọng Region của Regions API để người bán có thể tạo khu vực bằng 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 Services API.
  • Ra mắt trường product_filters mới trong tải trọng CampaignManagement của Services API, cho phép người bán chỉ chia sẻ một nhóm nhỏ trong nguồn cấp dữ liệu của họ với các tài khoản Google Ads, dựa trên một số bộ lọc có điều kiện về thuộc tính của sản phẩm của người bán. Đây là tính năng chỉ dành cho những người bán có trong danh sách cho phép. Chỉ một số ít người bán có thể sử dụng tính năng này.

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

  • Các phương thức theo lô mới được thêm vào Regions API:
    • 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á và lấy 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ể có là CAN_UPLOAD_PRODUCTS. Bộ lọc này giú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 chỉ có thể đọc. Người dùng có quyền chỉ có thể đọc có thể xem dữ liệu của 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á tuyên bố không chính xác rằng các phương thức Enable/Disable bị hạn chế đối với 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ả 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ệ của họ với Đối 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.
  • Ra mắt 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 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ý các 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 định dạng accounts/... (thay vì providers/...). Việc 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 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 còn được dùng nữa trong tuần bắt đầu từ 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à bạn hiện chỉ có thể lọc theo externalAccountId ở cấp service. Một 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 về AccountsService rằng người dùng 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 cải tiến để tăng độ rõ ràng và tính 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:
    • Trường policy không dùng nữa đã bị xoá.

– 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 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ả 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 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ì đọ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 được dùng nữa, thay vào đó là user mới. CreateUserRequest được tham chiếu chứa trường parent không bắt buộc trong ngữ 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 lỗi được trả về hiện được điền sẵn merchantapi.googleapis.com thay vì global

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

Để lọc tài khoản, vị từ externalAccountId được chuyển sang cấp service từ cấp relationship. Vì vậy, bộ lọc relationship(externalAccountId = "foo") giờ đây cần được viết là 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ẽ báo 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 dưới dạng tham chiếu tài khoản. 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 để 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. Tôi xin làm rõ rằng bạn không thể cập nhật promotions_consent thành UNSPECIFIED. Điều này vốn không thể thực hiện được, nhưng giờ đây, lỗi này đã được mô tả rõ ràng 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ợ 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 nhà mạng đượ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 thành không bắt buộc trong toàn bộ API phụ Accounts (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 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 API phụ Accounts ở giai đoạn thử nghiệm