Thông tin mới nhất

Nhận thông báo mới nhất về các tính năng mới, bản sửa lỗi và bản cập nhật phát hành.

Tháng 10 năm 2026

Tháng 10/2026

Tính năng mới:

  • Báo cáo và chính sách dành cho nhà phát triển về chương trình liên kết của YouTube Shopping (v1alpha):

  • URI trang chủ của cửa hàng trong API phụ Accounts: thêm trường chỉ đọc homePageUri vào tài nguyên accounts để trả về URI trang chủ của cửa hàng.

  • Bổ sung thuộc tính cho API phụ Sản phẩm:

    • Đường liên kết đến chứng nhận sản phẩm và enum hiệu suất năng lượng của Vương quốc Anh: đã thêm các trường certificationDocumentLink và certificationLabelLink, cùng với cơ quan chứng nhận của Bộ An ninh Năng lượng và Phát thải ròng bằng không (DESNZ) và enum tên chứng nhận GB_ENERGY_INFORMATION, vào ProductCertification trong ProductAttributes. Để biết thêm thông tin, hãy xem phần Chứng nhận.
    • Hạn mức quãng đường đã đi cho các khoản trả góp xe: thêm mileageAllowance vào ProductInstallment trong ProductAttributes để chỉ định hạn mức quãng đường đã đi cho hợp đồng cho thuê xe.
    • Đường liên kết của video ở cấp sản phẩm: thêm thuộc tính videoLinks vào ProductAttributes để gửi video ở cấp sản phẩm trên quy mô lớn.

  • Tài liệu mới về nhà cung cấp dịch vụ bên thứ ba (3P):

  • Mã mẫu Java mới để quản lý tính năng phân lô theo khu vực:

  • Báo cáo hiệu suất của tác nhân UCP (v1alpha): thêm hai chế độ xem báo cáo mới vào accounts.reports.search trong Reports sub-API (v1alpha) để truy xuất các chỉ số hiệu suất về lượt thanh toán và lượt chuyển đổi của UCP trên các nền tảng của Google, bao gồm cả Chế độ AI trong Tìm kiếm và Gemini:

    • UcpAgenticPerformanceView: báo cáo các chỉ số về phễu chuyển đổi, đơn đặt hàng, lượt huỷ và lượt chuyển giỏ hàng ở cấp tài khoản, được phân đoạn theo ngày và quốc gia của khách hàng.
    • UcpAgenticProductPerformanceView: báo cáo các chỉ số về lượt nhấp vào nút mua offerId ở cấp sản phẩm, được phân đoạn theo ngày và quốc gia của khách hàng.
    • Xuất bản hướng dẫn Phân tích hiệu suất của tác nhân UCP (Alpha) kèm theo các truy vấn mẫu bằng Ngôn ngữ truy vấn Merchant Center (MCQL).

Những điều đã thay đổi:

  • Mở rộng phạm vi hỗ trợ thuộc tính bảo hành: tổng quát hoá thuộc tính warranty trong ProductAttributes ngoài trang thông tin về xe để hỗ trợ tất cả sản phẩm, đồng thời cho phép chỉ định thời hạn bảo hành theo tháng hoặc năm.
  • Chuẩn hoá vấn đề về tài khoản ở cấp sản phẩm: hiển thị các vấn đề cụ thể về việc tạm ngưng tài khoản ngay trên các sản phẩm bị ảnh hưởng thay vì hiển thị dưới dạng ACCOUNT_DISAPPROVAL chung chung, giúp chẩn đoán rõ ràng hơn về tác động ở cấp sản phẩm, phương pháp tiếp thị và quốc gia.
  • Ngừng sử dụng YoutubeProductPerformanceView (v1alpha): ngừng sử dụng YoutubeProductPerformanceView trong API phụ Báo cáo (v1alpha) để chuyển sang YoutubeProductSoldStatsView và YoutubeProductTaggedStatsView.
  • Giá trị mặc định của tính năng phân trang API phụ thông báo và hướng dẫn mới: chuẩn hoá tính năng phân trang accounts.notificationsubscriptions.list bằng pageSize không bắt buộc, mặc định là 100 (tối đa 200) và xuất bản hướng dẫn mới về cách thiết lập thông báo đẩy cho các thay đổi về dịch vụ tài khoản.
  • Sắp xếp lại tài liệu tham khảo cũng như hướng dẫn về hạn mức và giới hạn: xoá tất cả các trang tham khảo REST và RPC phiên bản v1beta đã ngừng hoạt động khỏi trang web dành cho nhà phát triển, đồng thời sắp xếp lại hạn mức và giới hạn thành các hướng dẫn riêng cho hạn mức API và hạn mức trong tài khoản.

Tháng 8 năm 2026

Tháng 8 năm 2026

Tính năng mới:

  • Content API for Shopping đã ngừng hoạt động từ ngày 18 tháng 8 năm 2026. Tất cả nhà phát triển phải di chuyển các công cụ tích hợp hiện có sang Merchant API sớm nhất có thể. Để biết thêm thông tin, hãy xem phần Ngừng sử dụng và ngừng hoạt động.
  • Tích hợp tài khoản Giao thức thương mại toàn cầu (UCP): đã thêm UcpCheckoutManagement làm loại dịch vụ trong tài nguyên Account Service, cùng với việc hỗ trợ chương trình ucp-integration và điều khoản dịch vụ ucp_integration có quyền truy cập hạn chế.
  • Thay thế chính sách trả lại hàng ở cấp mặt hàng: thêm thuộc tính returns trong ProductAttributes để định cấu hình và thay thế chính sách trả lại hàng (ví dụ: quốc gia, số ngày của thời hạn, phí trả lại hàng, tình trạng) ngay ở cấp mặt hàng.
  • Thuộc tính bất động sản cho thuê: thêm các thuộc tính chính của trang thông tin, bao gồm cả leaseTerm vào ProductAttributes, để gửi dữ liệu quảng cáo cho thuê.
  • Các điểm cải tiến đối với API phụ Kho hàng:
  • Thông báo về dịch vụ tài khoản: đã thêm ACCOUNT_SERVICE làm NotificationEventType được hỗ trợ trong API phụ Thông báo để theo dõi các thay đổi về trạng thái trên dịch vụ tài khoản. Để biết thêm thông tin về thông báo về các thay đổi đối với dịch vụ tài khoản, hãy xem bài viết Nhận thông báo đẩy về các thay đổi đối với dịch vụ tài khoản.
  • Chế độ xem báo cáo về chương trình tiếp thị liên kết của YouTube Shopping (v1alpha):
  • Điểm cuối của tính năng So khớp khách hàng thân thiết: tải lên và quản lý dữ liệu khách hàng thân thiết để hiển thị các lợi ích theo cấp (ví dụ: giá thành viên) trong kết quả tìm kiếm tự nhiên. Để biết thêm thông tin về dữ liệu khách hàng thân thiết, hãy xem bài viết Tổng quan về dịch vụ So khớp khách hàng thân thiết.
  • Kho lưu trữ công khai của thư viện ứng dụng Alpha: thư viện alpha cho API phụ Bài đánh giá trên Python, Java, PHP, C#, Ruby, Node.js và Go hiện đã có trong kho lưu trữ công khai trên GitHub.

Những điều đã thay đổi:

  • Bộ lọc cấp truy cập ListAccounts: ra mắt tham số access hỗ trợ DIRECT, INDIRECT và ALL để lọc tài khoản dựa trên quyền của phương thức gọi. Bạn có thể dùng thuộc tính này để phân biệt giữa tài khoản nâng cao và tài khoản phụ.
  • DataSources quy trình xác thực hạn mức và quy tắc:
    • Ra mắt tính năng quản lý hạn mức tự động cho các nguồn dữ liệu trên tài khoản nâng cao. Để biết thêm thông tin, hãy xem phần Tìm hiểu về hạn mức và giới hạn.
    • Đã thêm quy trình xác thực quy tắc yêu cầu các quy tắc mặc định trong nguồn dữ liệu sản phẩm chính phải chứa đúng một thông tin tham chiếu đến self hoặc một nguồn dữ liệu chính.
    • Ngừng sử dụng primaryDataSourceName trong DataSourceReference và thay bằng self.
  • Cải thiện độ trễ: giảm mức hao tổn API cho các lệnh gọi chèn, cập nhật và xoá sản phẩm.

Nội dung sắp ra mắt:

  • Ngừng sử dụng và tắt Content API for Shopping: lời nhắc chuyển sang Merchant API mới. Để khuyến khích việc di chuyển trước khi ngừng hoạt động hoàn toàn và đảm bảo rằng nhà phát triển thấy thông báo ngừng hoạt động trong nhật ký ứng dụng, Google sẽ áp dụng quy trình hạ cấp dịch vụ dần dần kể từ ngày 1 tháng 9 năm 2026. Để biết thêm thông tin, hãy xem mục Lịch trình ngừng hoạt động của Content API for Shopping.

Tháng 5 năm 2026

Tháng 5 năm 2026

Tính năng mới:

Những điều đã thay đổi:

  • Phiên bản v1beta của Merchant API đã ngừng hoạt động. Giờ đây, tất cả lệnh gọi API phải được chuyển đến phiên bản v1 hoặc v1alpha. Để biết các bước di chuyển, hãy xem bài viết Di chuyển từ phiên bản v1beta sang v1.
  • Giờ đây, bạn có thể cập nhật thường xuyên hơn ở cấp thuộc tính cho price và availability thông qua phương thức patch trong API phụ Products. Tính năng này giúp tăng độ mới của dữ liệu bằng cách cho phép bạn cập nhật các thuộc tính cụ thể này với độ trễ thấp hơn. Hiện tại, tính năng này chỉ dành cho những người bán có trong danh sách cho phép. Để tìm hiểu thêm hoặc yêu cầu quyền truy cập, hãy liên hệ với người đại diện của Google.

Nội dung sắp ra mắt:

  • Phân tích hiệu suất của tác nhân bằng UCP trong Reports API.

Tháng 1 năm 2026

Tháng 1 năm 2026

Tính năng mới:

Những điều đã thay đổi:

  • Thêm InventoryLoyaltyProgram vào dịch vụ kho hàng tại địa phương để người dùng có thể kiểm soát hợp nhất các tính năng khách hàng thân thiết, chẳng hạn như chiết khấu, hoàn tiền cho các giao dịch mua trong tương lai và điểm khách hàng thân thiết.

Nội dung sắp ra mắt:

  • Ngừng cung cấp Merchant API phiên bản 1beta từ ngày 28 tháng 2 năm 2026. Hãy chuyển tất cả lệnh gọi API sang phiên bản v1 và v1alpha tương ứng trước thời hạn ngừng hoạt động của phiên bản v1beta.
  • Khả năng bật và tắt chương trình Đánh giá sản phẩm thông qua Reviews API v1alpha, giúp đơn giản hoá quy trình gửi và quản lý bài đánh giá sản phẩm.

Tháng 11 năm 2025

Tháng 11 năm 2025

Tính năng mới:

  • Thông tin chi tiết mới cho số liệu phân tích về chương trình tiếp thị liên kết của YouTube Shopping (v1alpha), trong API phụ Báo cáo để truy xuất số liệu phân tích về nhà sáng tạo, nội dung và sản phẩm được giới thiệu trên YouTube. Báo cáo này cung cấp thông tin tương đương với các báo cáo hiện có trong Google Merchant Center (GMC).
  • Công cụ chẩn đoán API đã nâng cấp để hỗ trợ quá trình di chuyển sang Merchant API(phiên bản 1).
  • Thêm một trường mới product_filters vào API phụ Accounts để 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. Tính năng này chỉ dành cho một số ít người bán.
  • Bổ sung tính năng hỗ trợ tạo tài khoản độc lập cho người bán trên các nền tảng thương mại điện tử.
  • Thêm hai phương thức mới là accounts.limits.get và accounts.limits.list để truy vấn hạn mức tài khoản trong Quota API.

Những điều đã thay đổi:

  • Tính năng hỗ trợ tự động phát hiện và giải mã nội bộ mã sản phẩm được mã hoá base64url hiện đã có trong tất cả các phương thức sử dụng mã sản phẩm.

Nội dung sắp ra mắt:

Tháng 9 năm 2025

Tháng 9 năm 2025

Tính năng mới:

  • Dịch vụ Giao thức ngữ cảnh mô hình (MCP) đầu tiên cho Merchant API hiện đã được cung cấp.
    • Dịch vụ MCP mới tích hợp tài liệu chính thức về API của Google vào trợ giúp lập trình Môi trường phát triển tích hợp (IDE) để đẩy nhanh quá trình tích hợp Merchant API và cải thiện độ chính xác của quy trình di chuyển.
  • Một phương thức mới, getAccountForGcpRegistration trong API phụ Accounts để truy xuất tài khoản nhà bán hàng đã đăng ký với Google Cloud.

Những điều đã thay đổi:

  • Các phương thức mới để quản lý Khu vực trong API phụ Accounts.
    • Ra mắt 3 phương thức mới là batchCreate, batchDelete và batchUpdate để cho phép gom lệnh gọi theo lô cho các thao tác create, update và delete đối với Khu vực trong Accounts sub-API nhằm hỗ trợ việc quản lý khu vực và giảm thiểu các hạn chế của lệnh gọi one-region-per-request.
  • Một cấu hình vận chuyển dựa trên hãng vận chuyển mới hiện có trong API phụ Sản phẩm để chỉ định các thuộc tính vận chuyển ở cấp sản phẩm.

Nội dung sắp ra mắt:

  • Các báo cáo mới cho số liệu phân tích về chương trình tiếp thị liên kết của YouTube Mua sắm, chẳng hạn như v1alpha trong API phụ Báo cáo để truy xuất số liệu phân tích về nhà sáng tạo, nội dung và sản phẩm xuất hiện trên YouTube, tương đương với các báo cáo có trong Google Merchant Center.
  • Cho phép cập nhật sản phẩm thường xuyên hơn đối với các thuộc tính tình trạng còn hàng và giá.
  • Dễ dàng phân tích lỗi API hơn nhờ ErrorInfo và siêu dữ liệu phong phú.

Tháng 7 năm 2025

Tháng 7 năm 2025

Tính năng mới:

  • Merchant API (phiên bản 1) – API chính thức thay thế cho Content API for Shopping hiện đã được phát hành rộng rãi.

    Điều này có nghĩa là từ nay về sau, Merchant API sẽ chỉ có các API phụ v1alpha và v1, trong đó hầu hết các phiên bản v1beta sẽ được nâng cấp lên v1. Hãy theo dõi để biết thêm thông tin.

  • Có tài nguyên mới.

    • Tài nguyên hình ảnh trong API Product Studio (phiên bản alpha) tận dụng AI tạo sinh để tạo nền mới cho sản phẩm, xoá nền hình ảnh và nâng cao độ phân giải hình ảnh.
    • Thanh toán trên trang web của người bán trong API phụ Accounts cung cấp khả năng tạo, cập nhật, xoá và lấy chế độ cài đặt thanh toán của bạn.
    • Chính sách trả lại hàng trực tuyến trong API phụ Accounts đã được di chuyển, chức năng dành cho người dùng vẫn không thay đổi. Những điểm cải tiến nhỏ về kỹ thuật, chẳng hạn như các trường đã lỗi thời và việc đổi tên các trường hiện có, đã bị loại bỏ để đảm bảo tính nhất quán.
    • AccountIdAlias trong tài nguyên AccountRelationship trong API phụ Accounts sử dụng một bí danh do người dùng xác định thay vì mã nhận dạng nội bộ (mã tài khoản). Điều này giúp bạn dễ dàng quản lý các cấu trúc tài khoản phức tạp, chẳng hạn như sử dụng bí danh do người dùng xác định cho trang web thương mại thay vì mã nhận dạng nội bộ.

  • Người dùng Apps Script hiện có thể truy cập vào Merchant API.

  • Phương thức AggregateProductStatuses mới hiện đã có trong API Giải quyết vấn đề để truy vấn số liệu thống kê tổng hợp về trạng thái sản phẩm.

Những điều đã thay đổi:

  • Khả năng tạo tài khoản độc lập cho các nền tảng xây dựng cửa hàng và CSS. Trước đây, các tài khoản nhà bán hàng được tạo trong một tài khoản nâng cao duy nhất.

  • Thứ hạng tiềm năng tạo lượt nhấp trong bảng productView trong API phụ Báo cáo. Giờ đây, thứ hạng của sản phẩm dựa trên clickPotential được chuẩn hoá thành các giá trị từ 1 đến 1000. Sản phẩm có clickPotentialRank thấp vẫn có click potential cao nhất trong số các sản phẩm của người bán đáp ứng các điều kiện của cụm từ tìm kiếm.

Nội dung sắp ra mắt:

  • Truy cập thông qua máy chủ Giao thức ngữ cảnh mô hình (MCP) (v1alpha).

Tháng 5 năm 2025

Tháng 5 năm 2025

Tính năng mới:

  • Chúng tôi đã ra mắt hai API phụ mới.
    • Tính năng Theo dõi đơn đặt hàng hỗ trợ nhật ký theo dõi đơn đặt hàng của doanh nghiệp để cung cấp thông tin ước tính chính xác về việc vận chuyển cho khách hàng. Các tín hiệu của tính năng này cũng giúp trang thông tin nâng cao bằng dịch vụ vận chuyển nhanh và miễn phí.
    • Giải quyết vấn đề cung cấp quyền truy cập vào nội dung chẩn đoán và các hành động hỗ trợ giống như trong giao diện người dùng Merchant Center.
  • Các tài nguyên mới có trong API phụ Tài khoản.
    • OmnichannelSettings quản lý cấu hình tài khoản cho hoạt động phân phát đa kênh, chẳng hạn như Trang thông tin miễn phí tại địa phương (FLL) và Quảng cáo kho hàng tại địa phương (LIA).
    • LfpProviders kết nối với các đối tác của Chương trình đối tác nguồn cấp dữ liệu địa phương (LFP) để lấy dữ liệu kho hàng.
    • GbpAccounts kết nối với tài khoản Trang doanh nghiệp trên Google để lấy dữ liệu cửa hàng tại địa phương.
    • OnlineReturnPolicy cung cấp khả năng tạo, xoá và cập nhật các chính sách trực tuyến của bạn.
  • Có một phương thức mới trong API phụ Products.
    • ProductsUpdate cho phép bạn cập nhật từng sản phẩm mà không cần cung cấp tất cả các trường bắt buộc cho ProductInput.

Những điều đã thay đổi:

  • Số lượng pageSize tối đa tăng từ 250 lên 1.000 hàng cho mỗi lệnh gọi API.
  • Đã khắc phục tình trạng chậm trễ khi chèn sản phẩm, chương trình khuyến mãi, bài đánh giá sản phẩm và bài đánh giá người bán sau khi tạo DataSources.

Nội dung sắp ra mắt:

  • Ngừng sử dụng và xoá trường kênh cho DataSources và sản phẩm.
  • Ra mắt định nghĩa mới cho clickPotentialRank trong bảng productView trong API phụ Báo cáo:
    • Thứ hạng của sản phẩm dựa trên clickPotential được chuẩn hoá thành các giá trị từ 1 đến 1000.
    • Sản phẩm có clickPotentialRank thấp vẫn có tiềm năng tạo lượt nhấp cao nhất trong số các sản phẩm của người bán đáp ứng các điều kiện của cụm từ tìm kiếm. Đây là một thay đổi không gây lỗi và có thể được triển khai vào ngày 1 tháng 7 năm 2025.
  • AccountIdAlias trong tài nguyên AccountRelationship giúp bạn quản lý các cấu trúc tài khoản phức tạp hiệu quả hơn. Ví dụ: trang web thương mại sử dụng bí danh do người dùng xác định thay vì mã nhận dạng nội bộ của người bán, chẳng hạn như mã tài khoản.

Tháng 4 năm 2025

Tháng 4 năm 2025

Tính năng mới:

Những điều đã thay đổi:

  • Giờ đây, chúng tôi hỗ trợ các vị trí xuất hiện (được gọi là phương pháp tiếp thị trong Merchant Center) cho API phụ Nguồn dữ liệu.
  • Chúng tôi đã thực hiện nhiều điều chỉnh đối với tài nguyên này và bạn nên xem ghi chú phát hành của Accounts để biết thêm thông tin chi tiết.
  • Các trường taxes và tax_category trong API phụ Products không còn được dùng nữa, tương tự như việc ngừng sử dụng accounttax trong Content API.

Nội dung sắp ra mắt:

  • Chúng tôi đã xem xét ý kiến phản hồi của bạn và đang nỗ lực cải thiện tài liệu dành cho nhà phát triển API ở một số khía cạnh.
  • Hãy chú ý theo dõi và thường xuyên kiểm tra lại, đồng thời đừng ngại chia sẻ thêm ý kiến phản hồi với chúng tôi.
Trước
YouTube Shopping developer policies
Tiếp
Design