Gemini API

Gemini Interactions API, geliştiricilerin Gemini modellerini kullanarak üretken yapay zeka uygulamaları oluşturmasına olanak tanıyan deneysel bir API'dir. Gemini, çok formatlı olacak şekilde sıfırdan geliştirilen en yetenekli modelimizdir. Dil, resim, ses, video ve kod gibi farklı bilgi türlerini genelleştirebilir, sorunsuz bir şekilde anlayabilir, bunlar arasında işlem yapabilir ve bunları birleştirebilir. Gemini API'yi metin ve resimlerde akıl yürütme, içerik oluşturma, diyalog aracısı, özetleme ve sınıflandırma sistemleri gibi kullanım alanlarında kullanabilirsiniz.

Markdown olarak görüntüle OpenAPI Spesifikasyonu'nu görüntüleme

Etkileşim oluşturma

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

Yeni bir etkileşim oluşturur.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

model ModelOption  (isteğe bağlı)

Etkileşimi oluşturmak için kullanılan "Model"in adı.
"agent" sağlanmadıysa zorunludur.

Olası değerler:

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

    Doğrudan arayüz etkileşimi için tasarlanmış, Gemini'ın dijital ortamları algılamasına ve bu ortamlarda gezinmesine olanak tanıyan bir ajan tabanlı yetenek modeli.

  • gemini-2.5-flash

    1 milyon parçalık bağlam penceresini destekleyen ve düşünme bütçelerine sahip ilk karma akıl yürütme modelimiz.

  • gemini-2.5-flash-image

    Hız, esneklik ve bağlamsal anlayış için optimize edilmiş yerel görüntü üretme modelimiz. Metin girişi ve çıkışı, 2,5 Flash ile aynı şekilde fiyatlandırılır.

  • gemini-2.5-flash-lite

    Büyük ölçekli kullanım için tasarlanan en küçük ve en uygun maliyetli modelimiz.

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

    Maliyet verimliliği, yüksek gönderim hacmi ve yüksek kalite için optimize edilmiş Gemini 2.5 Flash lite'a dayalı en yeni model.

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

    Daha iyi hız, ses doğallığı, ayrıntı düzeyi ve ruh haliyle daha yüksek kaliteli ses çıkışları için optimize edilmiş yerel ses modellerimiz.

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

    2.5 Flash modeline dayalı en yeni model. 2.5 Flash Preview, büyük ölçekli işleme, düşük gecikme süresi, düşünme gerektiren yüksek hacimli görevler ve temsilci kullanım alanları için en iyisidir.

  • gemini-2.5-flash-preview-tts

    Güçlü ve düşük gecikmeli, kontrol edilebilir konuşma üretimi için optimize edilmiş 2.5 Flash metin okuma modelimiz.

  • gemini-2.5-pro

    Kodlama ve karmaşık akıl yürütme görevlerinde üstün performans gösteren, son teknoloji ürünü çok amaçlı modelimiz.

  • gemini-2.5-pro-preview-tts

    2.5 Pro metin okuma ses modelimiz, daha doğal çıkışlar ve daha kolay yönlendirilen istemler için güçlü ve düşük gecikmeli konuşma üretimi amacıyla optimize edilmiştir.

  • gemini-3-flash-preview

    Hız için tasarlanmış en akıllı modelimiz. Yeni nesil zekayı üstün arama ve temellendirme özellikleriyle birleştirir.

  • gemini-3-pro-image-preview

    Son teknoloji ürünü görüntü üretme ve düzenleme modeli.

  • gemini-3-pro-preview

    En akıllı modelimiz; en gelişmiş akıl yürütme, çok formatlı anlama, güçlü aracı ve sezgisel kodlama özelliklerine sahiptir.

  • gemini-3.1-pro-preview

    Eşi benzeri görülmemiş derinlik ve ayrıntıya sahip, güçlü çok formatlı anlama ve kodlama yetenekleri sunan en yeni SOTA akıl yürütme modelimiz.

  • gemini-3.1-flash-image-preview

    Flash hızında verimlilik ve gerçekliğe dayalı üretim özellikleriyle profesyonel düzeyde görsel zeka.

  • gemini-3.1-flash-lite-preview

    Yüksek hacimli ajan tabanlı görevler, çeviri ve basit veri işleme için optimize edilmiş, en uygun maliyetli modelimiz.

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: Güçlü ve düşük gecikmeli konuşma üretimi. Doğal çıkışlar, yönlendirilebilir istemler ve hassas anlatım kontrolü için yeni etkileyici ses etiketlerinden yararlanın.

  • lyria-3-clip-preview

    Yüksek kaliteli ses klipleri ve hassas ritmik kontrol için optimize edilmiş, düşük gecikmeli müzik üretme modelimiz.

  • lyria-3-pro-preview

    Gelişmiş, tam şarkı üretken modelimiz; kompozisyonu derinlemesine anlar, farklı müzik tarzlarında hassas yapısal kontrol ve karmaşık geçişler için optimize edilmiştir.

İsteminizi tamamlayacak model.\n\nEk ayrıntılar için [modeller](https://ai.google.dev/gemini-api/docs/models) bölümüne bakın.

agent AgentOption  (isteğe bağlı)

Etkileşimi oluşturmak için kullanılan "Agent"ın adı.
"model" sağlanmadıysa zorunludur.

Olası değerler:

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

    Gemini Deep Research Ajanı

  • deep-research-preview-04-2026

    Gemini Deep Research Ajanı

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

    Gemini Deep Research Max Agent

Etkileşim kurulacak temsilci.

input Content veya dizi (Content) veya dizi (Turn) veya dize  (zorunlu)

Etkileşim için girişler (hem Model hem de Temsilci için ortaktır).

system_instruction string  (isteğe bağlı)

Etkileşim için sistem talimatı.

tools array (Tool)  (isteğe bağlı)

Modelin etkileşim sırasında çağırabileceği araç bildirimlerinin listesi.

response_format object  (isteğe bağlı)

Oluşturulan yanıtın, bu alanda belirtilen JSON şemasına uygun bir JSON nesnesi olmasını zorunlu kılar.

response_mime_type string  (isteğe bağlı)

Yanıtın MIME türü. response_format ayarlanmışsa bu gereklidir.

stream boolean  (isteğe bağlı)

Yalnızca giriş. Etkileşimin yayınlanıp yayınlanmayacağı.

store boolean  (isteğe bağlı)

Yalnızca giriş. Yanıtın ve isteğin daha sonra alınmak üzere saklanıp saklanmayacağı.

background boolean  (isteğe bağlı)

Yalnızca giriş. Model etkileşiminin arka planda çalıştırılıp çalıştırılmayacağı.

generation_config GenerationConfig  (isteğe bağlı)

Model Yapılandırması
Model etkileşimi için yapılandırma parametreleri.
"agent_config" yerine kullanılabilir. Yalnızca "model" ayarlandığında geçerlidir.

Model etkileşimleri için yapılandırma parametreleri.

Alanlar

temperature number  (isteğe bağlı)

Çıkışın rastgeleliğini kontrol eder.

top_p number  (isteğe bağlı)

Örnekleme sırasında dikkate alınacak jetonların maksimum kümülatif olasılığı.

seed integer  (isteğe bağlı)

Yeniden üretilebilirlik için kod çözme işleminde kullanılan başlangıç değeri.

stop_sequences array (string)  (isteğe bağlı)

Çıkış etkileşimini durduracak karakter dizilerinin listesi.

thinking_level ThinkingLevel  (isteğe bağlı)

Modelin oluşturması gereken düşünce jetonlarının düzeyi.

Olası değerler:

  • minimal
  • low
  • medium
  • high

thinking_summaries ThinkingSummaries  (isteğe bağlı)

Yanıta düşünce özetlerinin dahil edilip edilmeyeceği.

Olası değerler:

  • auto
  • none

max_output_tokens integer  (isteğe bağlı)

Yanıtın içereceği maksimum jeton sayısı.

speech_config SpeechConfig  (isteğe bağlı)

Konuşma etkileşimi için yapılandırma.

Konuşma etkileşimi yapılandırması.

Alanlar

voice string  (isteğe bağlı)

Konuşmacının sesi.

language string  (isteğe bağlı)

Konuşmanın dili.

speaker string  (isteğe bağlı)

Konuşmacının adı, istemde verilen konuşmacı adıyla eşleşmelidir.

image_config ImageConfig  (isteğe bağlı)

Resim etkileşimi için yapılandırma.

Resim etkileşimi yapılandırması.

Alanlar

aspect_ratio enum (string)  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

  • 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)  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig veya ToolChoiceType  (isteğe bağlı)

Araç seçimi yapılandırması.

agent_config object  (isteğe bağlı)

Aracı Yapılandırması
Aracının yapılandırması.
"generation_config" yerine kullanılabilir. Yalnızca "agent" ayarlandığında geçerlidir.

Olası Türler

Polimorfik ayırıcı: type

DynamicAgentConfig

Dinamik aracılar için yapılandırma.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "dynamic" olarak ayarlanır.

DeepResearchAgentConfig

Deep Research temsilcisinin yapılandırması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "deep-research" olarak ayarlanır.

thinking_summaries ThinkingSummaries  (isteğe bağlı)

Yanıta düşünce özetlerinin dahil edilip edilmeyeceği.

Olası değerler:

  • auto
  • none

visualization enum (string)  (isteğe bağlı)

Yanıtın görselleştirmeler içerip içermeyeceği.

Olası değerler:

  • off
  • auto
collaborative_planning boolean  (isteğe bağlı)

Deep Research aracısı için insan etkileşimli planlamayı etkinleştirir. Doğru olarak ayarlanırsa Deep Research temsilcisi, yanıtında bir araştırma planı sunar. Aracı, yalnızca kullanıcı bir sonraki adımda planı onaylarsa devam eder.

previous_interaction_id string  (isteğe bağlı)

Varsa önceki etkileşimin kimliği.

response_modalities ResponseModality  (isteğe bağlı)

Yanıtın istenen biçimleri (METİN, RESİM, SES).

Olası değerler:

  • text
  • image
  • audio
  • video
  • document

service_tier enum (string)  (isteğe bağlı)

Etkileşimin hizmet katmanı.

Olası değerler:

  • flex
  • standard
  • priority

Yanıt

Etkileşim kaynağını döndürür.

Basit İstek

Örnek Yanıt

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

Çok dönüşlü

Örnek Yanıt

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

Görüntü Girişi

Örnek Yanıt

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

İşlev Çağırma

Örnek Yanıt

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

Örnek Yanıt

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

Etkileşimi alma

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

Tek bir etkileşimin tüm ayrıntılarını `Interaction.id` değerine göre alır.

Yol / Sorgu Parametreleri

id dize  (zorunlu)

Alınacak etkileşimin benzersiz tanımlayıcısı.

stream boolean  (isteğe bağlı)

Doğru değerine ayarlanırsa oluşturulan içerik artımlı olarak yayınlanır.

Varsayılan değer: False

last_event_id dize  (isteğe bağlı)

İsteğe bağlı. Ayarlanırsa etkileşim akışını, etkinlik kimliğiyle işaretlenen etkinlikten sonraki parçadan itibaren devam ettirir. Yalnızca "stream" doğruysa kullanılabilir.

include_input boolean  (isteğe bağlı)

Doğru olarak ayarlanırsa girişi yanıta dahil eder.

Varsayılan değer: False

api_version dize  (isteğe bağlı)

API'nin hangi sürümünün kullanılacağı.

Yanıt

Etkileşim kaynağını döndürür.

Etkileşim Alma

Örnek Yanıt

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

Etkileşimi silme

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

Etkileşimi kimliğe göre siler.

Yol / Sorgu Parametreleri

id dize  (zorunlu)

Silinecek etkileşimin benzersiz tanımlayıcısı.

api_version dize  (isteğe bağlı)

API'nin hangi sürümünün kullanılacağı.

Yanıt

Başarılı olursa yanıt boş olur.

Etkileşimi Silme

Etkileşimi iptal etme

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

Kimliğe göre bir etkileşimi iptal eder. Bu yalnızca hâlâ çalışmakta olan arka plan etkileşimleri için geçerlidir.

Yol / Sorgu Parametreleri

id dize  (zorunlu)

İptal edilecek etkileşimin benzersiz tanımlayıcısı.

api_version dize  (isteğe bağlı)

API'nin hangi sürümünün kullanılacağı.

Yanıt

Interaction kaynağını döndürür.

Etkileşimi İptal Etme

Örnek Yanıt

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

Kaynaklar

Etkileşim

Etkileşim kaynağı.

Alanlar

model ModelOption  (isteğe bağlı)

Etkileşimi oluşturmak için kullanılan "Model"in adı.

Olası değerler:

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

    Doğrudan arayüz etkileşimi için tasarlanmış, Gemini'ın dijital ortamları algılamasına ve bu ortamlarda gezinmesine olanak tanıyan bir ajan tabanlı yetenek modeli.

  • gemini-2.5-flash

    1 milyon parçalık bağlam penceresini destekleyen ve düşünme bütçelerine sahip ilk karma akıl yürütme modelimiz.

  • gemini-2.5-flash-image

    Hız, esneklik ve bağlamsal anlayış için optimize edilmiş yerel görüntü üretme modelimiz. Metin girişi ve çıkışı, 2,5 Flash ile aynı şekilde fiyatlandırılır.

  • gemini-2.5-flash-lite

    Büyük ölçekli kullanım için tasarlanan en küçük ve en uygun maliyetli modelimiz.

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

    Maliyet verimliliği, yüksek gönderim hacmi ve yüksek kalite için optimize edilmiş Gemini 2.5 Flash lite'a dayalı en yeni model.

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

    Daha iyi hız, ses doğallığı, ayrıntı düzeyi ve ruh haliyle daha yüksek kaliteli ses çıkışları için optimize edilmiş yerel ses modellerimiz.

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

    2.5 Flash modeline dayalı en yeni model. 2.5 Flash Preview, büyük ölçekli işleme, düşük gecikme süresi, düşünme gerektiren yüksek hacimli görevler ve temsilci kullanım alanları için en iyisidir.

  • gemini-2.5-flash-preview-tts

    Güçlü ve düşük gecikmeli, kontrol edilebilir konuşma üretimi için optimize edilmiş 2.5 Flash metin okuma modelimiz.

  • gemini-2.5-pro

    Kodlama ve karmaşık akıl yürütme görevlerinde üstün performans gösteren, son teknoloji ürünü çok amaçlı modelimiz.

  • gemini-2.5-pro-preview-tts

    2.5 Pro metin okuma ses modelimiz, daha doğal çıkışlar ve daha kolay yönlendirilen istemler için güçlü ve düşük gecikmeli konuşma üretimi amacıyla optimize edilmiştir.

  • gemini-3-flash-preview

    Hız için tasarlanmış en akıllı modelimiz. Yeni nesil zekayı üstün arama ve temellendirme özellikleriyle birleştirir.

  • gemini-3-pro-image-preview

    Son teknoloji ürünü görüntü üretme ve düzenleme modeli.

  • gemini-3-pro-preview

    En akıllı modelimiz; en gelişmiş akıl yürütme, çok formatlı anlama, güçlü aracı ve sezgisel kodlama özelliklerine sahiptir.

  • gemini-3.1-pro-preview

    Eşi benzeri görülmemiş derinlik ve ayrıntıya sahip, güçlü çok formatlı anlama ve kodlama yetenekleri sunan en yeni SOTA akıl yürütme modelimiz.

  • gemini-3.1-flash-image-preview

    Flash hızında verimlilik ve gerçekliğe dayalı üretim özellikleriyle profesyonel düzeyde görsel zeka.

  • gemini-3.1-flash-lite-preview

    Yüksek hacimli ajan tabanlı görevler, çeviri ve basit veri işleme için optimize edilmiş, en uygun maliyetli modelimiz.

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: Güçlü ve düşük gecikmeli konuşma üretimi. Doğal çıkışlar, yönlendirilebilir istemler ve hassas anlatım kontrolü için yeni etkileyici ses etiketlerinden yararlanın.

  • lyria-3-clip-preview

    Yüksek kaliteli ses klipleri ve hassas ritmik kontrol için optimize edilmiş, düşük gecikmeli müzik üretme modelimiz.

  • lyria-3-pro-preview

    Gelişmiş, tam şarkı üretken modelimiz; kompozisyonu derinlemesine anlar, farklı müzik tarzlarında hassas yapısal kontrol ve karmaşık geçişler için optimize edilmiştir.

İsteminizi tamamlayacak model.\n\nEk ayrıntılar için [modeller](https://ai.google.dev/gemini-api/docs/models) bölümüne bakın.

agent AgentOption  (isteğe bağlı)

Etkileşimi oluşturmak için kullanılan "Agent"ın adı.

Olası değerler:

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

    Gemini Deep Research Ajanı

  • deep-research-preview-04-2026

    Gemini Deep Research Ajanı

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

    Gemini Deep Research Max Agent

Etkileşim kurulacak temsilci.

id dize  (isteğe bağlı)

Zorunlu. Yalnızca çıkış. Etkileşim tamamlama için benzersiz tanımlayıcı.

status enum (string)  (isteğe bağlı)

Zorunlu. Yalnızca çıkış. Etkileşimin durumu.

Olası değerler:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created string  (isteğe bağlı)

Zorunlu. Yalnızca çıkış. Yanıtın oluşturulduğu saat, ISO 8601 biçiminde (YYYY-AA-GGTsa:dk:snZ).

updated dize  (isteğe bağlı)

Zorunlu. Yalnızca çıkış. Yanıtın en son güncellendiği ISO 8601 biçimindeki saat (YYYY-AA-GGTsa:dk:snZ).

role string  (isteğe bağlı)

Yalnızca çıkış. Etkileşimin rolü.

outputs array (Content)  (isteğe bağlı)

Yalnızca çıkış. Modelin yanıtları.

system_instruction string  (isteğe bağlı)

Etkileşim için sistem talimatı.

tools array (Tool)  (isteğe bağlı)

Modelin etkileşim sırasında çağırabileceği araç bildirimlerinin listesi.

usage Kullanım  (isteğe bağlı)

Yalnızca çıkış. Etkileşim isteğinin jeton kullanımıyla ilgili istatistikler.

Etkileşim isteğinin jeton kullanımıyla ilgili istatistikler.

Alanlar

total_input_tokens integer  (isteğe bağlı)

İstemdeki (bağlam) jeton sayısı.

input_tokens_by_modality ModalityTokens  (isteğe bağlı)

Giriş jetonu kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler:

  • text
  • image
  • audio
  • video
  • document

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_cached_tokens integer  (isteğe bağlı)

İstemdeki önbelleğe alınmış bölümdeki (önbelleğe alınmış içerik) jeton sayısı.

cached_tokens_by_modality ModalityTokens  (isteğe bağlı)

Önbelleğe alınmış jeton kullanımının, yönteme göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler:

  • text
  • image
  • audio
  • video
  • document

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_output_tokens integer  (isteğe bağlı)

Oluşturulan tüm yanıtlardaki toplam jeton sayısı.

output_tokens_by_modality ModalityTokens  (isteğe bağlı)

Çıkış jetonu kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler:

  • text
  • image
  • audio
  • video
  • document

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_tool_use_tokens integer  (isteğe bağlı)

Araç kullanma istemlerinde bulunan jeton sayısı.

tool_use_tokens_by_modality ModalityTokens  (isteğe bağlı)

Aracı kullanma jetonlarının kullanımının, modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler:

  • text
  • image
  • audio
  • video
  • document

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_thought_tokens integer  (isteğe bağlı)

Düşünen modeller için düşünce jetonlarının sayısı.

total_tokens integer  (isteğe bağlı)

Etkileşim isteği için toplam jeton sayısı (istem + yanıtlar + diğer dahili jetonlar).

response_modalities ResponseModality  (isteğe bağlı)

Yanıtın istenen biçimleri (METİN, RESİM, SES).

Olası değerler:

  • text
  • image
  • audio
  • video
  • document

response_format object  (isteğe bağlı)

Oluşturulan yanıtın, bu alanda belirtilen JSON şemasına uygun bir JSON nesnesi olmasını zorunlu kılar.

response_mime_type string  (isteğe bağlı)

Yanıtın MIME türü. response_format ayarlanmışsa bu gereklidir.

previous_interaction_id string  (isteğe bağlı)

Varsa önceki etkileşimin kimliği.

service_tier enum (string)  (isteğe bağlı)

Etkileşimin hizmet katmanı.

Olası değerler:

  • flex
  • standard
  • priority
input Content veya dizi (Content) veya dizi (Turn) veya dize  (isteğe bağlı)

Etkileşimin girişi.

agent_config object  (isteğe bağlı)

Aracı etkileşimi için yapılandırma parametreleri.

Olası Türler

Polimorfik ayırıcı: type

DynamicAgentConfig

Dinamik aracılar için yapılandırma.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "dynamic" olarak ayarlanır.

DeepResearchAgentConfig

Deep Research temsilcisinin yapılandırması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "deep-research" olarak ayarlanır.

thinking_summaries ThinkingSummaries  (isteğe bağlı)

Yanıta düşünce özetlerinin dahil edilip edilmeyeceği.

Olası değerler:

  • auto
  • none

visualization enum (string)  (isteğe bağlı)

Yanıtın görselleştirmeler içerip içermeyeceği.

Olası değerler:

  • off
  • auto
collaborative_planning boolean  (isteğe bağlı)

Deep Research aracısı için insan etkileşimli planlamayı etkinleştirir. Doğru olarak ayarlanırsa Deep Research temsilcisi, yanıtında bir araştırma planı sunar. Aracı, yalnızca kullanıcı bir sonraki adımda planı onaylarsa devam eder.

Örnekler

Örnek

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

Veri Modelleri

İçerik

Yanıtın içeriği.

Olası Türler

Polimorfik ayrıştırıcı: type

TextContent

Metin içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "text" olarak ayarlanır.

text string  (gerekli)

Zorunlu. Metin içeriği.

annotations Annotation  (isteğe bağlı)

Model tarafından üretilen içeriklerin alıntı bilgileri.

Model tarafından üretilen içeriklerin alıntı bilgileri.

Olası Türler

Polimorfik ayrıştırıcı: type

UrlCitation

URL alıntı açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "url_citation" olarak ayarlanır.

url string  (isteğe bağlı)

URL.

title string  (isteğe bağlı)

URL'nin başlığı.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

FileCitation

Dosya alıntısı ek açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "file_citation" olarak ayarlanır.

document_uri dize  (isteğe bağlı)

Dosyanın URI'si.

file_name dize  (isteğe bağlı)

Dosyanın adı.

source dize  (isteğe bağlı)

Metnin bir bölümü için atfedilen kaynak.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

PlaceCitation

Yer alıntısı ek açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "place_citation" olarak ayarlanır.

place_id dize  (isteğe bağlı)

Yer kimliği, "places/{place_id}" biçimindedir.

name string  (isteğe bağlı)

Yerin başlığı.

url string  (isteğe bağlı)

Yerin URI referansı.

review_snippets ReviewSnippet  (isteğe bağlı)

Google Haritalar'da belirli bir yerin özellikleri hakkında yanıt oluşturmak için kullanılan yorum snippet'leri.

Google Haritalar'daki belirli bir yerin özellikleri hakkındaki bir soruyu yanıtlayan kullanıcı yorumu snippet'ini kapsar.

Alanlar

title string  (isteğe bağlı)

Yorumun başlığı.

url string  (isteğe bağlı)

Google Haritalar'daki kullanıcı yorumuna karşılık gelen bağlantı.

review_id string  (isteğe bağlı)

Yorum snippet'inin kimliği.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

ImageContent

Resim içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "image" olarak ayarlanır.

data string  (isteğe bağlı)

Resim içeriği.

uri dize  (isteğe bağlı)

Resmin URI'si.

mime_type enum (string)  (isteğe bağlı)

Resmin MIME türü.

Olası değerler:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (isteğe bağlı)

Medyanın çözünürlüğü.

Olası değerler:

  • low
  • medium
  • high
  • ultra_high

AudioContent

Sesli içerik bloğu

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "audio" olarak ayarlanır.

data string  (isteğe bağlı)

Ses içeriği.

uri dize  (isteğe bağlı)

Sesin URI'si.

mime_type enum (string)  (isteğe bağlı)

Sesin MIME türü.

Olası değerler:

  • 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 integer  (isteğe bağlı)

Sesin örnekleme hızı.

channels integer  (isteğe bağlı)

Ses kanallarının sayısı.

DocumentContent

Doküman içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "document" olarak ayarlanır.

data string  (isteğe bağlı)

Dokümanın içeriği.

uri dize  (isteğe bağlı)

Belgenin URI'si.

mime_type enum (string)  (isteğe bağlı)

Belgenin MIME türü.

Olası değerler:

  • application/pdf
VideoContent

Video içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "video" olarak ayarlanır.

data string  (isteğe bağlı)

Video içeriği

uri dize  (isteğe bağlı)

Videonun URI'si.

mime_type enum (string)  (isteğe bağlı)

Videonun MIME türü.

Olası değerler:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (isteğe bağlı)

Medyanın çözünürlüğü.

Olası değerler:

  • low
  • medium
  • high
  • ultra_high

ThoughtContent

Düşünce içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "thought" olarak ayarlanır.

signature string  (isteğe bağlı)

Oluşturma işlemine dahil edilecek arka uç kaynağıyla eşleşen imza.

summary ThoughtSummaryContent  (isteğe bağlı)

Düşüncenin özeti.

Olası Türler

Polimorfik ayrıştırıcı: type

TextContent

Metin içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "text" olarak ayarlanır.

text string  (gerekli)

Zorunlu. Metin içeriği.

annotations Annotation  (isteğe bağlı)

Model tarafından üretilen içeriklerin alıntı bilgileri.

Model tarafından üretilen içeriklerin alıntı bilgileri.

Olası Türler

Polimorfik ayrıştırıcı: type

UrlCitation

URL alıntı açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "url_citation" olarak ayarlanır.

url string  (isteğe bağlı)

URL.

title string  (isteğe bağlı)

URL'nin başlığı.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

FileCitation

Dosya alıntısı ek açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "file_citation" olarak ayarlanır.

document_uri dize  (isteğe bağlı)

Dosyanın URI'si.

file_name dize  (isteğe bağlı)

Dosyanın adı.

source dize  (isteğe bağlı)

Metnin bir bölümü için atfedilen kaynak.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

PlaceCitation

Yer alıntısı ek açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "place_citation" olarak ayarlanır.

place_id dize  (isteğe bağlı)

Yer kimliği, "places/{place_id}" biçimindedir.

name string  (isteğe bağlı)

Yerin başlığı.

url string  (isteğe bağlı)

Yerin URI referansı.

review_snippets ReviewSnippet  (isteğe bağlı)

Google Haritalar'da belirli bir yerin özellikleri hakkında yanıt oluşturmak için kullanılan yorum snippet'leri.

Google Haritalar'daki belirli bir yerin özellikleri hakkındaki bir soruyu yanıtlayan kullanıcı yorumu snippet'ini kapsar.

Alanlar

title string  (isteğe bağlı)

Yorumun başlığı.

url string  (isteğe bağlı)

Google Haritalar'daki kullanıcı yorumuna karşılık gelen bağlantı.

review_id string  (isteğe bağlı)

Yorum snippet'inin kimliği.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

ImageContent

Resim içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "image" olarak ayarlanır.

data string  (isteğe bağlı)

Resim içeriği.

uri dize  (isteğe bağlı)

Resmin URI'si.

mime_type enum (string)  (isteğe bağlı)

Resmin MIME türü.

Olası değerler:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (isteğe bağlı)

Medyanın çözünürlüğü.

Olası değerler:

  • low
  • medium
  • high
  • ultra_high

FunctionCallContent

İşlev aracı çağrısı içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "function_call" olarak ayarlanır.

name string  (zorunlu)

Zorunlu. Çağrılacak aracın adı.

arguments object  (zorunlu)

Zorunlu. İşleve geçirilecek bağımsız değişkenler.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

CodeExecutionCallContent

Kod yürütme içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "code_execution_call" olarak ayarlanır.

arguments CodeExecutionCallArguments  (gerekli)

Zorunlu. Kod yürütmeye aktarılacak bağımsız değişkenler.

Kod yürütmeye aktarılacak bağımsız değişkenler.

Alanlar

language enum (string)  (isteğe bağlı)

"code"un programlama dili.

Olası değerler:

  • python
code string  (isteğe bağlı)

Yürütülecek kod.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

UrlContextCallContent

URL bağlam içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "url_context_call" olarak ayarlanır.

arguments UrlContextCallArguments  (gerekli)

Zorunlu. URL bağlamına aktarılacak bağımsız değişkenler.

URL bağlamına aktarılacak bağımsız değişkenler.

Alanlar

urls array (string)  (isteğe bağlı)

Getirilecek URL'ler.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

McpServerToolCallContent

MCPServer aracı çağrı içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "mcp_server_tool_call" olarak ayarlanır.

name string  (zorunlu)

Zorunlu. Çağrılan aracın adı.

server_name string  (zorunlu)

Zorunlu. Kullanılan MCP sunucusunun adı.

arguments object  (zorunlu)

Zorunlu. İşlevin bağımsız değişkenlerinin JSON nesnesi.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

GoogleSearchCallContent

Google Arama içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_search_call" olarak ayarlanır.

arguments GoogleSearchCallArguments  (zorunlu)

Zorunlu. Google Arama'ya iletilecek bağımsız değişkenler.

Google Arama'ya iletilecek bağımsız değişkenler.

Alanlar

queries array (string)  (isteğe bağlı)

Takip eden web araması için web arama sorguları.

search_type enum (string)  (isteğe bağlı)

Etkinleştirilen arama temellendirme türü.

Olası değerler:

  • web_search
  • image_search
  • enterprise_web_search
id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

FileSearchCallContent

Dosya Arama içeriği

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "file_search_call" olarak ayarlanır.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

GoogleMapsCallContent

Google Haritalar içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_maps_call" olarak ayarlanır.

arguments GoogleMapsCallArguments  (isteğe bağlı)

Google Haritalar aracına aktarılacak bağımsız değişkenler.

Google Haritalar aracına iletilecek bağımsız değişkenler.

Alanlar

queries array (string)  (isteğe bağlı)

Yürütülecek sorgular.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

FunctionResultContent

Bir işlev aracı sonuç içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "function_result" olarak ayarlanır.

name string  (isteğe bağlı)

Çağrılan aracın adı.

is_error boolean  (isteğe bağlı)

Araç çağrısının hatayla sonuçlanıp sonuçlanmadığı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

result array (FunctionResultSubcontent) or string  (zorunlu)

Araç çağrısının sonucu.

CodeExecutionResultContent

Kod yürütme sonucu içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "code_execution_result" olarak ayarlanır.

result dize  (zorunlu)

Zorunlu. Kod yürütmenin çıkışı.

is_error boolean  (isteğe bağlı)

Kod yürütme işleminin hatayla sonuçlanıp sonuçlanmadığı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

UrlContextResultContent

URL bağlamı sonuç içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "url_context_result" olarak ayarlanır.

result UrlContextResult  (zorunlu)

Zorunlu. URL bağlamının sonuçları.

URL bağlamının sonucu.

Alanlar

url string  (isteğe bağlı)

Getirilen URL.

status enum (string)  (isteğe bağlı)

URL alma işleminin durumu.

Olası değerler:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (isteğe bağlı)

URL bağlamının hataya neden olup olmadığı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

GoogleSearchResultContent

Google arama sonucu içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_search_result" olarak ayarlanır.

result GoogleSearchResult  (zorunlu)

Zorunlu. Google Arama'nın sonuçları.

Google Arama'nın sonucu.

Alanlar

search_suggestions dize  (isteğe bağlı)

Bir web sayfasına veya uygulama web görünümüne yerleştirilebilen web içeriği snippet'i.

is_error boolean  (isteğe bağlı)

Google Arama'nın hatayla sonuçlanıp sonuçlanmadığı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

McpServerToolResultContent

MCPServer aracı sonuç içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "mcp_server_tool_result" olarak ayarlanır.

name string  (isteğe bağlı)

Bu belirli araç çağrısı için çağrılan aracın adı.

server_name string  (isteğe bağlı)

Kullanılan MCP sunucusunun adı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

result array (FunctionResultSubcontent) or string  (zorunlu)

MCP sunucusu çağrısının çıkışı. Basit metin veya zengin içerik olabilir.

FileSearchResultContent

Dosya arama sonucu içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "file_search_result" olarak ayarlanır.

result FileSearchResult  (zorunlu)

Zorunlu. Dosya Arama'nın sonuçları.

Dosya Arama'nın sonucu.

Alanlar

custom_metadata array (object)  (isteğe bağlı)

FileSearchResult hakkında kullanıcı tarafından sağlanan meta veriler.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

GoogleMapsResultContent

Google Haritalar sonuç içeriği.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_maps_result" olarak ayarlanır.

result GoogleMapsResult  (zorunlu)

Zorunlu. Google Haritalar'ın sonuçları

Google Haritalar'ın sonucu.

Alanlar

places Yerler  (isteğe bağlı)

Bulunan yerler.

Alanlar

place_id dize  (isteğe bağlı)

Yer kimliği, "places/{place_id}" biçimindedir.

name string  (isteğe bağlı)

Yerin başlığı.

url string  (isteğe bağlı)

Yerin URI referansı.

review_snippets ReviewSnippet  (isteğe bağlı)

Google Haritalar'da belirli bir yerin özellikleri hakkında yanıt oluşturmak için kullanılan yorum snippet'leri.

Google Haritalar'daki belirli bir yerin özellikleri hakkındaki bir soruyu yanıtlayan kullanıcı yorumu snippet'ini kapsar.

Alanlar

title string  (isteğe bağlı)

Yorumun başlığı.

url string  (isteğe bağlı)

Google Haritalar'daki kullanıcı yorumuna karşılık gelen bağlantı.

review_id string  (isteğe bağlı)

Yorum snippet'inin kimliği.

widget_context_token dize  (isteğe bağlı)

Google Haritalar widget'ı bağlam jetonunun kaynak adı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

Örnekler

Metin

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

Resim

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

Ses

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

Belge

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

Video

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

Düşünüldü

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

İşlev Çağrısı

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

Kod Yürütme Çağrısı

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

URL Bağlamı Çağrısı

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

MCP Sunucusu Aracı Çağrısı

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

Google Arama Araması

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

Dosya Arama Çağrısı

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

Google Haritalar görüşmesi

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

İşlev Sonucu

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

Kod Yürütme Sonucu

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

URL Bağlamı Sonucu

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

Google Arama Sonucu

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

MCP Sunucusu Aracı Sonucu

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

Dosya Arama Sonucu

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

Google Haritalar Sonucu

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

Araç

Model tarafından kullanılabilen bir araç.

Olası Türler

Polimorfik ayrıştırıcı: type

İşlev

Model tarafından kullanılabilen bir araç.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "function" olarak ayarlanır.

name string  (isteğe bağlı)

İşlevin adı.

description string  (isteğe bağlı)

İşlevin açıklaması.

parameters object  (isteğe bağlı)

İşlevin parametreleri için JSON şeması.

CodeExecution

Modelin kodu yürütmek için kullanabileceği bir araç.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "code_execution" olarak ayarlanır.

UrlContext

Modelin URL bağlamını getirmek için kullanabileceği bir araç.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "url_context" olarak ayarlanır.

ComputerUse

Modelin bilgisayarla etkileşim kurmak için kullanabileceği bir araç.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "computer_use" olarak ayarlanır.

environment enum (string)  (isteğe bağlı)

Çalıştırılan ortam.

Olası değerler:

  • browser
excludedPredefinedFunctions array (string)  (isteğe bağlı)

Model çağrısından hariç tutulan önceden tanımlanmış işlevlerin listesi.

McpServer

MCPServer, model tarafından işlem gerçekleştirmek için çağrılabilen bir sunucudur.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "mcp_server" olarak ayarlanır.

name string  (isteğe bağlı)

MCPServer'ın adı.

url string  (isteğe bağlı)

MCPServer uç noktasının tam URL'si. Örnek: "https://api.example.com/mcp"

headers object  (isteğe bağlı)

İsteğe bağlı: Gerekirse kimlik doğrulama başlıkları, zaman aşımları vb. için alanlar.

allowed_tools AllowedTools  (isteğe bağlı)

İzin verilen araçlar

İzin verilen araçların yapılandırması.

Alanlar

mode ToolChoiceType  (isteğe bağlı)

Araç seçiminin modu.

Olası değerler:

  • auto
  • any
  • none
  • validated

tools array (string)  (isteğe bağlı)

İzin verilen araçların adları.

GoogleSearch

Modelin Google'da arama yapmak için kullanabileceği bir araç.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_search" olarak ayarlanır.

search_types array (enum (string))  (isteğe bağlı)

Etkinleştirilecek arama temellendirme türleri.

Olası değerler:

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

Modelin dosyaları aramak için kullanabileceği bir araç.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "file_search" olarak ayarlanır.

file_search_store_names array (string)  (isteğe bağlı)

Dosya, aranacak mağaza adlarını içerir.

top_k integer  (isteğe bağlı)

Alınacak semantik alma parçalarının sayısı.

metadata_filter dize  (isteğe bağlı)

Anlamsal alma belgelerine ve parçalarına uygulanacak meta veri filtresi.

GoogleMaps

Modelin Google Haritalar'ı çağırmak için kullanabileceği bir araç.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_maps" olarak ayarlanır.

enable_widget boolean  (isteğe bağlı)

Yanıtın araç çağrısı sonucunda bir widget bağlam jetonunun döndürülüp döndürülmeyeceği.

latitude number  (isteğe bağlı)

Kullanıcının bulunduğu yerin enlemi.

longitude number  (isteğe bağlı)

Kullanıcının konumunun boylamı.

Alma

Modelin dosyaları almak için kullanabileceği bir araç.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "retrieval" olarak ayarlanır.

retrieval_types dizi (enum (string))  (isteğe bağlı)

Etkinleştirilecek dosya alma türleri.

Olası değerler:

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig  (isteğe bağlı)

VertexAISearch için yapılandırmayı belirtmek üzere kullanılır.

VertexAISearch için yapılandırmayı belirtmek üzere kullanılır.

Alanlar

engine string  (isteğe bağlı)

İsteğe bağlı. Vertex AI Search motorunu belirtmek için kullanılır.

datastores array (string)  (isteğe bağlı)

İsteğe bağlı. Vertex AI Search veri depolarını belirtmek için kullanılır.

Örnekler

İşlev

CodeExecution

UrlContext

ComputerUse

McpServer

GoogleSearch

FileSearch

GoogleMaps

Alma

Bu tür için örnek yok.

CANNOT TRANSLATE

Alanlar

role string  (isteğe bağlı)

Bu dönüşün kaynağı. Giriş için kullanıcı, model çıkışı için model olmalıdır.

content dizi (Content) veya dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Örnekler

Kullanıcı Sırası

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

Model Turn

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

InteractionSseEvent

Olası Türler

Polimorfik ayrıştırıcı: event_type

InteractionStartEvent

event_type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "interaction.start" olarak ayarlanır.

interaction Interaction  (zorunlu)

Hiçbir açıklama sağlanmadı.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

InteractionCompleteEvent

event_type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "interaction.complete" olarak ayarlanır.

interaction Interaction  (zorunlu)

Zorunlu. Yük boyutunu küçültmek için boş çıkışlarla tamamlanan etkileşim. Gerçek çıktı için önceki ContentDelta etkinliklerini kullanın.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

InteractionStatusUpdate

event_type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "interaction.status_update" olarak ayarlanır.

interaction_id dize  (zorunlu)

Hiçbir açıklama sağlanmadı.

status enum (string)  (required)

Hiçbir açıklama sağlanmadı.

Olası değerler:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

ContentStart

event_type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "content.start" olarak ayarlanır.

index integer  (zorunlu)

Hiçbir açıklama sağlanmadı.

content Content  (zorunlu)

Hiçbir açıklama sağlanmadı.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

ContentDelta

event_type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "content.delta" olarak ayarlanır.

index integer  (zorunlu)

Hiçbir açıklama sağlanmadı.

delta ContentDeltaData  (zorunlu)

Hiçbir açıklama sağlanmadı.

Bir içerik bloğunun delta içerik verileri.

Olası Türler

Polimorfik ayırıcı: type

TextDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "text" olarak ayarlanır.

text string  (gerekli)

Hiçbir açıklama sağlanmadı.

ImageDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "image" olarak ayarlanır.

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type enum (string)  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (isteğe bağlı)

Medyanın çözünürlüğü.

Olası değerler:

  • low
  • medium
  • high
  • ultra_high

AudioDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "audio" olarak ayarlanır.

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type enum (string)  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

  • 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 integer  (isteğe bağlı)

Sesin örnekleme hızı.

channels integer  (isteğe bağlı)

Ses kanallarının sayısı.

DocumentDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "document" olarak ayarlanır.

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type enum (string)  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

  • application/pdf
VideoDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "video" olarak ayarlanır.

data string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

uri dize  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

mime_type enum (string)  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Olası değerler:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (isteğe bağlı)

Medyanın çözünürlüğü.

Olası değerler:

  • low
  • medium
  • high
  • ultra_high

ThoughtSummaryDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "thought_summary" olarak ayarlanır.

content ThoughtSummaryContent  (isteğe bağlı)

Düşünceye eklenecek yeni bir özet öğesi.

Olası Türler

Polimorfik ayrıştırıcı: type

TextContent

Metin içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "text" olarak ayarlanır.

text string  (gerekli)

Zorunlu. Metin içeriği.

annotations Annotation  (isteğe bağlı)

Model tarafından üretilen içeriklerin alıntı bilgileri.

Model tarafından üretilen içeriklerin alıntı bilgileri.

Olası Türler

Polimorfik ayrıştırıcı: type

UrlCitation

URL alıntı açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "url_citation" olarak ayarlanır.

url string  (isteğe bağlı)

URL.

title string  (isteğe bağlı)

URL'nin başlığı.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

FileCitation

Dosya alıntısı ek açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "file_citation" olarak ayarlanır.

document_uri dize  (isteğe bağlı)

Dosyanın URI'si.

file_name dize  (isteğe bağlı)

Dosyanın adı.

source dize  (isteğe bağlı)

Metnin bir bölümü için atfedilen kaynak.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

PlaceCitation

Yer alıntısı ek açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "place_citation" olarak ayarlanır.

place_id dize  (isteğe bağlı)

Yer kimliği, "places/{place_id}" biçimindedir.

name string  (isteğe bağlı)

Yerin başlığı.

url string  (isteğe bağlı)

Yerin URI referansı.

review_snippets ReviewSnippet  (isteğe bağlı)

Google Haritalar'da belirli bir yerin özellikleri hakkında yanıt oluşturmak için kullanılan yorum snippet'leri.

Google Haritalar'daki belirli bir yerin özellikleri hakkındaki bir soruyu yanıtlayan kullanıcı yorumu snippet'ini kapsar.

Alanlar

title string  (isteğe bağlı)

Yorumun başlığı.

url string  (isteğe bağlı)

Google Haritalar'daki kullanıcı yorumuna karşılık gelen bağlantı.

review_id string  (isteğe bağlı)

Yorum snippet'inin kimliği.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

ImageContent

Resim içerik bloğu.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "image" olarak ayarlanır.

data string  (isteğe bağlı)

Resim içeriği.

uri dize  (isteğe bağlı)

Resmin URI'si.

mime_type enum (string)  (isteğe bağlı)

Resmin MIME türü.

Olası değerler:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (isteğe bağlı)

Medyanın çözünürlüğü.

Olası değerler:

  • low
  • medium
  • high
  • ultra_high

ThoughtSignatureDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "thought_signature" olarak ayarlanır.

signature string  (isteğe bağlı)

Oluşturma işlemine dahil edilecek arka uç kaynağıyla eşleşen imza.

FunctionCallDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "function_call" olarak ayarlanır.

name string  (zorunlu)

Hiçbir açıklama sağlanmadı.

arguments object  (zorunlu)

Hiçbir açıklama sağlanmadı.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

CodeExecutionCallDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "code_execution_call" olarak ayarlanır.

arguments CodeExecutionCallArguments  (gerekli)

Hiçbir açıklama sağlanmadı.

Kod yürütmeye aktarılacak bağımsız değişkenler.

Alanlar

language enum (string)  (isteğe bağlı)

"code"un programlama dili.

Olası değerler:

  • python
code string  (isteğe bağlı)

Yürütülecek kod.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

UrlContextCallDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "url_context_call" olarak ayarlanır.

arguments UrlContextCallArguments  (gerekli)

Hiçbir açıklama sağlanmadı.

URL bağlamına aktarılacak bağımsız değişkenler.

Alanlar

urls array (string)  (isteğe bağlı)

Getirilecek URL'ler.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

GoogleSearchCallDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_search_call" olarak ayarlanır.

arguments GoogleSearchCallArguments  (zorunlu)

Hiçbir açıklama sağlanmadı.

Google Arama'ya iletilecek bağımsız değişkenler.

Alanlar

queries array (string)  (isteğe bağlı)

Takip eden web araması için web arama sorguları.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

McpServerToolCallDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "mcp_server_tool_call" olarak ayarlanır.

name string  (zorunlu)

Hiçbir açıklama sağlanmadı.

server_name string  (zorunlu)

Hiçbir açıklama sağlanmadı.

arguments object  (zorunlu)

Hiçbir açıklama sağlanmadı.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

FileSearchCallDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "file_search_call" olarak ayarlanır.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

GoogleMapsCallDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_maps_call" olarak ayarlanır.

arguments GoogleMapsCallArguments  (isteğe bağlı)

Google Haritalar aracına aktarılacak bağımsız değişkenler.

Google Haritalar aracına iletilecek bağımsız değişkenler.

Alanlar

queries array (string)  (isteğe bağlı)

Yürütülecek sorgular.

id dize  (zorunlu)

Zorunlu. Bu belirli araç çağrısının benzersiz kimliği.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

FunctionResultDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "function_result" olarak ayarlanır.

name string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

is_error boolean  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

result array (FunctionResultSubcontent) or string  (zorunlu)

Hiçbir açıklama sağlanmadı.

CodeExecutionResultDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "code_execution_result" olarak ayarlanır.

result dize  (zorunlu)

Hiçbir açıklama sağlanmadı.

is_error boolean  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

UrlContextResultDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "url_context_result" olarak ayarlanır.

result UrlContextResult  (zorunlu)

Hiçbir açıklama sağlanmadı.

URL bağlamının sonucu.

Alanlar

url string  (isteğe bağlı)

Getirilen URL.

status enum (string)  (isteğe bağlı)

URL alma işleminin durumu.

Olası değerler:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

GoogleSearchResultDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_search_result" olarak ayarlanır.

result GoogleSearchResult  (zorunlu)

Hiçbir açıklama sağlanmadı.

Google Arama'nın sonucu.

Alanlar

search_suggestions dize  (isteğe bağlı)

Bir web sayfasına veya uygulama web görünümüne yerleştirilebilen web içeriği snippet'i.

is_error boolean  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

McpServerToolResultDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "mcp_server_tool_result" olarak ayarlanır.

name string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

server_name string  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

result array (FunctionResultSubcontent) or string  (zorunlu)

Hiçbir açıklama sağlanmadı.

FileSearchResultDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "file_search_result" olarak ayarlanır.

result FileSearchResult  (zorunlu)

Hiçbir açıklama sağlanmadı.

Dosya Arama'nın sonucu.

Alanlar

custom_metadata array (object)  (isteğe bağlı)

FileSearchResult hakkında kullanıcı tarafından sağlanan meta veriler.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

GoogleMapsResultDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "google_maps_result" olarak ayarlanır.

result GoogleMapsResult  (isteğe bağlı)

Google Haritalar'ın sonuçları

Google Haritalar'ın sonucu.

Alanlar

places Yerler  (isteğe bağlı)

Bulunan yerler.

Alanlar

place_id dize  (isteğe bağlı)

Yer kimliği, "places/{place_id}" biçimindedir.

name string  (isteğe bağlı)

Yerin başlığı.

url string  (isteğe bağlı)

Yerin URI referansı.

review_snippets ReviewSnippet  (isteğe bağlı)

Google Haritalar'da belirli bir yerin özellikleri hakkında yanıt oluşturmak için kullanılan yorum snippet'leri.

Google Haritalar'daki belirli bir yerin özellikleri hakkındaki bir soruyu yanıtlayan kullanıcı yorumu snippet'ini kapsar.

Alanlar

title string  (isteğe bağlı)

Yorumun başlığı.

url string  (isteğe bağlı)

Google Haritalar'daki kullanıcı yorumuna karşılık gelen bağlantı.

review_id string  (isteğe bağlı)

Yorum snippet'inin kimliği.

widget_context_token dize  (isteğe bağlı)

Google Haritalar widget'ı bağlam jetonunun kaynak adı.

call_id dize  (zorunlu)

Zorunlu. İşlev çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

Arka uç doğrulaması için imza karması.

TextAnnotationDelta

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "text_annotation" olarak ayarlanır.

annotations Annotation  (isteğe bağlı)

Model tarafından üretilen içeriklerin alıntı bilgileri.

Model tarafından üretilen içeriklerin alıntı bilgileri.

Olası Türler

Polimorfik ayrıştırıcı: type

UrlCitation

URL alıntı açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "url_citation" olarak ayarlanır.

url string  (isteğe bağlı)

URL.

title string  (isteğe bağlı)

URL'nin başlığı.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

FileCitation

Dosya alıntısı ek açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "file_citation" olarak ayarlanır.

document_uri dize  (isteğe bağlı)

Dosyanın URI'si.

file_name dize  (isteğe bağlı)

Dosyanın adı.

source dize  (isteğe bağlı)

Metnin bir bölümü için atfedilen kaynak.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

PlaceCitation

Yer alıntısı ek açıklaması.

type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "place_citation" olarak ayarlanır.

place_id dize  (isteğe bağlı)

Yer kimliği, "places/{place_id}" biçimindedir.

name string  (isteğe bağlı)

Yerin başlığı.

url string  (isteğe bağlı)

Yerin URI referansı.

review_snippets ReviewSnippet  (isteğe bağlı)

Google Haritalar'da belirli bir yerin özellikleri hakkında yanıt oluşturmak için kullanılan yorum snippet'leri.

Google Haritalar'daki belirli bir yerin özellikleri hakkındaki bir soruyu yanıtlayan kullanıcı yorumu snippet'ini kapsar.

Alanlar

title string  (isteğe bağlı)

Yorumun başlığı.

url string  (isteğe bağlı)

Google Haritalar'daki kullanıcı yorumuna karşılık gelen bağlantı.

review_id string  (isteğe bağlı)

Yorum snippet'inin kimliği.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı. Dizin, bayt cinsinden ölçülen segmentin başlangıcını gösterir.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

ContentStop

event_type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "content.stop" olarak ayarlanır.

index integer  (zorunlu)

Hiçbir açıklama sağlanmadı.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

ErrorEvent

event_type object  (zorunlu)

Hiçbir açıklama sağlanmadı.

Her zaman "error" olarak ayarlanır.

error Error  (isteğe bağlı)

Hiçbir açıklama sağlanmadı.

Bir etkileşimden gelen hata mesajı.

Alanlar

code string  (isteğe bağlı)

Hata türünü tanımlayan bir URI.

message string  (isteğe bağlı)

Kullanıcıların okuyabileceği bir hata mesajı.

event_id dize  (isteğe bağlı)

Etkileşim akışını bu etkinlikten itibaren sürdürmek için kullanılacak event_id jetonu.

Örnekler

Etkileşimin Başlangıcı

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

Etkileşim Tamamlandı

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

Etkileşim Durumu Güncellemesi

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

İçeriğin Başlangıcı

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

İçerik Deltası

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

İçeriği Durdurma

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

Hata Etkinliği

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