Gemini API

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

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

إنشاء تفاعل

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

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

نص الطلب

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

model ModelOption  (اختياري)

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

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

  • gemini-2.5-computer-use-preview-10-2025

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

  • 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

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

  • gemini-3.1-flash-lite-preview

    هذا النموذج هو الأكثر فعالية من حيث التكلفة، وهو محسّن لإنجاز المهام التي تتطلب وكلاء بكميات كبيرة، والترجمة، ومعالجة البيانات البسيطة.

  • gemini-3.1-flash-tts-preview

    ‫Gemini 3.1 Flash TTS: إنشاء كلام قوي وبزمن استجابة منخفض يمكنك الاستفادة من نتائج طبيعية ومطالبات قابلة للتوجيه وعلامات صوتية تعبيرية جديدة للتحكّم بدقة في السرد.

  • lyria-3-clip-preview

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

  • lyria-3-pro-preview

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

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

agent AgentOption  (اختياري)

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

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

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

    ‫Gemini Deep Research Agent

  • deep-research-preview-04-2026

    ‫Gemini Deep Research Agent

  • deep-research-max-preview-04-2026

    ‫Gemini Deep Research Max Agent

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

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

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

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

type object  (مطلوبة)

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

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

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

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

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

  • auto
  • none

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

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

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

  • off
  • auto
collaborative_planning boolean  (اختيارية)

تتيح هذه الإضافة التخطيط بمساعدة الإنسان للوكيل Deep Research. إذا تم ضبطها على true، سيقدّم وكيل Deep Research خطة بحث في رده. ولن يتابع الوكيل إلا إذا أكّد المستخدم الخطة في المحادثة التالية.

previous_interaction_id string  (اختياري)

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

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

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

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

  • text
  • image
  • audio
  • video
  • document

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

فئة الخدمة للتفاعل

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

  • flex
  • standard
  • priority

الردّ

تعرض هذه الطريقة مورد 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-computer-use-preview-10-2025

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

  • 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

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

  • gemini-3.1-flash-lite-preview

    هذا النموذج هو الأكثر فعالية من حيث التكلفة، وهو محسّن لإنجاز المهام التي تتطلب وكلاء بكميات كبيرة، والترجمة، ومعالجة البيانات البسيطة.

  • gemini-3.1-flash-tts-preview

    ‫Gemini 3.1 Flash TTS: إنشاء كلام قوي وبزمن استجابة منخفض يمكنك الاستفادة من نتائج طبيعية ومطالبات قابلة للتوجيه وعلامات صوتية تعبيرية جديدة للتحكّم بدقة في السرد.

  • lyria-3-clip-preview

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

  • lyria-3-pro-preview

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

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

agent AgentOption  (اختياري)

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

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

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

    ‫Gemini Deep Research Agent

  • deep-research-preview-04-2026

    ‫Gemini Deep Research Agent

  • deep-research-max-preview-04-2026

    ‫Gemini Deep Research Max 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
  • video
  • document

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

عدد الرموز المميزة للنموذج

total_cached_tokens integer  (optional)

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

cached_tokens_by_modality ModalityTokens  (اختياري)

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

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

الحقول

modality ResponseModality  (اختياري)

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

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

  • text
  • image
  • audio
  • video
  • document

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

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

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

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

output_tokens_by_modality ModalityTokens  (اختياري)

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

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

الحقول

modality ResponseModality  (اختياري)

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

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

  • text
  • image
  • audio
  • video
  • document

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

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

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

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

tool_use_tokens_by_modality ModalityTokens  (اختياري)

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

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

الحقول

modality ResponseModality  (اختياري)

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

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

  • text
  • image
  • audio
  • video
  • document

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

عدد الرموز المميزة للنموذج

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

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

total_tokens integer  (optional)

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

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

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

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

  • text
  • image
  • audio
  • video
  • document

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

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

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

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

previous_interaction_id string  (اختياري)

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

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

فئة الخدمة للتفاعل

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

  • flex
  • standard
  • priority
input المحتوى أو مصفوفة (المحتوى) أو مصفوفة (التحويل) أو سلسلة  (اختياري)

تمثّل هذه السمة الإدخال الخاص بالتفاعل.

agent_config object  (اختياري)

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

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

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

DynamicAgentConfig

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

type object  (مطلوبة)

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

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

DeepResearchAgentConfig

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

type object  (مطلوبة)

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

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

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

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

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

  • auto
  • none

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

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

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

  • off
  • auto
collaborative_planning boolean  (اختيارية)

تتيح هذه الإضافة التخطيط بمساعدة الإنسان للوكيل Deep Research. إذا تم ضبطها على true، سيقدّم وكيل 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

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

type object  (مطلوبة)

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

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

text string  (مطلوبة)

الحقل مطلوب. محتوى النص

annotations Annotation  (اختياري)

معلومات الاقتباس للمحتوى من إنشاء النموذج

معلومات الاقتباس للمحتوى من إنشاء النموذج

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

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

UrlCitation

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

type object  (مطلوبة)

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

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

url string  (اختياري)

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

title string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

FileCitation

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

type object  (مطلوبة)

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

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

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

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

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

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

source string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

PlaceCitation

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

type object  (مطلوبة)

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

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

place_id string  (اختياري)

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

name string  (اختياري)

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

url string  (اختياري)

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

review_snippets ReviewSnippet  (اختياري)

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

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

الحقول

title string  (اختياري)

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

url string  (اختياري)

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

review_id string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

ImageContent

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

type object  (مطلوبة)

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

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

data string  (اختياري)

محتوى الصورة

uri string  (اختياري)

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

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

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

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

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

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

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

  • low
  • medium
  • high
  • ultra_high

AudioContent

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

type object  (مطلوبة)

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

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

data string  (اختياري)

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

uri string  (اختياري)

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

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

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

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

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
rate عدد صحيح  (اختياري)

معدّل البيانات في الملف الصوتي

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

تمثّل هذه السمة عدد القنوات الصوتية.

DocumentContent

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

type object  (مطلوبة)

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

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

data string  (اختياري)

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

uri string  (اختياري)

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

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

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

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

  • application/pdf
VideoContent

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

type object  (مطلوبة)

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

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

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

ThoughtContent

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

type object  (مطلوبة)

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

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

signature string  (اختياري)

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

summary ThoughtSummaryContent  (اختياري)

ملخّص الفكرة

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

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

TextContent

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

type object  (مطلوبة)

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

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

text string  (مطلوبة)

الحقل مطلوب. محتوى النص

annotations Annotation  (اختياري)

معلومات الاقتباس للمحتوى من إنشاء النموذج

معلومات الاقتباس للمحتوى من إنشاء النموذج

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

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

UrlCitation

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

type object  (مطلوبة)

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

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

url string  (اختياري)

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

title string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

FileCitation

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

type object  (مطلوبة)

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

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

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

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

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

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

source string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

PlaceCitation

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

type object  (مطلوبة)

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

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

place_id string  (اختياري)

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

name string  (اختياري)

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

url string  (اختياري)

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

review_snippets ReviewSnippet  (اختياري)

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

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

الحقول

title string  (اختياري)

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

url string  (اختياري)

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

review_id string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

ImageContent

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

type object  (مطلوبة)

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

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

data string  (اختياري)

محتوى الصورة

uri string  (اختياري)

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

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

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

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

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

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

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

  • low
  • medium
  • high
  • ultra_high

FunctionCallContent

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

type object  (مطلوبة)

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

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

name string  (مطلوب)

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

arguments object  (مطلوب)

الحقل مطلوب. الوسيطات التي سيتم تمريرها إلى الدالة

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

CodeExecutionCallContent

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

type object  (مطلوبة)

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

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

arguments CodeExecutionCallArguments  (مطلوبة)

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

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

الحقول

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

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

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

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

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

UrlContextCallContent

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

type object  (مطلوبة)

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

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

arguments UrlContextCallArguments  (مطلوبة)

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

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

الحقول

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

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

McpServerToolCallContent

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

type object  (مطلوبة)

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

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

name string  (مطلوب)

الحقل مطلوب. اسم الأداة التي تم استدعاؤها

server_name string  (مطلوبة)

الحقل مطلوب. تمثّل هذه السمة اسم خادم MCP المستخدَم.

arguments object  (مطلوب)

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

GoogleSearchCallContent

محتوى "بحث Google"

type object  (مطلوبة)

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

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

arguments GoogleSearchCallArguments  (مطلوبة)

الحقل مطلوب. المَعلمات التي سيتم تمريرها إلى "بحث Google"

المَعلمات التي سيتم تمريرها إلى "بحث Google"

الحقول

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

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

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

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

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

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

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

FileSearchCallContent

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

type object  (مطلوبة)

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

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

GoogleMapsCallContent

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

type object  (مطلوبة)

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

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

arguments GoogleMapsCallArguments  (اختياري)

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

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

الحقول

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

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

FunctionResultContent

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

type object  (مطلوبة)

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

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

name string  (اختياري)

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

is_error boolean  (اختياري)

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

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

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

CodeExecutionResultContent

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

type object  (مطلوبة)

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

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

result string  (مطلوبة)

الحقل مطلوب. ناتج تنفيذ الرمز البرمجي

is_error boolean  (اختياري)

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

UrlContextResultContent

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

type object  (مطلوبة)

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

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

result UrlContextResult  (مطلوب)

الحقل مطلوب. نتائج سياق عنوان URL

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

الحقول

url string  (اختياري)

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

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

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

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

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleSearchResultContent

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

type object  (مطلوبة)

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

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

result GoogleSearchResult  (مطلوبة)

الحقل مطلوب. نتائج بحث Google

نتيجة بحث Google.

الحقول

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

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

is_error boolean  (اختياري)

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

McpServerToolResultContent

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

type object  (مطلوبة)

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

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

name string  (اختياري)

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

server_name string  (اختياري)

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

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

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

FileSearchResultContent

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

type object  (مطلوبة)

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

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

result FileSearchResult  (مطلوبة)

الحقل مطلوب. نتائج البحث عن الملفات

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

الحقول

custom_metadata array (object)  (اختيارية)

بيانات التعريف المقدَّمة من المستخدم حول FileSearchResult.

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleMapsResultContent

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

type object  (مطلوبة)

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

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

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" المصغّرة

call_id string  (مطلوبة)

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

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": "code_execution_call",
  "id": "call_123456",
  "arguments": {
    "language": "python",
    "code": "print('hello world')"
  }
}

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

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

استدعاء أداة خادم Mcp

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

اتصال بحث Google

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

طلب البحث عن ملف

{
  "type": "file_search_call",
  "id": "call_123456"
}

ميزة "الاتصال" في "خرائط Google"

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

نتيجة الدالة

{
  "type": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": [
    {
      "type": "text",
      "text": "{\"weather\":\"sunny\"}"
    }
  ]
}

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

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

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

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

نتيجة بحث من 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

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

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

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

نتيجة البحث في "خرائط 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

الوظيفة

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

type object  (مطلوبة)

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

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

name string  (اختياري)

اسم الدالة

description string  (اختياري)

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

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

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

CodeExecution

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

type object  (مطلوبة)

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

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

UrlContext

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

type object  (مطلوبة)

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

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

ComputerUse

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

type object  (مطلوبة)

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

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

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

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

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

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

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

McpServer

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

type object  (مطلوبة)

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

يجب ضبطها دائمًا على "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)  (اختياري)

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

GoogleSearch

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

type object  (مطلوبة)

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

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

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

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

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

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

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

type object  (مطلوبة)

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

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

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

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

top_k integer  (optional)

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

metadata_filter string  (اختياري)

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

GoogleMaps

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

type object  (مطلوبة)

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

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

enable_widget boolean  (اختياري)

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

latitude number  (اختياري)

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

longitude number  (اختياري)

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

الاسترجاع

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

type object  (مطلوبة)

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

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

retrieval_types array (enum (string))  (اختيارية)

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

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

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig  (اختياري)

تُستخدَم لتحديد إعدادات VertexAISearch.

تُستخدَم لتحديد إعدادات VertexAISearch.

الحقول

engine string  (اختياري)

اختياريّ. تُستخدَم لتحديد محرّك بحث Vertex AI Search.

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

اختياريّ. تُستخدَم لتحديد مخازن بيانات Vertex AI Search.

أمثلة

الوظيفة

CodeExecution

UrlContext

ComputerUse

McpServer

GoogleSearch

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

event_type object  (مطلوبة)

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

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

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

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

event_id string  (اختياري)

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

InteractionCompleteEvent

event_type object  (مطلوبة)

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

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

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

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

event_id string  (اختياري)

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

InteractionStatusUpdate

event_type object  (مطلوبة)

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

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

interaction_id string  (مطلوبة)

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

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

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

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

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

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

ContentStart

event_type object  (مطلوبة)

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

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

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

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

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

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

event_id string  (اختياري)

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

ContentDelta

event_type object  (مطلوبة)

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

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

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

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

delta ContentDeltaData  (مطلوبة)

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

تمثّل هذه السمة بيانات المحتوى المتغيّر لكتلة محتوى.

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

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

TextDelta

type object  (مطلوبة)

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

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

text string  (مطلوبة)

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

ImageDelta

type object  (مطلوبة)

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

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

data string  (اختياري)

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

uri string  (اختياري)

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

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

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

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

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

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

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

  • low
  • medium
  • high
  • ultra_high

AudioDelta

type object  (مطلوبة)

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

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

data string  (اختياري)

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

uri string  (اختياري)

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

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

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

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

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
rate عدد صحيح  (اختياري)

معدّل البيانات في الملف الصوتي

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

تمثّل هذه السمة عدد القنوات الصوتية.

DocumentDelta

type object  (مطلوبة)

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

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

data string  (اختياري)

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

uri string  (اختياري)

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

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

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

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

  • application/pdf
VideoDelta

type object  (مطلوبة)

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

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

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

ThoughtSummaryDelta

type object  (مطلوبة)

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

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

content ThoughtSummaryContent  (اختياري)

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

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

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

TextContent

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

type object  (مطلوبة)

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

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

text string  (مطلوبة)

الحقل مطلوب. محتوى النص

annotations Annotation  (اختياري)

معلومات الاقتباس للمحتوى من إنشاء النموذج

معلومات الاقتباس للمحتوى من إنشاء النموذج

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

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

UrlCitation

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

type object  (مطلوبة)

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

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

url string  (اختياري)

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

title string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

FileCitation

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

type object  (مطلوبة)

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

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

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

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

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

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

source string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

PlaceCitation

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

type object  (مطلوبة)

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

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

place_id string  (اختياري)

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

name string  (اختياري)

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

url string  (اختياري)

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

review_snippets ReviewSnippet  (اختياري)

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

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

الحقول

title string  (اختياري)

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

url string  (اختياري)

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

review_id string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

ImageContent

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

type object  (مطلوبة)

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

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

data string  (اختياري)

محتوى الصورة

uri string  (اختياري)

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

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

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

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

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

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

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

  • low
  • medium
  • high
  • ultra_high

ThoughtSignatureDelta

type object  (مطلوبة)

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

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

signature string  (اختياري)

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

FunctionCallDelta

type object  (مطلوبة)

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

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

name string  (مطلوب)

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

arguments object  (مطلوب)

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

CodeExecutionCallDelta

type object  (مطلوبة)

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

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

arguments CodeExecutionCallArguments  (مطلوبة)

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

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

الحقول

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

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

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

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

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

UrlContextCallDelta

type object  (مطلوبة)

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

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

arguments UrlContextCallArguments  (مطلوبة)

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

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

الحقول

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

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

GoogleSearchCallDelta

type object  (مطلوبة)

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

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

arguments GoogleSearchCallArguments  (مطلوبة)

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

المَعلمات التي سيتم تمريرها إلى "بحث Google"

الحقول

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

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

McpServerToolCallDelta

type object  (مطلوبة)

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

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

name string  (مطلوب)

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

server_name string  (مطلوبة)

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

arguments object  (مطلوب)

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

FileSearchCallDelta

type object  (مطلوبة)

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

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

GoogleMapsCallDelta

type object  (مطلوبة)

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

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

arguments GoogleMapsCallArguments  (اختياري)

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

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

الحقول

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

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

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

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

FunctionResultDelta

type object  (مطلوبة)

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

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

name string  (اختياري)

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

is_error boolean  (اختياري)

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

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

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

CodeExecutionResultDelta

type object  (مطلوبة)

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

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

result string  (مطلوبة)

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

is_error boolean  (اختياري)

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

UrlContextResultDelta

type object  (مطلوبة)

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

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

result UrlContextResult  (مطلوب)

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

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

الحقول

url string  (اختياري)

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

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

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

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

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

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleSearchResultDelta

type object  (مطلوبة)

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

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

result GoogleSearchResult  (مطلوبة)

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

نتيجة بحث Google.

الحقول

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

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

is_error boolean  (اختياري)

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

McpServerToolResultDelta

type object  (مطلوبة)

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

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

name string  (اختياري)

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

server_name string  (اختياري)

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

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

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

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

FileSearchResultDelta

type object  (مطلوبة)

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

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

result FileSearchResult  (مطلوبة)

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

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

الحقول

custom_metadata array (object)  (اختيارية)

بيانات التعريف المقدَّمة من المستخدم حول FileSearchResult.

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

GoogleMapsResultDelta

type object  (مطلوبة)

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

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

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" المصغّرة

call_id string  (مطلوبة)

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

signature string  (اختياري)

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

TextAnnotationDelta

type object  (مطلوبة)

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

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

annotations Annotation  (اختياري)

معلومات الاقتباس للمحتوى من إنشاء النموذج

معلومات الاقتباس للمحتوى من إنشاء النموذج

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

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

UrlCitation

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

type object  (مطلوبة)

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

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

url string  (اختياري)

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

title string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

FileCitation

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

type object  (مطلوبة)

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

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

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

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

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

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

source string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

PlaceCitation

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

type object  (مطلوبة)

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

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

place_id string  (اختياري)

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

name string  (اختياري)

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

url string  (اختياري)

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

review_snippets ReviewSnippet  (اختياري)

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

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

الحقول

title string  (اختياري)

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

url string  (اختياري)

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

review_id string  (اختياري)

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

start_index integer  (اختياري)

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

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

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

event_id string  (اختياري)

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

ContentStop

event_type object  (مطلوبة)

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

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

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

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

event_id string  (اختياري)

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

ErrorEvent

event_type object  (مطلوبة)

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

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

error Error  (اختياري)

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

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

الحقول

code string  (اختياري)

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

message string  (اختياري)

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

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