واجهة Gemini API تدعم Webhooks: تساعد Google في معالجة مشكلة الاستقصاء المتكرر للمهام الطويلة، ويمكن لـ Batch وVeo تقديم عمليات الدفع فوراً

أعلنت Google في 4 مايو عن إطلاق ميزة Webhooks على Gemini API، لمعالجة نقاط الألم لدى مطوري المهام طويلة الأمد (long-running jobs). أوضح مدونة Google الرسمية أن Webhooks هي آلية إشعارات دفع مدفوعة بالأحداث (event-driven)، ما يعني أن المطورين لم يعودوا بحاجة إلى استخدام أسلوب المراقبة المستمرة عبر الاستقصاء (polling) للاستعلام باستمرار عن حالة المهام داخل Gemini API. بعد اكتمال الـAPI، سيقوم بدفع النتائج تلقائيًا إلى نقطة النهاية (endpoint) التي يحددها المطور.

يصف مدير علاقات مطوري الذكاء الاصطناعي لدى Google Logan Kilpatrick (@OfficialLoganK) على منصة X ذلك بأنه «خطوة مهمة لخبرة مطوري (DevX) المهام طويلة الأمد».

ما المشكلة التي تُعالجها: تكلفة الاستقصاء لعمليات الدُفعات وتوليد الفيديو وعمليات التفكير الطويل (long reasoning)

في السابق، واجه مطورو Gemini API تحديات عند تنفيذ batch (المعالجة على دفعات) وتوليد الفيديو (Veo 2) ومهام long reasoning؛ إذ كانوا مضطرين إلى استدعاء endpoint الخاص بالحالة كل بضع ثوانٍ للتحقق من تقدم المهمة. هذه النمطية غير مثالية على مستويات ثلاث:

إهدار الموارد—عدد كبير من استدعاءات تحقق الحالة غير ذات معنى، واستهلاك API quota

تأخر غير قابل للتحكم—فواصل polling قصيرة تحرق quota، بينما يؤدي طولها إلى اكتشاف النتائج لاحقًا

تعقيد برمجي—الحاجة لكتابة منطق (state machine) لإدارة polling لمهام متوازية متعددة على جهة العميل

تقلب Webhooks هذا النمط: يقوم المطور بتسجيل عنوان URL لردّ الاستدعاء (callback URL)، ثم يرسل Gemini API النتيجة عبر POST إلى ذلك العنوان عند اكتمال المهمة، ليصبح دور العميل مقتصرًا على معالجة الإشعار الذي يصل.

حالات الاستخدام المناسبة: Batch API، وفيديو Veo 2، واستدلال (inference) بسياق طويل

تركز Webhooks التي تم طرحها هذه المرة على ثلاث فئات رئيسية من المهام غير المتزامنة:

Batch API—endpoint معالجة الدفعات في Gemini، المستخدم لعدد كبير من النصوص والمتجهات المضمنة (embeddings) ومهام التصنيف. توفر Google خصمًا رسميًا بنسبة 50%، وتهدف إلى تقديم رد خلال 24 ساعة، لكن غالبًا ما يتم الإنجاز خلال بضع ساعات

توليد الفيديو (Veo 2)—يتطلب توليد مقطع واحد وقتًا على مستوى الدقائق، وكان على المطورين في السابق إجراء polling باستمرار

استدلال السياق الطويل (long context reasoning)—تحليل مستندات طويلة تزيد عن 1M token، وقد تحتاج المعالجة الداخلية في Gemini إلى عشرات الثواني إلى عدة دقائق

من ناحية التنفيذ للمطورين، بعد تسجيل webhook، يمكن للعميل «إطلاق المهمة ونسيانها»، إذ يتم إخطار العميل تلقائيًا عند اكتمال النتيجة بواسطة Gemini. يناسب هذا النمط بشكل خاص بنى بلا خوادم (serverless)، حيث يتم تنبيه الخلفية فقط عند وصول الحدث، دون الحاجة إلى الحفاظ على عملية polling مستمرة.

مقارنة مع OpenAI وAnthropic: من يسبق ومن يتأخر

مستوى تقدم webhook للمهام طويلة الأمد عبر منصات AI الثلاث:

Google Gemini: أطلقت Webhooks في 4 مايو (هذا الطرح)، وتغطي بالكامل batch والفيديو وlong reasoning

OpenAI: تعتمد المهام طويلة الأمد مثل Codex وSora 2 حاليًا بشكل أساسي على SSE (Server-Sent Events) للبثّ المتدفق، بينما توجد endpoint مستقلة للمهام على دفعات لكنها تفتقر إلى webhook أصلي

Anthropic: لا يوجد webhook أصلي في Claude API حتى الآن، وتستخدم Claude Code آلية polling داخليًا للتعامل مع المهام طويلة الأمد

على خط DevX (developer experience)، يبدو أن Google عززت الاستثمار بشكل واضح خلال الـ12 شهرًا الماضية—من 1M context في Gemini 2.5 Pro، إلى التطوير البصري المُدمج في AI Studio، مرورًا بـAgent Designer وMemory Bank اللذين تم الإعلان عنهما ضمن Cloud Next 2026، وصولًا إلى Webhooks الحالية. وبالمقارنة مع أولوية Google تجاه «استهلاك المنتج على مستوى الطرف (client product)» مثل ChatGPT وOperator، تتجه Google إلى مسار «بنية تحتية للشركات/المطورين». وتُعد Webhooks جزءًا ملموسًا من هذا المسار.

المتابعة القادمة: آليات أمان webhook ونطاق النماذج المدعومة

تركز نقاط المراقبة للمرحلة التالية على:

آليات أمان Webhook—هل توفر Gemini تحققًا لتوقيعات HMAC لتجنب تعرض عنوان callback URL لطلبات مزيّفة على نحو قد يسبب هجمات أو «تجهيزا» (轟炸)

توسيع نطاق النماذج—حاليًا يغطي batch وVeo 2 وlong reasoning، فهل سيدعم ذلك أيضًا توليد الصور في Imagen مستقبلًا وSpeech-to-Speech وGemini Live

رد فعل OpenAI وAnthropic—عندما ترفع Google مستوى DevX إلى هذا الحد، هل سيتبع المنافسون خطوتها

بالنسبة لممارسات المطورين في تايوان، إذا كنت تستخدم Gemini API لإنجاز مهام batch (مثل تصنيف بيانات العملاء على دفعات أو تلخيص المستندات)، فإن Webhooks ميزة تستحق التكامل الفوري، إذ يمكن أن تخفض بشكل كبير استهلاك API quota وتعقيد النظام.

ظهرت هذه المقالة Gemini API تُطلق Webhooks: Google تعالج ألم polling للمهام طويلة، والـBatch/Veo مع الدفع الفوري، لأول مرة على موقع 鏈新聞 ABMedia.