Gemini API

‫Gemini Interactions API هي واجهة برمجة تطبيقات تجريبية تتيح للمطوّرين إنشاء تطبيقات تستخدم الذكاء الاصطناعي التوليدي من خلال نماذج Gemini. ‫Gemini هو نموذجنا الأكثر تطورًا، وقد تم تصميمه من البداية ليكون متعدّد الوسائط. يمكنه التعميم والفهم السلس لأنواع مختلفة من المعلومات والتعامل معها ودمجها، بما في ذلك اللغة والصور والمقاطع الصوتية والفيديوهات والرموز البرمجية. يمكنك استخدام Gemini API لحالات استخدام مثل الاستدلال على النصوص والصور، وإنشاء المحتوى، ووكلاء الحوار، وأنظمة التلخيص والتصنيف، وغير ذلك.

إنشاء تفاعل

post https://generativelanguage.googleapis.com/v1beta/interactions

تُنشئ هذه الطريقة تفاعلاً جديدًا.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

model ModelOption  (اختياري)

اسم `النموذج` المستخدَم لإنشاء التفاعل.
مطلوبة إذا لم يتم تقديم `agent`.

القيم المحتملة:

  • gemini-2.5-pro

    نموذجنا المتطوّر المتعدّد الأغراض، والذي يتفوّق في الترميز ومهام الاستدلال المعقّدة.

  • gemini-2.5-flash

    نموذجنا الأول للاستدلال المختلط الذي يتيح قدرة استيعاب مليون رمز مميّز ويتضمّن ميزانيات للتفكير.

  • gemini-2.5-flash-preview-09-2025

    أحدث نموذج يستند إلى نموذج 2.5 Flash. ‫2.5 Flash Preview هو الخيار الأفضل للمهام التي تتطلّب التفكير ومعالجة البيانات على نطاق واسع، والمهام التي تتطلّب وقت استجابة منخفضًا، والمهام التي تتطلّب معالجة كميات كبيرة من البيانات، وحالات الاستخدام التي تتطلّب وكيلًا.

  • gemini-2.5-flash-lite

    هذا النموذج هو الأصغر والأكثر فعالية من حيث التكلفة، وهو مصمّم للاستخدام على نطاق واسع.

  • gemini-2.5-flash-lite-preview-09-2025

    أحدث نموذج يستند إلى Gemini 2.5 Flash lite، وهو محسّن لتحقيق فعالية من حيث التكلفة وإنتاجية عالية وجودة عالية.

  • gemini-2.5-flash-preview-native-audio-dialog

    تم تحسين نماذج الصوت الأصلية لإنتاج نتائج صوتية بجودة أعلى مع تحسين السرعة والطبيعية والوضوح والمزاج.

  • gemini-2.5-flash-image-preview

    نموذجنا الأصلي لإنشاء الصور، وهو نموذج محسّن من حيث السرعة والمرونة والفهم السياقي. يتم تسعير إدخال النص وإخراجه بنفس سعر 2.5 Flash.

  • gemini-2.5-pro-preview-tts

    نموذجنا الصوتي 2.5‎ Pro لتحويل النص إلى كلام محسّن لإنشاء كلام قوي وبزمن استجابة منخفض، ما يتيح الحصول على نتائج أكثر طبيعية وتوجيه الطلبات بسهولة أكبر.

  • gemini-3-pro-preview

    نموذجنا الأكثر ذكاءً الذي يتميّز بقدرات استدلالية وفهم لمختلف الوسائط على أعلى مستوى، بالإضافة إلى إمكانات ترميز متطوّرة وميزات تستند إلى الذكاء الاصطناعي الوكيل.

النموذج الذي سيكمل طلبك.\n\nراجِع [النماذج](https://ai.google.dev/gemini-api/docs/models) للحصول على تفاصيل إضافية.

agent AgentOption  (اختياري)

اسم "الموظف" المستخدَم لإنشاء التفاعل.
مطلوبة إذا لم يتم تقديم `model`.

القيم المحتملة:

  • deep-research-pro-preview-12-2025

    وكيل Deep Research في Gemini

الوكيل الذي سيتم التفاعل معه

input المحتوى أو الصفيف (المحتوى) أو الصفيف (الرد) أو السلسلة  (مطلوب)

تمثّل هذه السمة المعلومات التي يتم إدخالها للتفاعل (وهي مشتركة بين النموذج والوكيل).

system_instruction string  (اختيارية)

تعليمات النظام للتفاعل

tools array (Tool)  (اختياري)

قائمة بتعريفات الأدوات التي قد يستدعيها النموذج أثناء التفاعل

response_format object  (اختيارية)

يفرض أن تكون الاستجابة التي تم إنشاؤها عبارة عن عنصر JSON يتوافق مع مخطط JSON المحدّد في هذا الحقل.

response_mime_type string  (اختيارية)

نوع MIME الخاص بالردّ. هذا الإجراء مطلوب إذا تم ضبط response_format.

stream boolean  (اختياري)

الإدخال فقط تُستخدَم لتحديد ما إذا كان سيتم بث التفاعل.

store boolean  (اختياري)

الإدخال فقط تحديد ما إذا كان سيتم تخزين الرد والطلب لاستردادهما لاحقًا

الخلفية منطقي  (اختياري)

تحديد ما إذا كان سيتم تشغيل التفاعل مع النموذج في الخلفية

generation_config GenerationConfig  (optional)

إعدادات النموذج
مَعلمات الإعدادات للتفاعل مع النموذج
بديل عن `agent_config`. لا ينطبق إلا عند ضبط `model`.

مَعلمات الإعداد لتفاعلات النموذج

الحقول

temperature number  (اختياري)

تتحكّم هذه السمة في عشوائية الناتج.

top_p number  (اختياري)

الحدّ الأقصى للاحتمال التراكمي للرموز المميّزة التي يجب أخذها في الاعتبار عند أخذ العيّنات.

seed عدد صحيح  (اختياري)

القيمة الأولية المستخدَمة في فك الترميز لضمان إمكانية إعادة الإنتاج

stop_sequences array (string)  (اختيارية)

قائمة بتسلسلات الأحرف التي ستوقف التفاعل مع الإخراج.

tool_choice ToolChoice  (اختيارية)

أداة اختيار التفاعل

إعدادات اختيار الأدوات

الأنواع المحتمَلة

ToolChoiceType

لا يتضمّن هذا النوع أي حقول محدّدة.

ToolChoiceConfig

allowed_tools AllowedTools  (اختياري)

لم يتم تقديم أي وصف.

إعدادات الأدوات المسموح بها

الحقول

mode ToolChoiceType  (اختياري)

وضع اختيار الأداة

القيم المحتملة:

  • auto
  • any
  • none
  • validated

tools array (string)  (اختياري)

أسماء الأدوات المسموح بها

thinking_level ThinkingLevel  (اختيارية)

مستوى الرموز المميزة للأفكار التي يجب أن ينشئها النموذج

القيم المحتملة:

  • low
  • high

thinking_summaries ThinkingSummaries  (اختيارية)

تحديد ما إذا كان سيتم تضمين ملخّصات الأفكار في الردّ.

القيم المحتملة:

  • auto
  • none

max_output_tokens integer  (اختياري)

الحدّ الأقصى لعدد الرموز المميّزة التي يمكن تضمينها في الردّ

speech_config SpeechConfig  (اختياري)

إعدادات التفاعل الصوتي

إعدادات التفاعل الصوتي

الحقول

voice string  (اختياري)

صوت المتحدث

language string  (اختياري)

لغة الكلام

speaker string  (اختياري)

اسم المتحدث، ويجب أن يتطابق مع اسم المتحدث الوارد في الطلب

agent_config object  (اختياري)

إعدادات "الوكيل"
إعدادات "الوكيل".
بديل عن `generation_config`. لا ينطبق إلا عند ضبط `agent`.

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

DynamicAgentConfig

إعدادات الوكلاء الديناميكيين

type string  (اختياري)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "dynamic".

DeepResearchAgentConfig

إعدادات وكيل Deep Research

type string  (اختياري)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "deep-research".

thinking_summaries ThinkingSummaries  (اختيارية)

تحديد ما إذا كان سيتم تضمين ملخّصات الأفكار في الردّ.

القيم المحتملة:

  • auto
  • none

previous_interaction_id string  (اختياري)

رقم تعريف التفاعل السابق، إن وُجد.

response_modalities ResponseModality  (اختيارية)

طُرق عرض الرد المطلوبة (TEXT أو IMAGE أو AUDIO).

القيم المحتملة:

  • text
  • image
  • audio

الردّ

تعرض هذه الطريقة مورد Interaction.

طلب بسيط

مثال على الرد

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-11-26T12:25:15Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 20,
    "total_reasoning_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

محادثة متعدّدة الجولات

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "The capital of France is Paris."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 50
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 50,
    "total_output_tokens": 10,
    "total_reasoning_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

إدخال الصور

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 10
      },
      {
        "modality": "image",
        "tokens": 258
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 268,
    "total_output_tokens": 20,
    "total_reasoning_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

استدعاء الدوال

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "function_call": {
        "name": "get_weather",
        "arguments": {
          "location": "Boston, MA"
        }
      }
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 100
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 100,
    "total_output_tokens": 25,
    "total_reasoning_tokens": 0,
    "total_tokens": 125,
    "total_tool_use_tokens": 50
  }
}

Deep Research

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "Here is a comprehensive research report on the current state of cancer research..."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 20
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 20,
    "total_output_tokens": 1000,
    "total_reasoning_tokens": 500,
    "total_tokens": 1520,
    "total_tool_use_tokens": 0
  }
}

استرداد تفاعل

get https://generativelanguage.googleapis.com/v1beta/interactions/{id}

تسترد هذه الطريقة التفاصيل الكاملة لتفاعل واحد استنادًا إلى `Interaction.id`.

مَعلمات المسار / طلب البحث

id string  (مطلوبة)

المعرّف الفريد للتفاعل المطلوب استرجاعه.

stream boolean  (اختياري)

في حال ضبطها على "صحيح"، سيتم بث المحتوى الذي تم إنشاؤه بشكل تدريجي.

الإعداد التلقائي هو: False

last_event_id string  (اختياري)

اختيارية: في حال ضبط هذا الحقل، يتم استئناف بث التفاعل من الجزء التالي بعد الحدث الذي تم وضع علامة عليه برقم تعريف الحدث. لا يمكن استخدامها إلا إذا كانت قيمة `stream` هي "صحيح".

api_version string  (اختيارية)

إصدار واجهة برمجة التطبيقات الذي سيتم استخدامه

الردّ

تعرض هذه الطريقة مورد Interaction.

Get Interaction

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "I'm doing great, thank you for asking! How can I help you today?"
    }
  ]
}

حذف تفاعل

delete https://generativelanguage.googleapis.com/v1beta/interactions/{id}

يحذف هذا الإجراء التفاعل حسب رقم التعريف.

مَعلمات المسار / طلب البحث

id string  (مطلوبة)

المعرّف الفريد للتفاعل المطلوب حذفه.

api_version string  (اختيارية)

إصدار واجهة برمجة التطبيقات الذي سيتم استخدامه

الردّ

إذا نجح الطلب، ستكون الاستجابة فارغة.

حذف التفاعل

إلغاء تفاعل

post https://generativelanguage.googleapis.com/v1beta/interactions/{id}/cancel

تلغي هذه الطريقة تفاعلاً حسب رقم التعريف. ينطبق ذلك فقط على التفاعلات التي لا تزال قيد التشغيل في الخلفية.

مَعلمات المسار / طلب البحث

id string  (مطلوبة)

المعرّف الفريد للتفاعل المطلوب استرجاعه.

api_version string  (اختيارية)

إصدار واجهة برمجة التطبيقات الذي سيتم استخدامه

الردّ

تعرض هذه الطريقة مورد Interaction.

إلغاء التفاعل

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "cancelled",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "model"
}

الموارد

التفاعل

مورد Interaction

الحقول

model ModelOption  (اختياري)

اسم `النموذج` المستخدَم لإنشاء التفاعل.

القيم المحتملة:

  • gemini-2.5-pro

    نموذجنا المتطوّر المتعدّد الأغراض، والذي يتفوّق في الترميز ومهام الاستدلال المعقّدة.

  • gemini-2.5-flash

    نموذجنا الأول للاستدلال المختلط الذي يتيح قدرة استيعاب مليون رمز مميّز ويتضمّن ميزانيات للتفكير.

  • gemini-2.5-flash-preview-09-2025

    أحدث نموذج يستند إلى نموذج 2.5 Flash. ‫2.5 Flash Preview هو الخيار الأفضل للمهام التي تتطلّب التفكير ومعالجة البيانات على نطاق واسع، والمهام التي تتطلّب وقت استجابة منخفضًا، والمهام التي تتطلّب معالجة كميات كبيرة من البيانات، وحالات الاستخدام التي تتطلّب وكيلًا.

  • gemini-2.5-flash-lite

    هذا النموذج هو الأصغر والأكثر فعالية من حيث التكلفة، وهو مصمّم للاستخدام على نطاق واسع.

  • gemini-2.5-flash-lite-preview-09-2025

    أحدث نموذج يستند إلى Gemini 2.5 Flash lite، وهو محسّن لتحقيق فعالية من حيث التكلفة وإنتاجية عالية وجودة عالية.

  • gemini-2.5-flash-preview-native-audio-dialog

    تم تحسين نماذج الصوت الأصلية لإنتاج نتائج صوتية بجودة أعلى مع تحسين السرعة والطبيعية والوضوح والمزاج.

  • gemini-2.5-flash-image-preview

    نموذجنا الأصلي لإنشاء الصور، وهو نموذج محسّن من حيث السرعة والمرونة والفهم السياقي. يتم تسعير إدخال النص وإخراجه بنفس سعر 2.5 Flash.

  • gemini-2.5-pro-preview-tts

    نموذجنا الصوتي 2.5‎ Pro لتحويل النص إلى كلام محسّن لإنشاء كلام قوي وبزمن استجابة منخفض، ما يتيح الحصول على نتائج أكثر طبيعية وتوجيه الطلبات بسهولة أكبر.

  • gemini-3-pro-preview

    نموذجنا الأكثر ذكاءً الذي يتميّز بقدرات استدلالية وفهم لمختلف الوسائط على أعلى مستوى، بالإضافة إلى إمكانات ترميز متطوّرة وميزات تستند إلى الذكاء الاصطناعي الوكيل.

النموذج الذي سيكمل طلبك.\n\nراجِع [النماذج](https://ai.google.dev/gemini-api/docs/models) للحصول على تفاصيل إضافية.

agent AgentOption  (اختياري)

اسم "الموظف" المستخدَم لإنشاء التفاعل.

القيم المحتملة:

  • deep-research-pro-preview-12-2025

    وكيل Deep Research في Gemini

الوكيل الذي سيتم التفاعل معه

id string  (اختياري)

النتائج فقط. معرّف فريد لإكمال التفاعل.

الحالة تعداد (سلسلة)  (اختياري)

النتائج فقط. تمثّل هذه السمة حالة التفاعل.

القيم المحتملة:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
created string  (اختياري)

النتائج فقط. تمثّل هذه السمة وقت إنشاء الردّ بتنسيق ISO 8601 ‏(YYYY-MM-DDThh:mm:ssZ).

updated string  (اختياري)

النتائج فقط. تمثّل هذه السمة الوقت الذي تم فيه آخر تعديل على الرد بالتنسيق ISO 8601 ‏(YYYY-MM-DDThh:mm:ssZ).

role string  (اختياري)

النتائج فقط. دور التفاعل

outputs array (Content)  (اختياري)

النتائج فقط. الردود من النموذج

object string  (اختياري)

النتائج فقط. نوع العنصر الذي تم التفاعل معه. يتم ضبط القيمة دائمًا على `interaction`.

يجب ضبطها دائمًا على "interaction".

usage Usage  (اختياري)

النتائج فقط. إحصاءات حول استخدام الرمز المميّز لطلب التفاعل

إحصاءات حول استخدام الرمز المميّز لطلب التفاعل

الحقول

total_input_tokens integer  (اختياري)

عدد الرموز المميزة في الطلب (السياق).

input_tokens_by_modality ModalityTokens  (اختياري)

تفصيل لاستخدام الرموز المميزة للإدخال حسب نوع البيانات

عدد الرموز المميزة لنمط استجابة واحد

الحقول

modality ResponseModality  (اختيارية)

الوسيط المرتبط بعدد الرموز المميزة.

القيم المحتملة:

  • text
  • image
  • audio

tokens عدد صحيح  (اختياري)

عدد الرموز المميّزة للوسائط

total_cached_tokens integer  (optional)

عدد الرموز المميزة في الجزء المخزّن مؤقتًا من الطلب (المحتوى المخزّن مؤقتًا)

cached_tokens_by_modality ModalityTokens  (اختياري)

تفصيل لاستخدام الرمز المميز المخزّن مؤقتًا حسب طريقة الدفع

عدد الرموز المميزة لنمط استجابة واحد

الحقول

modality ResponseModality  (اختيارية)

الوسيط المرتبط بعدد الرموز المميزة.

القيم المحتملة:

  • text
  • image
  • audio

tokens عدد صحيح  (اختياري)

عدد الرموز المميّزة للوسائط

total_output_tokens عدد صحيح  (اختياري)

إجمالي عدد الرموز المميزة في جميع الردود التي تم إنشاؤها

output_tokens_by_modality ModalityTokens  (اختياري)

تفاصيل استخدام الرموز المميزة للناتج حسب طريقة العرض

عدد الرموز المميزة لنمط استجابة واحد

الحقول

modality ResponseModality  (اختيارية)

الوسيط المرتبط بعدد الرموز المميزة.

القيم المحتملة:

  • text
  • image
  • audio

tokens عدد صحيح  (اختياري)

عدد الرموز المميّزة للوسائط

total_tool_use_tokens integer  (اختيارية)

عدد الرموز المميزة المتوفّرة في طلبات استخدام الأدوات

tool_use_tokens_by_modality ModalityTokens  (اختياري)

تفصيل لاستخدام الرموز المميزة الخاصة باستخدام الأدوات حسب نوع البيانات

عدد الرموز المميزة لنمط استجابة واحد

الحقول

modality ResponseModality  (اختيارية)

الوسيط المرتبط بعدد الرموز المميزة.

القيم المحتملة:

  • text
  • image
  • audio

tokens عدد صحيح  (اختياري)

عدد الرموز المميّزة للوسائط

total_reasoning_tokens integer  (اختياري)

عدد الرموز المميّزة للأفكار في نماذج التفكير

total_tokens integer  (optional)

إجمالي عدد الرموز المميزة لطلب التفاعل (الطلب + الردود + الرموز المميزة الداخلية الأخرى).

previous_interaction_id string  (اختياري)

رقم تعريف التفاعل السابق، إن وُجد

أمثلة

مثال

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-2.5-flash",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-12-04T15:01:45Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 23,
    "total_reasoning_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

نماذج البيانات

المحتوى

محتوى الردّ.

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

TextContent

مقطع نصي

text string  (اختياري)

محتوى النص

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "text".

annotations Annotation  (اختياري)

تمثّل هذه السمة معلومات الاقتباس للمحتوى من إنشاء النموذج.

تمثّل هذه السمة معلومات الاقتباس للمحتوى من إنشاء النموذج.

الحقول

start_index integer  (اختياري)

بداية جزء الردّ الذي يتمّ نسبه إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

source string  (اختياري)

المصدر المنسوب إليه جزء من النص يمكن أن يكون عنوان URL أو عنوانًا أو معرّفًا آخر.

ImageContent

كتلة محتوى صورة

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type ImageMimeTypeOption  (اختيارية)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif

نوع MIME الخاص بالصورة.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "image".

resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high

AudioContent

كتلة محتوى صوتي

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type AudioMimeTypeOption  (اختيارية)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac

نوع MIME الخاص بالمقطع الصوتي.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "audio".

DocumentContent

وحدة محتوى مستند

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type string  (اختيارية)

لم يتم تقديم أي وصف.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "document".

VideoContent

كتلة محتوى فيديو

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type VideoMimeTypeOption  (اختيارية)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • video/mp4
  • video/mpeg
  • video/mov
  • video/avi
  • video/x-flv
  • video/mpg
  • video/webm
  • video/wmv
  • video/3gpp

نوع MIME الخاص بالفيديو.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "video".

resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high

ThoughtContent

وحدة محتوى فكرية

signature string  (اختياري)

توقيع لمطابقة المصدر الخلفي الذي سيتم تضمينه في عملية الإنشاء

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "thought".

summary ThoughtSummary  (اختياري)

ملخّص الفكرة

ملخّص الفكرة

FunctionCallContent

كتلة محتوى لاستدعاء أداة وظيفة

name string  (مطلوب)

تمثّل هذه السمة اسم الأداة المطلوب استدعاؤها.

arguments object  (مطلوب)

الوسيطات التي سيتم تمريرها إلى الدالة

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "function_call".

id string  (مطلوبة)

معرّف فريد لاستدعاء الأداة المحدّد هذا.

FunctionResultContent

كتلة محتوى لنتيجة أداة دالة

name string  (اختياري)

تمثّل هذه السمة اسم الأداة التي تم استدعاؤها.

is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان استدعاء الأداة قد نتج عنه خطأ.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "function_result".

result object or string  (مطلوبة)

نتيجة استدعاء الأداة

call_id string  (مطلوبة)

معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.

CodeExecutionCallContent

محتوى تنفيذ الرموز البرمجية

arguments CodeExecutionCallArguments  (اختياري)

الوسيطات التي سيتم تمريرها إلى تنفيذ الرمز البرمجي

الوسيطات التي سيتم تمريرها إلى تنفيذ الرمز البرمجي

الحقول

language enum (string)  (اختياري)

لغة البرمجة الخاصة بالرمز البرمجي.

القيم المحتملة:

  • python
code string  (اختياري)

الرمز المطلوب تنفيذه

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "code_execution_call".

id string  (اختياري)

معرّف فريد لاستدعاء الأداة المحدّد هذا.

CodeExecutionResultContent

محتوى نتيجة تنفيذ الرمز البرمجي

result string  (اختياري)

ناتج تنفيذ الرمز البرمجي

is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان تنفيذ الرمز البرمجي قد أدّى إلى حدوث خطأ.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "code_execution_result".

call_id string  (اختياري)

معرّف يجب أن يتطابق مع المعرّف من حزمة طلب تنفيذ الرمز البرمجي

UrlContextCallContent

محتوى سياق عنوان URL

arguments UrlContextCallArguments  (اختياري)

الوسيطات التي سيتم تمريرها إلى سياق عنوان URL

الوسيطات التي سيتم تمريرها إلى سياق عنوان URL

الحقول

urls مصفوفة (سلسلة)  (اختيارية)

عناوين URL المطلوب جلبها

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "url_context_call".

id string  (اختياري)

معرّف فريد لاستدعاء الأداة المحدّد هذا.

UrlContextResultContent

محتوى نتيجة البحث السياقي في عنوان URL

signature string  (اختياري)

توقيع نتيجة سياق عنوان URL

result UrlContextResult  (اختياري)

نتائج سياق عنوان URL

نتيجة سياق عنوان URL

الحقول

url string  (اختياري)

عنوان URL الذي تم استرجاعه.

الحالة تعداد (سلسلة)  (اختياري)

حالة استرداد عنوان URL

القيم المحتملة:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان سياق عنوان URL قد أدّى إلى حدوث خطأ.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "url_context_result".

call_id string  (اختياري)

معرّف يجب أن يتطابق مع المعرّف من وحدة طلب سياق عنوان URL.

GoogleSearchCallContent

محتوى "بحث Google"

arguments GoogleSearchCallArguments  (اختياري)

الوسيطات التي يجب تمريرها إلى "بحث Google"

الوسيطات التي يجب تمريرها إلى "بحث Google"

الحقول

queries array (string)  (اختياري)

طلبات البحث على الويب التي يتم إجراؤها بعد البحث الأولي على الويب

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "google_search_call".

id string  (اختياري)

معرّف فريد لاستدعاء الأداة المحدّد هذا.

GoogleSearchResultContent

محتوى نتيجة البحث على Google

signature string  (اختياري)

توقيع نتيجة البحث على Google

result GoogleSearchResult  (اختياري)

نتائج البحث من Google

نتيجة البحث على Google

الحقول

url string  (اختياري)

مرجع URI لنتيجة البحث

title string  (اختياري)

تمثّل هذه السمة عنوان نتيجة البحث.

rendered_content string  (اختياري)

مقتطف من محتوى الويب يمكن تضمينه في صفحة ويب أو عرض ويب داخل تطبيق

is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان البحث على Google قد أدّى إلى حدوث خطأ.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "google_search_result".

call_id string  (اختياري)

المعرّف الذي يجب أن يتطابق مع المعرّف من حظر المكالمات في "بحث Google"

McpServerToolCallContent

محتوى استدعاء أداة MCPServer

name string  (مطلوب)

اسم الأداة التي تم استدعاؤها.

server_name string  (مطلوبة)

اسم خادم MCP المستخدَم

arguments object  (مطلوب)

عنصر JSON الخاص بوسيطات الدالة

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "mcp_server_tool_call".

id string  (مطلوبة)

معرّف فريد لاستدعاء الأداة المحدّد هذا.

McpServerToolResultContent

محتوى نتيجة أداة MCPServer

name string  (اختياري)

اسم الأداة التي يتم استدعاؤها لتنفيذ استدعاء الأداة المحدّد هذا.

server_name string  (اختياري)

اسم خادم MCP المستخدَم

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "mcp_server_tool_result".

result object or string  (مطلوبة)

نتيجة استدعاء الأداة

call_id string  (مطلوبة)

المعرّف الذي يجب أن يتطابق مع المعرّف من أداة خادم MCP لكتلة طلبات البيانات.

FileSearchResultContent

محتوى نتيجة البحث في الملفات

result FileSearchResult  (اختياري)

نتائج البحث عن الملفات

نتيجة البحث عن الملفات

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان نتيجة البحث.

text string  (اختياري)

نص نتيجة البحث

file_search_store string  (اختياري)

تمثّل هذه السمة اسم متجر البحث عن الملفات.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "file_search_result".

أمثلة

نص

{
  "type": "text",
  "text": "Hello, how are you?"
}

صورة

{
  "type": "image",
  "data": "BASE64_ENCODED_IMAGE",
  "mime_type": "image/png"
}

الصوت

{
  "type": "audio",
  "data": "BASE64_ENCODED_AUDIO",
  "mime_type": "audio/wav"
}

مستند

{
  "type": "document",
  "data": "BASE64_ENCODED_DOCUMENT",
  "mime_type": "application/pdf"
}

فيديو

{
  "type": "video",
  "uri": "https://www.youtube.com/watch?v=9hE5-98ZeCg"
}

فكرة

{
  "type": "thought",
  "summary": [
    {
      "type": "text",
      "text": "The user is asking about the weather. I should use the get_weather tool."
    }
  ],
  "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh"
}

استدعاء الدالة

{
  "type": "function_call",
  "name": "get_weather",
  "id": "gth23981",
  "arguments": {
    "location": "Boston, MA"
  }
}

نتيجة الدالة

{
  "type": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": {
    "weather": "sunny"
  }
}

طلب تنفيذ الرمز البرمجي

{
  "type": "code_execution_call",
  "id": "call_123456",
  "arguments": {
    "language": "python",
    "code": "print('hello world')"
  }
}

نتيجة تنفيذ الرمز البرمجي

{
  "type": "code_execution_result",
  "call_id": "call_123456",
  "result": "hello world\n"
}

طلب سياق عنوان URL

{
  "type": "url_context_call",
  "id": "call_123456",
  "arguments": {
    "urls": [
      "https://www.example.com"
    ]
  }
}

نتيجة سياق عنوان URL

{
  "type": "url_context_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.example.com",
      "status": "SUCCESS"
    }
  ]
}

ميزة "اتصال من Google"

{
  "type": "google_search_call",
  "id": "call_123456",
  "arguments": {
    "queries": [
      "weather in Boston"
    ]
  }
}

نتيجة بحث من Google

{
  "type": "google_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.google.com/search?q=weather+in+Boston",
      "title": "Weather in Boston"
    }
  ]
}

Mcp Server Tool Call

{
  "type": "mcp_server_tool_call",
  "id": "call_123456",
  "name": "get_forecast",
  "server_name": "weather_server",
  "arguments": {
    "city": "London"
  }
}

نتيجة أداة خادم MCP

{
  "type": "mcp_server_tool_result",
  "name": "get_forecast",
  "server_name": "weather_server",
  "call_id": "call_123456",
  "result": "sunny"
}

نتيجة البحث في الملف

{
  "type": "file_search_result",
  "result": [
    {
      "text": "search result chunk",
      "file_search_store": "file_search_store"
    }
  ]
}

الأداة

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

الوظيفة

أداة يمكن أن يستخدمها النموذج

name string  (اختياري)

اسم الدالة

description string  (اختياري)

تمثّل هذه السمة وصفًا للدالة.

parameters object  (اختيارية)

مخطط JSON الخاص بمعلمات الدالة.

type string  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "function".

GoogleSearch

أداة يمكن أن يستخدمها النموذج للبحث على Google

type string  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_search".

CodeExecution

أداة يمكن أن يستخدمها النموذج لتنفيذ الرمز البرمجي

type string  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "code_execution".

UrlContext

أداة يمكن أن يستخدمها النموذج لجلب سياق عنوان URL.

type string  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_context".

ComputerUse

أداة يمكن أن يستخدمها النموذج للتفاعل مع الكمبيوتر

type string  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "computer_use".

environment enum (string)  (اختياري)

البيئة التي يتم تشغيلها

القيم المحتملة:

  • browser
excludedPredefinedFunctions array (string)  (اختياري)

قائمة الدوال المحدّدة مسبقًا والتي تم استبعادها من طلب النموذج

McpServer

خادم MCPServer هو خادم يمكن للنموذج استدعاؤه لتنفيذ إجراءات.

type string  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "mcp_server".

name string  (اختياري)

تمثّل هذه السمة اسم MCPServer.

url string  (اختياري)

عنوان URL الكامل لنقطة نهاية MCPServer مثال: "https://api.example.com/mcp"

العناوين كائن  (اختياري)

اختياري: حقول لعناوين المصادقة ومهلات الانتظار وما إلى ذلك، إذا لزم الأمر

allowed_tools AllowedTools  (اختياري)

الأدوات المسموح بها

إعدادات الأدوات المسموح بها

الحقول

mode ToolChoiceType  (اختياري)

وضع اختيار الأداة

القيم المحتملة:

  • auto
  • any
  • none
  • validated

tools array (string)  (اختياري)

أسماء الأدوات المسموح بها

FileSearch

أداة يمكن للنموذج استخدامها للبحث في الملفات

file_search_store_names array (string)  (اختياري)

أسماء متاجر البحث عن الملفات

top_k integer  (optional)

عدد أجزاء الاسترجاع الدلالي المطلوب استرجاعها.

metadata_filter string  (اختياري)

فلتر البيانات الوصفية الذي سيتم تطبيقه على المستندات والأجزاء التي يتم استرجاعها دلاليًا.

type string  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_search".

أمثلة

الوظيفة

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

Turn

الحقول

role string  (اختياري)

تمثّل هذه السمة الجهة التي بدأت هذا الدور. يجب أن يكون المستخدم هو مصدر الإدخال أو النموذج هو مصدر الإخراج.

content array (Content) or string  (اختياري)

محتوى الدور

أمثلة

دور المستخدم

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "user turn"
    }
  ]
}

Model Turn

{
  "role": "model",
  "content": [
    {
      "type": "text",
      "text": "model turn"
    }
  ]
}

InteractionSseEvent

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: event_type

InteractionEvent

event_type enum (string)  (اختياري)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • interaction.start
  • interaction.complete
interaction التفاعل  (اختياري)

لم يتم تقديم أي وصف.

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

InteractionStatusUpdate

interaction_id string  (اختياري)

لم يتم تقديم أي وصف.

الحالة تعداد (سلسلة)  (اختياري)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
event_type string  (اختياري)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "interaction.status_update".

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

ContentStart

الفهرس عدد صحيح  (اختياري)

لم يتم تقديم أي وصف.

content المحتوى  (اختياري)

لم يتم تقديم أي وصف.

event_type string  (اختياري)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "content.start".

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

ContentDelta

الفهرس عدد صحيح  (اختياري)

لم يتم تقديم أي وصف.

event_type string  (اختياري)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "content.delta".

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

delta object  (اختياري)

لم يتم تقديم أي وصف.

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

TextDelta

text string  (اختياري)

لم يتم تقديم أي وصف.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "text".

annotations Annotation  (اختياري)

تمثّل هذه السمة معلومات الاقتباس للمحتوى من إنشاء النموذج.

تمثّل هذه السمة معلومات الاقتباس للمحتوى من إنشاء النموذج.

الحقول

start_index integer  (اختياري)

بداية جزء الردّ الذي يتمّ نسبه إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

source string  (اختياري)

المصدر المنسوب إليه جزء من النص يمكن أن يكون عنوان URL أو عنوانًا أو معرّفًا آخر.

ImageDelta

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type ImageMimeTypeOption  (اختيارية)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif

نوع MIME الخاص بالصورة.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "image".

resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high

AudioDelta

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type AudioMimeTypeOption  (اختيارية)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac

نوع MIME الخاص بالمقطع الصوتي.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "audio".

DocumentDelta

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type string  (اختيارية)

لم يتم تقديم أي وصف.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "document".

VideoDelta

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type VideoMimeTypeOption  (اختيارية)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • video/mp4
  • video/mpeg
  • video/mov
  • video/avi
  • video/x-flv
  • video/mpg
  • video/webm
  • video/wmv
  • video/3gpp

نوع MIME الخاص بالفيديو.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "video".

resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high

ThoughtSummaryDelta

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "thought_summary".

content ImageContent أو TextContent  (اختياري)

لم يتم تقديم أي وصف.

ThoughtSignatureDelta

signature string  (اختياري)

توقيع لمطابقة المصدر الخلفي الذي سيتم تضمينه في عملية الإنشاء

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "thought_signature".

FunctionCallDelta

name string  (اختياري)

لم يتم تقديم أي وصف.

arguments object  (اختياري)

لم يتم تقديم أي وصف.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "function_call".

id string  (اختياري)

معرّف فريد لاستدعاء الأداة المحدّد هذا.

FunctionResultDelta

name string  (اختياري)

لم يتم تقديم أي وصف.

is_error boolean  (اختياري)

لم يتم تقديم أي وصف.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "function_result".

result كائن أو سلسلة  (اختياري)

دلتا نتيجة استدعاء الأداة

call_id string  (اختياري)

معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.

CodeExecutionCallDelta

arguments CodeExecutionCallArguments  (اختياري)

لم يتم تقديم أي وصف.

الوسيطات التي سيتم تمريرها إلى تنفيذ الرمز البرمجي

الحقول

language enum (string)  (اختياري)

لغة البرمجة الخاصة بالرمز البرمجي.

القيم المحتملة:

  • python
code string  (اختياري)

الرمز المطلوب تنفيذه

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "code_execution_call".

id string  (اختياري)

معرّف فريد لاستدعاء الأداة المحدّد هذا.

CodeExecutionResultDelta

result string  (اختياري)

لم يتم تقديم أي وصف.

is_error boolean  (اختياري)

لم يتم تقديم أي وصف.

signature string  (اختياري)

لم يتم تقديم أي وصف.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "code_execution_result".

call_id string  (اختياري)

معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.

UrlContextCallDelta

arguments UrlContextCallArguments  (اختياري)

لم يتم تقديم أي وصف.

الوسيطات التي سيتم تمريرها إلى سياق عنوان URL

الحقول

urls مصفوفة (سلسلة)  (اختيارية)

عناوين URL المطلوب جلبها

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "url_context_call".

id string  (اختياري)

معرّف فريد لاستدعاء الأداة المحدّد هذا.

UrlContextResultDelta

signature string  (اختياري)

لم يتم تقديم أي وصف.

result UrlContextResult  (اختياري)

لم يتم تقديم أي وصف.

نتيجة سياق عنوان URL

الحقول

url string  (اختياري)

عنوان URL الذي تم استرجاعه.

الحالة تعداد (سلسلة)  (اختياري)

حالة استرداد عنوان URL

القيم المحتملة:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (اختياري)

لم يتم تقديم أي وصف.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "url_context_result".

call_id string  (اختياري)

معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.

GoogleSearchCallDelta

arguments GoogleSearchCallArguments  (اختياري)

لم يتم تقديم أي وصف.

الوسيطات التي يجب تمريرها إلى "بحث Google"

الحقول

queries array (string)  (اختياري)

طلبات البحث على الويب التي يتم إجراؤها بعد البحث الأولي على الويب

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "google_search_call".

id string  (اختياري)

معرّف فريد لاستدعاء الأداة المحدّد هذا.

GoogleSearchResultDelta

signature string  (اختياري)

لم يتم تقديم أي وصف.

result GoogleSearchResult  (اختياري)

لم يتم تقديم أي وصف.

نتيجة البحث على Google

الحقول

url string  (اختياري)

مرجع URI لنتيجة البحث

title string  (اختياري)

تمثّل هذه السمة عنوان نتيجة البحث.

rendered_content string  (اختياري)

مقتطف من محتوى الويب يمكن تضمينه في صفحة ويب أو عرض ويب داخل تطبيق

is_error boolean  (اختياري)

لم يتم تقديم أي وصف.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "google_search_result".

call_id string  (اختياري)

معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.

McpServerToolCallDelta

name string  (اختياري)

لم يتم تقديم أي وصف.

server_name string  (اختياري)

لم يتم تقديم أي وصف.

arguments object  (اختياري)

لم يتم تقديم أي وصف.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "mcp_server_tool_call".

id string  (اختياري)

معرّف فريد لاستدعاء الأداة المحدّد هذا.

McpServerToolResultDelta

name string  (اختياري)

لم يتم تقديم أي وصف.

server_name string  (اختياري)

لم يتم تقديم أي وصف.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "mcp_server_tool_result".

result كائن أو سلسلة  (اختياري)

دلتا نتيجة استدعاء الأداة

call_id string  (اختياري)

معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.

FileSearchResultDelta

result FileSearchResult  (اختياري)

لم يتم تقديم أي وصف.

نتيجة البحث عن الملفات

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان نتيجة البحث.

text string  (اختياري)

نص نتيجة البحث

file_search_store string  (اختياري)

تمثّل هذه السمة اسم متجر البحث عن الملفات.

type string  (مطلوبة)

يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.

يجب ضبطها دائمًا على "file_search_result".

ContentStop

الفهرس عدد صحيح  (اختياري)

لم يتم تقديم أي وصف.

event_type string  (اختياري)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "content.stop".

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

ErrorEvent

event_type string  (اختياري)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "error".

error Error  (اختياري)

لم يتم تقديم أي وصف.

رسالة الخطأ من تفاعل.

الحقول

code string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الذي يحدّد نوع الخطأ.

message string  (اختياري)

رسالة خطأ يمكن لشخص عادي قراءتها

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

أمثلة

بدء التفاعل

{
  "event_type": "interaction.start",
  "interaction": {
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-2.5-flash",
    "object": "interaction",
    "status": "in_progress"
  }
}

اكتمل التفاعل

{
  "event_type": "interaction.complete",
  "interaction": {
    "created": "2025-12-09T18:45:40Z",
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-2.5-flash",
    "object": "interaction",
    "outputs": [
      {
        "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh",
        "type": "thought"
      },
      {
        "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save",
        "type": "text"
      },
      {
        "text": " for one beloved anomaly: a chipped porcelain teacup, inherited from her grandmother, which held her morning Earl Grey.\n\nOne Tuesday, stirring her tea, Elara paused. At the bottom, nestled against the porcelain, was a star.",
        "type": "text"
      },
      {
        "text": " Not a star-shaped tea leaf, but a miniature, perfectly formed celestial body, radiating a faint, cool luminescence. Before she could gasp, it dissolved, leaving only the amber swirl of her brew. She dismissed it as a trick of",
        "type": "text"
      },
      {
        "text": " tired eyes.\n\nBut the next morning, a gossamer-thin feather, smaller than an eyelash and shimmering with iridescent hues, floated on the surface. It vanished the moment she tried to touch it. A week later, a single,",
        "type": "text"
      },
      {
        "text": " impossibly delicate bloom, like spun moonbeam, unfolded in her cup before fading into nothingness.\n\nThese weren't illusions. Each day, Elara\u2019s chipped teacup offered a fleeting, exquisite secret. A tiny, perfect",
        "type": "text"
      },
      {
        "text": " crystal, a miniature spiral nebula, a fragment of rainbow caught in liquid form. They never lingered, never accumulated, simply *were* and then *weren't*, leaving behind a residue of quiet wonder.\n\nElara never spoke",
        "type": "text"
      },
      {
        "text": " of it. It was her private wellspring, a daily reminder that magic could exist in the smallest, most overlooked corners of the world. Her routine remained unchanged, her external life a picture of calm, but inside, a secret garden blo",
        "type": "text"
      },
      {
        "text": "omed. Each dawn brought not just tea, but the silent promise of extraordinary beauty, waiting patiently in a chipped teacup.",
        "type": "text"
      }
    ],
    "role": "model",
    "status": "completed",
    "updated": "2025-12-09T18:45:40Z",
    "usage": {
      "input_tokens_by_modality": [
        {
          "modality": "text",
          "tokens": 11
        }
      ],
      "total_cached_tokens": 0,
      "total_input_tokens": 11,
      "total_output_tokens": 364,
      "total_reasoning_tokens": 1120,
      "total_tokens": 1495,
      "total_tool_use_tokens": 0
    }
  }
}

تعديل حالة التفاعل

{
  "event_type": "interaction.status_update",
  "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
  "status": "in_progress"
}

بداية المحتوى

{
  "event_type": "content.start",
  "content": {
    "type": "text"
  },
  "index": 1
}

Content Delta

{
  "event_type": "content.delta",
  "delta": {
    "type": "text",
    "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save"
  },
  "index": 1
}

إيقاف المحتوى

{
  "event_type": "content.stop",
  "index": 1
}

حدث الخطأ

{
  "event_type": "error",
  "error": {
    "message": "Failed to get completed interaction: Result not found.",
    "code": "not_found"
  }
}