Gemini API

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

عرض بتنسيق Markdown عرض مواصفات OpenAPI

إنشاء تفاعل

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

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

نص الطلب

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

model ModelOption  (اختياري)

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

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

  • gemini-2.5-flash

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

  • gemini-2.5-flash-image

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

  • gemini-2.5-flash-lite

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

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

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

  • gemini-2.5-flash-native-audio-preview-12-2025

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

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

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

  • gemini-2.5-flash-preview-tts

    نموذج تحويل النص إلى كلام 2.5 Flash محسّن لإنشاء كلام فعّال يمكن التحكّم فيه مع وقت استجابة منخفض.

  • gemini-2.5-pro

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

  • gemini-2.5-pro-preview-tts

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

  • gemini-3-flash-preview

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

  • gemini-3-pro-image-preview

    نموذج متطوّر لإنشاء الصور وتعديلها

  • gemini-3-pro-preview

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

  • gemini-3.1-pro-preview

    أحدث نموذج استدلالي لدينا يتميّز بأداء متطوّر غير مسبوق، وقدرات ترميز وفهم قوي لمختلف الوسائط.

  • gemini-3.1-flash-image-preview

    إمكانات ذكاء مرئي احترافية مع كفاءة عالية وسرعة فائقة وقدرات إنشاء محتوى واقعي

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

agent AgentOption  (اختياري)

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

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

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

    ‫Gemini Deep Research Agent

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

input Content أو array (Content) أو array (Turn) أو string  (مطلوب)

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

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)  (اختيارية)

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

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

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

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

  • minimal
  • low
  • medium
  • high

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

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

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

  • auto
  • none

max_output_tokens integer  (اختياري)

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

speech_config SpeechConfig  (اختياري)

إعدادات التفاعل مع الكلام

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

الحقول

voice string  (اختياري)

صوت المتحدث

language string  (اختياري)

لغة الكلام

speaker string  (اختياري)

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

image_config ImageConfig  (اختياري)

إعدادات التفاعل مع الصور

إعدادات التفاعل مع الصور

الحقول

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

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

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

  • 1:1
  • 2:3
  • 3:2
  • 3:4
  • 4:3
  • 4:5
  • 5:4
  • 9:16
  • 16:9
  • 21:9
  • 1:8
  • 8:1
  • 1:4
  • 4:1
image_size enum (string)  (اختياري)

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

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

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig أو ToolChoiceType  (اختيارية)

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

agent_config object  (اختياري)

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

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

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

DynamicAgentConfig

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

type object  (مطلوبة)

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

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

DeepResearchAgentConfig

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

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

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

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

  • auto
  • none

type object  (مطلوبة)

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

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

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-3-flash-preview",
  "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_thought_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

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

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "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_thought_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

إدخال صورة

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "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_thought_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

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

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "id": "gth23981",
      "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_thought_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": "agent",
  "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_thought_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` هي "صحيح".

include_input boolean  (اختياري)

في حال ضبطها على "صحيح"، يتم تضمين الإدخال في الرد.

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

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

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

الردّ

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

Get Interaction

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "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": "agent"
}

الموارد

التفاعل

مورد Interaction

الحقول

model ModelOption  (اختياري)

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

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

  • gemini-2.5-flash

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

  • gemini-2.5-flash-image

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

  • gemini-2.5-flash-lite

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

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

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

  • gemini-2.5-flash-native-audio-preview-12-2025

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

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

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

  • gemini-2.5-flash-preview-tts

    نموذج تحويل النص إلى كلام 2.5 Flash محسّن لإنشاء كلام فعّال يمكن التحكّم فيه مع وقت استجابة منخفض.

  • gemini-2.5-pro

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

  • gemini-2.5-pro-preview-tts

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

  • gemini-3-flash-preview

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

  • gemini-3-pro-image-preview

    نموذج متطوّر لإنشاء الصور وتعديلها

  • gemini-3-pro-preview

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

  • gemini-3.1-pro-preview

    أحدث نموذج استدلالي لدينا يتميّز بأداء متطوّر غير مسبوق، وقدرات ترميز وفهم قوي لمختلف الوسائط.

  • gemini-3.1-flash-image-preview

    إمكانات ذكاء مرئي احترافية مع كفاءة عالية وسرعة فائقة وقدرات إنشاء محتوى واقعي

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

agent AgentOption  (اختياري)

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

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

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

    ‫Gemini Deep Research Agent

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

id string  (اختياري)

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

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

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

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

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

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

updated string  (اختياري)

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

role string  (اختياري)

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

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

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

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

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

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

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

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_thought_tokens integer  (اختيارية)

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

total_tokens integer  (optional)

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

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

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

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

  • text
  • image
  • audio

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

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

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

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

previous_interaction_id string  (اختياري)

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

input Content أو array (Content) أو array (Turn) أو string  (مطلوب)

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

agent_config object  (اختياري)

مَعلمات الإعداد لتفاعل موظف الدعم

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

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

DynamicAgentConfig

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

type object  (مطلوبة)

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

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

DeepResearchAgentConfig

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

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

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

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

  • auto
  • none

type object  (مطلوبة)

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

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

أمثلة

مثال

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-3-flash-preview",
  "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_thought_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

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

المحتوى

محتوى الردّ.

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

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

TextContent

مقطع محتوى نصي

text string  (مطلوبة)

محتوى النص

annotations Annotation  (اختياري)

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

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

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

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

UrlCitation

تعليق توضيحي لاقتباس من عنوان URL

url string  (اختياري)

تمثّل هذه السمة عنوان URL.

title string  (اختياري)

تمثّل هذه السمة عنوان URL.

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

FileCitation

تعليق توضيحي لاقتباس ملف

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

معرّف الموارد المنتظم (URI) للملف

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

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

source string  (اختياري)

المصدر المنسوب إلى جزء من النص

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

PlaceCitation

تمثّل هذه السمة تعليقًا توضيحيًا لتوثيق مكان.

place_id string  (اختياري)

معرّف المكان، بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن على "خرائط Google"

تحتوي هذه السمة على مقتطف من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

type object  (مطلوبة)

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

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

ImageContent

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

data string  (اختياري)

محتوى الصورة

uri string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالصورة.

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

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

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

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (اختياري)

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

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

  • low
  • medium
  • high
  • ultra_high

type object  (مطلوبة)

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

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

AudioContent

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

data string  (اختياري)

المحتوى الصوتي

uri string  (اختياري)

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

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

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

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

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (مطلوبة)

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

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

DocumentContent

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

data string  (اختياري)

محتوى المستند

uri string  (اختياري)

معرّف الموارد المنتظم (URI) للمستند

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

نوع MIME للمستند.

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

  • application/pdf
type object  (مطلوبة)

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

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

VideoContent

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

data string  (اختياري)

محتوى الفيديو

uri string  (اختياري)

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

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

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

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

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (اختياري)

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

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

  • low
  • medium
  • high
  • ultra_high

type object  (مطلوبة)

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

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

ThoughtContent

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

signature string  (اختياري)

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

summary ThoughtSummaryContent  (اختياري)

ملخّص الفكرة

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

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

TextContent

مقطع محتوى نصي

text string  (مطلوبة)

محتوى النص

annotations Annotation  (اختياري)

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

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

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

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

UrlCitation

تعليق توضيحي لاقتباس من عنوان URL

url string  (اختياري)

تمثّل هذه السمة عنوان URL.

title string  (اختياري)

تمثّل هذه السمة عنوان URL.

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

FileCitation

تعليق توضيحي لاقتباس ملف

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

معرّف الموارد المنتظم (URI) للملف

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

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

source string  (اختياري)

المصدر المنسوب إلى جزء من النص

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

PlaceCitation

تمثّل هذه السمة تعليقًا توضيحيًا لتوثيق مكان.

place_id string  (اختياري)

معرّف المكان، بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن على "خرائط Google"

تحتوي هذه السمة على مقتطف من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

type object  (مطلوبة)

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

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

ImageContent

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

data string  (اختياري)

محتوى الصورة

uri string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالصورة.

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

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

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

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (اختياري)

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

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

  • low
  • medium
  • high
  • ultra_high

type object  (مطلوبة)

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

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

type object  (مطلوبة)

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

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

FunctionCallContent

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

name string  (مطلوب)

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

arguments object  (مطلوب)

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

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

FunctionResultContent

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

name string  (اختياري)

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

is_error boolean  (اختياري)

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

result array (FunctionResultSubcontent) or string  (مطلوبة)

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

CodeExecutionCallContent

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

arguments CodeExecutionCallArguments  (مطلوبة)

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

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

الحقول

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

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

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

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

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

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

CodeExecutionResultContent

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

result string  (مطلوبة)

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

is_error boolean  (اختياري)

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

UrlContextCallContent

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

arguments UrlContextCallArguments  (مطلوبة)

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

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

الحقول

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

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

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

UrlContextResultContent

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

result UrlContextResult  (مطلوب)

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

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

الحقول

url string  (اختياري)

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

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

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

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

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

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleSearchCallContent

محتوى "بحث Google"

arguments GoogleSearchCallArguments  (مطلوبة)

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

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

الحقول

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

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

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

نوع البحث المستند إلى تحديد المصدر مفعَّل.

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

  • web_search
  • image_search
type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleSearchResultContent

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

result GoogleSearchResult  (مطلوبة)

نتائج بحث Google

نتيجة بحث Google.

الحقول

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

مقتطف من محتوى الويب يمكن تضمينه في صفحة ويب أو WebView في تطبيق

is_error boolean  (اختياري)

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

McpServerToolCallContent

محتوى طلب أداة MCPServer

name string  (مطلوب)

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

server_name string  (مطلوبة)

تمثّل هذه السمة اسم خادم MCP المستخدَم.

arguments object  (مطلوب)

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

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

McpServerToolResultContent

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

name string  (اختياري)

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

server_name string  (اختياري)

تمثّل هذه السمة اسم خادم MCP المستخدَم.

result array (FunctionResultSubcontent) or string  (مطلوبة)

الناتج من طلب خادم MCP يمكن أن يكون نصًا بسيطًا أو محتوًى وافيًا.

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

FileSearchCallContent

محتوى "بحث الملفات"

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

FileSearchResultContent

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

result FileSearchResult  (اختياري)

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

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

معرّف يجب أن يتطابق مع المعرّف من حظر طلب البحث عن الملف.

signature string  (اختياري)

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

GoogleMapsCallContent

محتوى "خرائط Google"

arguments GoogleMapsCallArguments  (اختياري)

الوسيطات التي سيتم تمريرها إلى أداة "خرائط Google"

الوسيطات التي سيتم تمريرها إلى أداة "خرائط Google"

الحقول

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

طلبات البحث التي سيتم تنفيذها.

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleMapsResultContent

محتوى نتائج "خرائط Google"

result GoogleMapsResult  (مطلوبة)

نتائج "خرائط Google"

نتيجة "خرائط Google"

الحقول

places الأماكن  (اختيارية)

الأماكن التي تم العثور عليها

الحقول

place_id string  (اختياري)

معرّف المكان، بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن على "خرائط Google"

تحتوي هذه السمة على مقتطف من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

widget_context_token string  (اختياري)

اسم المورد لرمز السياق الخاص بتطبيق "خرائط Google" المصغّر

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

معرّف يجب أن يتطابق مع المعرّف من ميزة حظر المكالمات على "خرائط Google"

signature string  (اختياري)

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

أمثلة

نص

{
  "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": [
    {
      "type": "text",
      "text": "{\"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"
}

Url Context Call

{
  "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_call",
  "id": "call_123456"
}

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

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

مكالمة عبر "خرائط Google"

{
  "type": "google_maps_call",
  "id": "call_123456",
  "arguments": {
    "query": "best food near me"
  }
}

نتيجة البحث في "خرائط Google"

{
  "type": "google_maps_result",
  "call_id": "call_123456",
  "result": [
    {
      "places": [
        {
          "url": "https://www.google.com/maps/search/best+food+near+me",
          "name": "Tasty Restaurant"
        }
      ]
    }
  ]
}

الأداة

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

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

الوظيفة

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

name string  (اختياري)

اسم الدالة

description string  (اختياري)

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

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

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

type string  (مطلوبة)

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

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

GoogleSearch

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

search_types array (enum (string))  (اختياري)

أنواع تحديد المصدر للبحث التي يجب تفعيلها

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

  • web_search
  • image_search
type string  (مطلوبة)

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

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

CodeExecution

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

type string  (مطلوبة)

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

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

UrlContext

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

type string  (مطلوبة)

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

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

ComputerUse

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

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

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

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

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

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

type string  (مطلوبة)

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

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

McpServer

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

name string  (اختياري)

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

url string  (اختياري)

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

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

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

allowed_tools AllowedTools  (اختياري)

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

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

الحقول

mode ToolChoiceType  (اختياري)

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

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

  • auto
  • any
  • none
  • validated

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

تمثّل هذه السمة أسماء الأدوات المسموح بها.

type string  (مطلوبة)

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

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

FileSearch

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

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

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

top_k integer  (optional)

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

metadata_filter string  (اختياري)

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

type string  (مطلوبة)

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

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

GoogleMaps

أداة يمكن أن يستخدمها النموذج للاتصال بخدمة "خرائط Google"

enable_widget boolean  (اختياري)

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

latitude number  (اختياري)

تمثّل هذه السمة خط العرض للموقع الجغرافي للمستخدم.

longitude number  (اختياري)

تمثّل هذه السمة خط الطول للموقع الجغرافي للمستخدم.

type string  (اختياري)

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

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

أمثلة

الوظيفة

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

GoogleMaps

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

InteractionStartEvent

interaction Interaction  (حقل مطلوب)

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

event_type enum (string)  (مطلوبة)

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

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

  • interaction.start
event_id string  (اختياري)

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

InteractionCompleteEvent

interaction Interaction  (حقل مطلوب)

التفاعل المكتمل مع مخرجات فارغة لتقليل حجم حمولة البيانات استخدِم أحداث ContentDelta السابقة للحصول على الناتج الفعلي.

event_type enum (string)  (مطلوبة)

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

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

  • interaction.complete
event_id string  (اختياري)

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

InteractionStatusUpdate

interaction_id string  (مطلوبة)

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

الحالة enum (string)  (مطلوبة)

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

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

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_type string  (مطلوبة)

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

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

event_id string  (اختياري)

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

ContentStart

index عدد صحيح  (مطلوب)

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

المحتوى المحتوى  (مطلوب)

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

event_type string  (مطلوبة)

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

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

event_id string  (اختياري)

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

ContentDelta

index عدد صحيح  (مطلوب)

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

delta object  (مطلوبة)

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

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

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

TextDelta

text string  (مطلوبة)

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

annotations Annotation  (اختياري)

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

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

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

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

UrlCitation

تعليق توضيحي لاقتباس من عنوان URL

url string  (اختياري)

تمثّل هذه السمة عنوان URL.

title string  (اختياري)

تمثّل هذه السمة عنوان URL.

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

FileCitation

تعليق توضيحي لاقتباس ملف

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

معرّف الموارد المنتظم (URI) للملف

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

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

source string  (اختياري)

المصدر المنسوب إلى جزء من النص

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

PlaceCitation

تمثّل هذه السمة تعليقًا توضيحيًا لتوثيق مكان.

place_id string  (اختياري)

معرّف المكان، بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن على "خرائط Google"

تحتوي هذه السمة على مقتطف من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

type object  (مطلوبة)

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

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

ImageDelta

data string  (اختياري)

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

uri string  (اختياري)

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

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

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

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

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (اختياري)

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

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

  • low
  • medium
  • high
  • ultra_high

type object  (مطلوبة)

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

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

AudioDelta

data string  (اختياري)

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

uri string  (اختياري)

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

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

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

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

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (مطلوبة)

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

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

DocumentDelta

data string  (اختياري)

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

uri string  (اختياري)

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

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

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

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

  • application/pdf
type object  (مطلوبة)

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

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

VideoDelta

data string  (اختياري)

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

uri string  (اختياري)

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

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

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

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

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (اختياري)

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

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

  • low
  • medium
  • high
  • ultra_high

type object  (مطلوبة)

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

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

ThoughtSummaryDelta

content ThoughtSummaryContent  (اختياري)

عنصر ملخّص جديد سيتمّ إضافته إلى الفكرة.

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

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

TextContent

مقطع محتوى نصي

text string  (مطلوبة)

محتوى النص

annotations Annotation  (اختياري)

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

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

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

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

UrlCitation

تعليق توضيحي لاقتباس من عنوان URL

url string  (اختياري)

تمثّل هذه السمة عنوان URL.

title string  (اختياري)

تمثّل هذه السمة عنوان URL.

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

FileCitation

تعليق توضيحي لاقتباس ملف

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

معرّف الموارد المنتظم (URI) للملف

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

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

source string  (اختياري)

المصدر المنسوب إلى جزء من النص

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

PlaceCitation

تمثّل هذه السمة تعليقًا توضيحيًا لتوثيق مكان.

place_id string  (اختياري)

معرّف المكان، بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن على "خرائط Google"

تحتوي هذه السمة على مقتطف من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

type string  (مطلوبة)

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

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

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر

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

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

type object  (مطلوبة)

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

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

ImageContent

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

data string  (اختياري)

محتوى الصورة

uri string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالصورة.

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

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

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

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (اختياري)

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

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

  • low
  • medium
  • high
  • ultra_high

type object  (مطلوبة)

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

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

type object  (مطلوبة)

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

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

ThoughtSignatureDelta

signature string  (اختياري)

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

type object  (مطلوبة)

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

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

FunctionCallDelta

name string  (مطلوب)

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

arguments object  (مطلوب)

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

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

FunctionResultDelta

name string  (اختياري)

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

is_error boolean  (اختياري)

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

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

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

CodeExecutionCallDelta

arguments CodeExecutionCallArguments  (مطلوبة)

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

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

الحقول

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

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

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

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

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

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

CodeExecutionResultDelta

result string  (مطلوبة)

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

is_error boolean  (اختياري)

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

UrlContextCallDelta

arguments UrlContextCallArguments  (مطلوبة)

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

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

الحقول

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

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

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

UrlContextResultDelta

result UrlContextResult  (مطلوب)

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

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

الحقول

url string  (اختياري)

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

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

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

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

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

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleSearchCallDelta

arguments GoogleSearchCallArguments  (مطلوبة)

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

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

الحقول

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

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

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleSearchResultDelta

result GoogleSearchResult  (مطلوبة)

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

نتيجة بحث Google.

الحقول

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

مقتطف من محتوى الويب يمكن تضمينه في صفحة ويب أو WebView في تطبيق

is_error boolean  (اختياري)

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

McpServerToolCallDelta

name string  (مطلوب)

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

server_name string  (مطلوبة)

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

arguments object  (مطلوب)

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

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

McpServerToolResultDelta

name string  (اختياري)

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

server_name string  (اختياري)

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

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

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

FileSearchCallDelta

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

FileSearchResultDelta

result FileSearchResult  (اختياري)

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

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

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleMapsCallDelta

arguments GoogleMapsCallArguments  (اختياري)

الوسيطات التي سيتم تمريرها إلى أداة "خرائط Google"

الوسيطات التي سيتم تمريرها إلى أداة "خرائط Google"

الحقول

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

طلبات البحث التي سيتم تنفيذها.

type object  (مطلوبة)

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

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

id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleMapsResultDelta

result GoogleMapsResult  (مطلوبة)

نتائج "خرائط Google"

نتيجة "خرائط Google"

الحقول

places الأماكن  (اختيارية)

الأماكن التي تم العثور عليها

الحقول

place_id string  (اختياري)

معرّف المكان، بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن على "خرائط Google"

تحتوي هذه السمة على مقتطف من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

widget_context_token string  (اختياري)

اسم المورد لرمز السياق الخاص بتطبيق "خرائط Google" المصغّر

type object  (مطلوبة)

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

event_type string  (مطلوبة)

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

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

event_id string  (اختياري)

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

ContentStop

index عدد صحيح  (مطلوب)

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

event_type string  (مطلوبة)

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

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

event_id string  (اختياري)

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

ErrorEvent

error Error  (اختياري)

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

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

الحقول

code string  (اختياري)

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

message string  (اختياري)

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

event_type string  (مطلوبة)

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

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

event_id string  (اختياري)

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

أمثلة

بدء التفاعل

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

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

{
  "event_type": "interaction.complete",
  "interaction": {
    "created": "2025-12-09T18:45:40Z",
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "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_thought_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
}

فرق المحتوى

{
  "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"
  }
}