پرش به محتوای اصلی
پرش به محتوای مقاله

چرا تغییر ساختار API جمینای باعث شکست خاموش اپلیکیشن‌های شما می‌شود؟

·۲۸ اردیبهشت ۱۴۰۵۲ دقیقه مطالعه
چرا تغییر ساختار API جمینای باعث شکست خاموش اپلیکیشن‌های شما می‌شود؟
اشتراک‌گذاری

اگر از API تعاملات گوگل استفاده می‌کنید، باید بدانید که کدهای شما در ۲۶ مه ۲۰۲۶ به طور ناگهانی از کار می‌افتند. نکته ترسناک این است که هیچ خطای ۵۰۰ یا کرش شدیدی نخواهید دید؛ اپلیکیشن شما فقط ساکت می‌شود.

گوگل در حال تغییر ساختار پاسخ‌های API خود است. این تغییرات، طرح‌واره (Schema) — که شبیه به یک فرم استاندارد است و تعیین می‌کند هر داده در کدام خانه قرار بگیرد — را عوض می‌کند. همان‌طور که در تحلیل قبلی ما درباره‌ی هوش مصنوعی زاینده (Generative AI) و اتوماسیون اندروید اشاره کردیم، گوگل به دنبال رویکردی ساختاریافته‌تر است. طبق مستندات گوگل، این تغییرات مدل ساده‌ی «خروجی‌ها» را که یک سال است استفاده می‌شد، با مدل «گام‌ها» جایگزین می‌کند. این رویکرد جدید در واقع تکمیل‌کننده‌ی تغییرات زیرساختی گوگل است که پیش‌تر در معرفی وب‌هوک‌های جمینای برای بهینه‌سازی گردش‌کارهای عامل‌محور مشاهده کردیم.

به گزارش dev.to، این به‌روزرسانی شامل چندین تغییر حیاتی است که باعث شکست کدها می‌شود:

  • جایگزینی outputs[] با steps[] که باعث می‌شود فیلدهای متنی یک سطح عمیق‌تر شوند.
  • ادغام response_mime_type در یک شیء چندریختی به نام response_format.
  • انتقال image_config از بخش تنظیمات تولید به response_format.
  • تغییر نام رویدادهای SSE از content.delta به step.delta.
  • انتقال فراخوانی توابع و گام‌های «تفکر» منحصراً به بخش steps.

این وضعیت یک کابوس برای برنامه‌نویسان است چون «سیم‌ها ساکت‌اند». از آن‌جا که در جاوااسکریپت مقدار undefined یک مقدار معتبر است، رابط کاربری شما ممکن است تا ابد در حالت «در حال بارگذاری» بماند، در حالی که سرور داده‌هایی می‌فرستد که کد شما دیگر نمی‌شناسد. شما عملاً تا زمانی که کاربر گزارش خرابی دهد، در تاریکی هستید.

گام بعدی شما

  • همین امروز هدر Api-Revision: 2026-05-20 را به محیط استیجینگ (Staging) خود اضافه کنید.
  • حلقه‌های ارسال ابزار و شنودکننده‌های استریم را پیش از ضرب‌الاجل ۸ ژوئن ۲۰۲۶ تست کنید.
  • ساختار دریافت داده‌ها را از مدل خروجی به مدل گام‌محور تغییر دهید.

اما این تغییرات تنها بخشی از استراتژی گوگل برای رقابت با OpenAI است؛ بررسی دقیق‌تر مدل‌های استدلالی جدید را در گزارش بعدی بخوانید.

چرا این موضوع مهم است؟

این موضوع اعتبار پایداری سرویس‌های ابری گوگل را به چالش می‌کشد. توسعه‌دهندگان باید بین انعطاف‌پذیری API و ریسک شکست‌های خاموش تعادل برقرار کنند تا اعتماد کاربر نادیده گرفته نشود.

این گزارش با خط‌لولهٔ خودکار دات‌هوش از منابع معتبر جهانی تدوین و زیر نظر تحریریه منتشر شده است. روش کار ما

گفتگو

پنج‌شنبه‌های هوش‌محور

بسته‌ی هفتگی دات‌هوش

۵ خبر، ۲ ابزار، ۱ پرامپت در هر شماره. به‌زودی راه‌اندازی می‌شود — هر پنج‌شنبه صبح.

خبر کلیدی
ابزار کاربردی
پرامپت حرفه‌ای
تحلیل پژوهش
به‌زودی
زاویه‌ی ایرانی
به‌زودی
تمرین این هفته
به‌زودی

راهنماهای دات‌هوش

راهنماهای کاربردیِ دات‌هوش برای کار با هوش مصنوعی — از همین‌جا شروع کنید:

دات‌هوش

راهنمای فارسی هوش مصنوعی — با نگاه به ایران

اخبار روزانه، معرفی ابزارها و مدل‌ها، و آموزشِ کار با هوش مصنوعی؛ همیشه با این پرسش که از ایران چه چیزی کار می‌کند و چه چیزی نه.