API محتوای گوگل برای خرید رسماً در ۱۸ آگوست ۲۰۲۶ به پایان عمر خود رسید. همه توسعهدهندگان باید در اسرع وقت ادغامهای موجود را به API فروشگاه منتقل کنند.
برای تشویق مهاجرت قبل از حذف کامل و اطمینان از اینکه توسعهدهندگان اعلانهای منسوخ شدن را در گزارشهای برنامه خود مشاهده میکنند، گوگل از اول سپتامبر ۲۰۲۶ یک فرآیند تدریجی تخریب سرویس را معرفی میکند.
جدول زمانی غروب آفتاب
جدول زیر جدول زمانی تخریب سرویس و از رده خارج کردن نهایی Google Content API for Shopping (نسخه ۲.۱) را نشان میدهد:
| تاریخ | نقطه عطف | جزئیات |
|---|---|---|
| ۱ سپتامبر ۲۰۲۶ | معرفی درخواستهای ناموفق متناوب | درخواستهای بدون افزونهی فعال، بهطور متناوب با HTTP 410 Gone با شکست مواجه میشوند. |
| اوایل ۲۰۲۷ | از رده خارج کردن | خاموشی کامل. تمام نقاط پایانی رد میشوند و تمام درخواستها با شکست مواجه میشوند. |
تخریب سرویس و پاسخهای خطا
از اول سپتامبر ۲۰۲۶، درخواستهای ارسالی به Google Content API برای نقاط انتهایی خرید توسط کلاینتهایی که افزونه فعالی ندارند، به طور متناوب با کد وضعیت HTTP 410 Gone با شکست مواجه میشوند.
قالب پاسخ خطا
وقتی درخواستی به عنوان بخشی از تخریب سرویس برنامهریزیشده رد میشود، API یک بار داده خطای HTTP 410 Gone را برمیگرداند که حاوی پیام و ابرداده با جزئیات پروژه 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"
}
}
]
}
}
پاسخ خطا شامل فیلدهای فراداده زیر است:
-
GCP_ID: شناسه پروژه Google Cloud که درخواست را انجام میدهد. -
GCP_NUMBER: شناسه عددی منحصر به فرد پروژه Google Cloud. -
HELP_CENTER_LINK: لینک مستقیم به مستندات مهاجرت.
تأثیر سهمیه
پاسخهای خطای مصنوعی ایجاد شده در طول تخریب سرویس، جزو سهمیه API پروژه شما محسوب نمیشوند.
تلاش مجدد برای درخواستهای ناموفق
از آنجا که تخریب اولیه سرویس باعث میشود تنها بخشی از درخواستها با شکست مواجه شوند، تلاش مجدد برای یک درخواست ناموفق ممکن است موفقیتآمیز باشد. با این حال، تکیه بر تلاشهای مجدد یک راه حل بلندمدت و مناسب نیست زیرا درخواستهای ناموفق بیشتر میشوند تا زمانی که همه درخواستها در زمان از رده خارج شدن با شکست مواجه شوند.
توسعهدهندگان آسیبدیده
فرآیند غروب آفتاب و تنزل خدمات برای توسعهدهندگان و کسبوکارها به شرح زیر اعمال میشود:
- ادغام APIهای سفارشی: اگر سازمان شما از ابزارهای داخلی، اسکریپتها یا نرمافزارهای سفارشی که مستقیماً به API محتوای گوگل برای خرید متصل میشوند، پشتیبانی میکند، باید برنامههای خود را برای فراخوانی API فروشگاه بهروزرسانی کنید.
- پلتفرمهای شخص ثالث: اگر از طریق یک پلتفرم تجارت الکترونیک به مرکز بازرگانان دسترسی پیدا کنید، شریک پلتفرم شما از طرف شما مهاجرت را مدیریت میکند. هیچ اقدامی از جانب شما لازم نیست.
اقدام لازم
برای جلوگیری از اختلال در فهرست محصولات و مدیریت حساب کاربری خود:
- برای درک معماری، احراز هویت و ساختارهای زیر-API ، نمای کلی Merchant API را مرور کنید.
- برای شناسایی معادلهای مدرن برای سرویسهای فعلی API محتوای خود، راهنمای «انتقال از API محتوا برای خرید به API فروشگاه» را دنبال کنید.
- جدیدترین کتابخانههای کلاینت Merchant API را برای زبان برنامهنویسی خود نصب کنید.
- قبل از استقرار در محیط تولید، یکپارچهسازی خود را در یک محیط توسعه بهروزرسانی و آزمایش کنید.
درخواست تمدید
اگر سازمان شما برای تکمیل مهاجرت به زمان بیشتری نیاز دارد، میتوانید برای معافیت موقت پروژه Google Cloud خود از خطاهای تخریب سرویس، درخواست تمدید دهید. برای درخواست تمدید، فرم درخواست تمدید API محتوا را ارسال کنید.
افزونههای تأیید شده، پروژههای شما را از پاسخهای خطای زمانبندی شده از طریق پنجره افزونه تأیید شدهتان محافظت میکنند. افزونهها پس از پایان عملیات در اوایل سال ۲۰۲۷ تمدید نمیشوند.