Google Content API for Shopping chính thức 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 trong thời gian sớm nhất có thể.
Để 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 các nhà phát triển tuân thủ thông báo ngừng cung cấp trong nhật ký ứng dụng của họ, Google sẽ triển khai quy trình giảm cấp dịch vụ từng bước bắt đầu từ ngày 1 tháng 9 năm 2026.
Lịch ngừng cung cấp
Bảng sau đây trình bày tiến trình giảm cấp dịch vụ và ngừng hoạt động hoàn toàn của Google Content API for Shopping (phiên bản 2.1):
| Ngày | Milestone | Thông tin chi tiết |
|---|---|---|
| Ngày 1 tháng 9 năm 2026 | Giới thiệu về các yêu cầu không thành công không liên tục | Các yêu cầu không có tiện ích đang hoạt động sẽ bắt đầu thỉnh thoảng gặp lỗi HTTP 410 Gone. |
| Đầu năm 2027 | Ngừng hoạt động | Tắt hoàn toàn. Tất cả các điểm cuối đều bị tắt và mọi yêu cầu đều không thành công. |
Phản hồi về lỗi và tình trạng suy giảm dịch vụ
Kể từ ngày 1 tháng 9 năm 2026, các yêu cầu mà những ứng dụng không có tiện ích đang hoạt động gửi đến các điểm cuối Google Content API for Shopping sẽ thỉnh thoảng không thành công với mã trạng thái HTTP 410 Gone.
Định dạng phản hồi lỗi
Khi một yêu cầu bị từ chối trong quá trình giảm cấp dịch vụ theo lịch, API sẽ trả về một tải trọng lỗi HTTP 410 Gone chứa thông báo và siêu dữ liệu kèm theo thông tin chi tiết về dự án trên đám mây của bạn trên Google Cloud:
{
"error": {
"code": 410,
"message": "Content API for Shopping was sunset on August 18, 2026 for GCP project with id YOUR_PROJECT_ID and number 123456789012. Please migrate to the Merchant API v1 version. See https://developers.google.com/merchant/api/guides/compatibility for more details",
"status": "ABORTED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "content_api_sunset",
"domain": "shoppingcontent.googleapis.com",
"metadata": {
"GCP_ID": "YOUR_PROJECT_ID",
"GCP_NUMBER": "YOUR_PROJECT_NUMBER",
"HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/compatibility"
}
}
]
}
}
Phản hồi lỗi bao gồm các trường siêu dữ liệu sau:
GCP_ID: Mã nhận dạng của dự án trên Google Cloud đưa ra yêu cầu.GCP_NUMBER: Giá trị nhận dạng bằng số duy nhất của dự án trên Google Cloud.HELP_CENTER_LINK: Đường liên kết trực tiếp đến tài liệu di chuyển.
Ảnh hưởng đến hạn mức
Các phản hồi lỗi giả tạo được tạo trong quá trình giảm cấp dịch vụ sẽ không được tính vào hạn mức API của dự án.
Thử lại các yêu cầu không thành công
Vì tình trạng suy giảm dịch vụ ban đầu chỉ khiến một phần yêu cầu không thành công, nên việc thử lại yêu cầu không thành công có thể thành công. Tuy nhiên, việc dựa vào các lần thử lại không phải là một giải pháp lâu dài khả thi vì các yêu cầu không thành công sẽ xảy ra thường xuyên hơn cho đến khi tất cả các yêu cầu đều không thành công khi ngừng hoạt động.
Nhà phát triển bị ảnh hưởng
Quy trình ngừng cung cấp và giảm cấp dịch vụ áp dụng cho nhà phát triển và doanh nghiệp như sau:
- Chế độ tích hợp API tuỳ chỉnh: Nếu tổ chức của bạn duy trì các công cụ, tập lệnh hoặc phần mềm tuỳ chỉnh nội bộ thực hiện lệnh gọi trực tiếp đến Google Content API for Shopping, bạn phải cập nhật các ứng dụng của mình để gọi Merchant API.
- Nền tảng bên thứ ba: Nếu bạn truy cập vào Merchant Center thông qua một nền tảng thương mại điện tử, thì đối tác nền tảng của bạn sẽ quản lý quá trình di chuyển thay cho bạn. Bạn không cần làm gì cả.
Việc cần làm
Để tránh làm gián đoạn trang thông tin sản phẩm và việc quản lý tài khoản:
- Xem Tổng quan về Merchant API để hiểu rõ cấu trúc, quy trình xác thực và cấu trúc API phụ.
- Hãy làm theo hướng dẫn Di chuyển từ Content API for Shopping sang Merchant API để xác định các dịch vụ tương đương hiện đại cho Content API hiện tại của bạn.
- Cài đặt thư viện ứng dụng Merchant API mới nhất cho ngôn ngữ lập trình của bạn.
- Cập nhật và kiểm thử quá trình tích hợp trong môi trường phát triển trước khi triển khai cho môi trường sản xuất.
Yêu cầu gia hạn
Nếu tổ chức của bạn cần thêm thời gian để hoàn tất quá trình di chuyển, bạn có thể yêu cầu gia hạn để tạm thời miễn cho dự án trên đám mây của Google khỏi các lỗi giảm cấp dịch vụ. Để yêu cầu gia hạn, hãy gửi biểu mẫu yêu cầu gia hạn Content API.
Tiện ích được phê duyệt giúp bảo vệ các dự án của bạn khỏi các phản hồi lỗi theo lịch thông qua cửa sổ tiện ích được phê duyệt. Các tiện ích sẽ không hoạt động sau khi ngừng cung cấp hoàn toàn vào đầu năm 2027.