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-flash

    1 milyon parçalık bağlam penceresini destekleyen ve düşünme bütçeleri olan 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 hali ile 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, en yeni ç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.

İ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 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 geçerlidir).

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ı)

Etkileşim için kullanılan araç.

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 ayrıştı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ı.

thinking_summaries ThinkingSummaries  (isteğe bağlı)

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

Olası değerler:

  • auto
  • none

type object  (zorunlu)

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

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

previous_interaction_id string  (isteğe bağlı)

Önceki etkileşimin kimliği (varsa).

response_modalities ResponseModality  (isteğe bağlı)

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

Olası değerler:

  • text
  • image
  • audio

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

Etkileşim 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-flash

    1 milyon parçalık bağlam penceresini destekleyen ve düşünme bütçeleri olan 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 hali ile 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, en yeni ç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.

İ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 Agent

Etkileşim kurulacak temsilci.

id dize  (isteğe bağlı)

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

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

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

Olası değerler:

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

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ı)

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

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

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

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

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

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ı)

Önceki etkileşimin kimliği (varsa).

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

Etkileşim için girişler (hem Model hem de Temsilci için geçerlidir).

agent_config object  (isteğe bağlı)

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

Olası Türler

Polimorfik ayrıştı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ı.

thinking_summaries ThinkingSummaries  (isteğe bağlı)

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

Olası değerler:

  • auto
  • none

type object  (zorunlu)

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

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

Ö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.

text string  (gerekli)

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ı.

url string  (isteğe bağlı)

URL.

title string  (isteğe bağlı)

URL'nin başlığı.

type string  (zorunlu)

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

Her zaman "url_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

FileCitation

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

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.

type string  (zorunlu)

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

Her zaman "file_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

PlaceCitation

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

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ı)

Yerle ilgili 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.

type string  (zorunlu)

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

Her zaman "place_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

type object  (zorunlu)

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

Her zaman "text" olarak ayarlanır.

ImageContent

Resim içerik bloğu.

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

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

Olası değerler:

  • low
  • medium
  • high
  • ultra_high

type object  (zorunlu)

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

Her zaman "image" olarak ayarlanır.

AudioContent

Sesli içerik bloğu

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
type object  (zorunlu)

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

Her zaman "audio" olarak ayarlanır.

DocumentContent

Doküman içerik bloğu.

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
type object  (zorunlu)

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

Her zaman "document" olarak ayarlanır.

VideoContent

Video içerik bloğu.

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

type object  (zorunlu)

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

Her zaman "video" olarak ayarlanır.

ThoughtContent

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

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.

text string  (gerekli)

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ı.

url string  (isteğe bağlı)

URL.

title string  (isteğe bağlı)

URL'nin başlığı.

type string  (zorunlu)

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

Her zaman "url_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

FileCitation

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

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.

type string  (zorunlu)

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

Her zaman "file_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

PlaceCitation

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

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ı)

Yerle ilgili 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.

type string  (zorunlu)

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

Her zaman "place_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

type object  (zorunlu)

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

Her zaman "text" olarak ayarlanır.

ImageContent

Resim içerik bloğu.

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

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

Olası değerler:

  • low
  • medium
  • high
  • ultra_high

type object  (zorunlu)

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

Her zaman "image" olarak ayarlanır.

type object  (zorunlu)

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

Her zaman "thought" olarak ayarlanır.

FunctionCallContent

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

name string  (zorunlu)

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

arguments object  (zorunlu)

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

type object  (zorunlu)

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

Her zaman "function_call" olarak ayarlanır.

id dize  (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.

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ığı.

result array (FunctionResultSubcontent) or string  (zorunlu)

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

type object  (zorunlu)

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

Her zaman "function_result" olarak ayarlanır.

call_id dize  (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ı.

CodeExecutionCallContent

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

arguments CodeExecutionCallArguments  (gerekli)

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.

type object  (zorunlu)

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

Her zaman "code_execution_call" olarak ayarlanır.

id dize  (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ı.

CodeExecutionResultContent

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

result dize  (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ığı.

type object  (zorunlu)

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

Her zaman "code_execution_result" olarak ayarlanır.

call_id dize  (zorunlu)

Kod yürütme çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

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

UrlContextCallContent

URL bağlam içeriği.

arguments UrlContextCallArguments  (gerekli)

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.

type object  (zorunlu)

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

Her zaman "url_context_call" olarak ayarlanır.

id dize  (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ı.

UrlContextResultContent

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

result UrlContextResult  (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ığı.

type object  (zorunlu)

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

Her zaman "url_context_result" olarak ayarlanır.

call_id dize  (zorunlu)

URL bağlamı çağrı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

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

GoogleSearchCallContent

Google Arama içeriği.

arguments GoogleSearchCallArguments  (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
type object  (zorunlu)

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

Her zaman "google_search_call" olarak ayarlanır.

id dize  (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ı.

GoogleSearchResultContent

Google arama sonucu içeriği.

result GoogleSearchResult  (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ığı.

type object  (zorunlu)

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

Her zaman "google_search_result" olarak ayarlanır.

call_id dize  (zorunlu)

Google arama çağrısı engelleme özelliğindeki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

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

McpServerToolCallContent

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

name string  (zorunlu)

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

server_name string  (zorunlu)

Kullanılan MCP sunucusunun adı.

arguments object  (zorunlu)

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

type object  (zorunlu)

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

Her zaman "mcp_server_tool_call" olarak ayarlanır.

id dize  (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ı.

McpServerToolResultContent

MCPServer aracı sonuç içeriği.

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ı.

result array (FunctionResultSubcontent) or string  (zorunlu)

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

type object  (zorunlu)

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

Her zaman "mcp_server_tool_result" olarak ayarlanır.

call_id dize  (zorunlu)

MCP sunucusu araç çağrısı blokundaki kimlikle eşleşecek kimlik.

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)

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ı.

FileSearchResultContent

Dosya arama sonucu içeriği.

result FileSearchResult  (isteğe bağlı)

Dosya Arama'nın sonuçları.

Dosya Arama'nın sonucu.

type object  (zorunlu)

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

Her zaman "file_search_result" olarak ayarlanır.

call_id dize  (zorunlu)

Dosya arama çağrısı bloğundaki kimlikle eşleşecek kimlik.

signature string  (isteğe bağlı)

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

GoogleMapsCallContent

Google Haritalar içeriği.

arguments GoogleMapsCallArguments  (isteğe bağlı)

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

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

Alanlar

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

Yürütülecek sorgular.

type object  (zorunlu)

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

Her zaman "google_maps_call" olarak ayarlanır.

id dize  (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ı.

GoogleMapsResultContent

Google Haritalar sonuç içeriği.

result GoogleMapsResult  (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ı)

Yerle ilgili 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ı.

type object  (zorunlu)

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

Her zaman "google_maps_result" olarak ayarlanır.

call_id dize  (zorunlu)

Google Haritalar görüşme engelleme özelliğindeki 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"
  }
}

İşlev Sonucu

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

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

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

Kod Yürütme Sonucu

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

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

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

URL Bağlamı Sonucu

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

Google Arama Ağı araması

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

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 Server Tool Call

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

Mcp Server Tool Result

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

Dosya Arama Çağrısı

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

Dosya Arama Sonucu

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

Google Haritalar'da görüşme

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

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ç

Olası Türler

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

İşlev

Model tarafından kullanılabilen bir araç.

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ı.

type string  (zorunlu)

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

Her zaman "function" olarak ayarlanır.

GoogleSearch

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

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

Etkinleştirilecek arama temellendirme türleri.

Olası değerler:

  • web_search
  • image_search
type string  (zorunlu)

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

Her zaman "google_search" olarak ayarlanır.

CodeExecution

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

type string  (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 string  (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ç.

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.

type string  (zorunlu)

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

Her zaman "computer_use" olarak ayarlanır.

McpServer

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

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ı.

type string  (zorunlu)

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

Her zaman "mcp_server" olarak ayarlanır.

FileSearch

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

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 anlamsal 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.

type string  (zorunlu)

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

Her zaman "file_search" olarak ayarlanır.

GoogleMaps

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

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ı.

type string  (isteğe bağlı)

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

Her zaman "google_maps" olarak ayarlanır.

Örnekler

İşlev

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

GoogleMaps

CANNOT TRANSLATE

Alanlar

role string  (isteğe bağlı)

Bu dönüşün başlatıcısı. Giriş için kullanıcı, model çıkışı için model olmalıdır.

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

Dönüşün içeriği.

Ö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

interaction Interaction  (zorunlu)

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

event_type enum (string)  (required)

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

Olası değerler:

  • interaction.start
event_id dize  (isteğe bağlı)

Bu etkinlikten itibaren etkileşim akışını devam ettirmek için kullanılacak event_id jetonu.

InteractionCompleteEvent

interaction Interaction  (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_type enum (string)  (required)

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

Olası değerler:

  • interaction.complete
event_id dize  (isteğe bağlı)

Bu etkinlikten itibaren etkileşim akışını devam ettirmek için kullanılacak event_id jetonu.

InteractionStatusUpdate

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_type dize  (zorunlu)

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

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

event_id dize  (isteğe bağlı)

Bu etkinlikten itibaren etkileşim akışını devam ettirmek için kullanılacak event_id jetonu.

ContentStart

index integer  (zorunlu)

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

content Content  (zorunlu)

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

event_type dize  (zorunlu)

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

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

event_id dize  (isteğe bağlı)

Bu etkinlikten itibaren etkileşim akışını devam ettirmek için kullanılacak event_id jetonu.

ContentDelta

index integer  (zorunlu)

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

delta object  (zorunlu)

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

Olası Türler

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

TextDelta

text string  (gerekli)

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

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ı.

url string  (isteğe bağlı)

URL.

title string  (isteğe bağlı)

URL'nin başlığı.

type string  (zorunlu)

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

Her zaman "url_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

FileCitation

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

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.

type string  (zorunlu)

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

Her zaman "file_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

PlaceCitation

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

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ı)

Yerle ilgili 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.

type string  (zorunlu)

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

Her zaman "place_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

type object  (zorunlu)

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

Her zaman "text" olarak ayarlanır.

ImageDelta

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

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

Olası değerler:

  • low
  • medium
  • high
  • ultra_high

type object  (zorunlu)

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

Her zaman "image" olarak ayarlanır.

AudioDelta

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
type object  (zorunlu)

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

Her zaman "audio" olarak ayarlanır.

DocumentDelta

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
type object  (zorunlu)

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

Her zaman "document" olarak ayarlanır.

VideoDelta

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

type object  (zorunlu)

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

Her zaman "video" olarak ayarlanır.

ThoughtSummaryDelta

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.

text string  (gerekli)

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ı.

url string  (isteğe bağlı)

URL.

title string  (isteğe bağlı)

URL'nin başlığı.

type string  (zorunlu)

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

Her zaman "url_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

FileCitation

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

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.

type string  (zorunlu)

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

Her zaman "file_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

PlaceCitation

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

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ı)

Yerle ilgili 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.

type string  (zorunlu)

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

Her zaman "place_citation" olarak ayarlanır.

start_index integer  (isteğe bağlı)

Bu kaynağa atfedilen yanıt segmentinin başlangıcı.

end_index integer  (isteğe bağlı)

Atfedilen segmentin bitişi (hariç).

type object  (zorunlu)

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

Her zaman "text" olarak ayarlanır.

ImageContent

Resim içerik bloğu.

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

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

Olası değerler:

  • low
  • medium
  • high
  • ultra_high

type object  (zorunlu)

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

Her zaman "image" olarak ayarlanır.

type object  (zorunlu)

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

Her zaman "thought_summary" olarak ayarlanır.

ThoughtSignatureDelta

signature string  (isteğe bağlı)

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

type object  (zorunlu)

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

Her zaman "thought_signature" olarak ayarlanır.

FunctionCallDelta

name string  (zorunlu)

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

arguments object  (zorunlu)

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

type object  (zorunlu)

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

Her zaman "function_call" olarak ayarlanır.

id dize  (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

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ı.

result object veya string  (zorunlu)

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

type object  (zorunlu)

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

Her zaman "function_result" olarak ayarlanır.

call_id dize  (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ı.

CodeExecutionCallDelta

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.

type object  (zorunlu)

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

Her zaman "code_execution_call" olarak ayarlanır.

id dize  (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ı.

CodeExecutionResultDelta

result dize  (zorunlu)

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

is_error boolean  (isteğe bağlı)

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

type object  (zorunlu)

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

Her zaman "code_execution_result" olarak ayarlanır.

call_id dize  (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ı.

UrlContextCallDelta

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.

type object  (zorunlu)

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

Her zaman "url_context_call" olarak ayarlanır.

id dize  (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ı.

UrlContextResultDelta

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ı.

type object  (zorunlu)

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

Her zaman "url_context_result" olarak ayarlanır.

call_id dize  (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ı.

GoogleSearchCallDelta

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ı.

type object  (zorunlu)

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

Her zaman "google_search_call" olarak ayarlanır.

id dize  (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ı.

GoogleSearchResultDelta

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ı.

type object  (zorunlu)

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

Her zaman "google_search_result" olarak ayarlanır.

call_id dize  (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ı.

McpServerToolCallDelta

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ı.

type object  (zorunlu)

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

Her zaman "mcp_server_tool_call" olarak ayarlanır.

id dize  (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ı.

McpServerToolResultDelta

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ı.

result object veya string  (zorunlu)

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

type object  (zorunlu)

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

Her zaman "mcp_server_tool_result" olarak ayarlanır.

call_id dize  (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ı.

FileSearchCallDelta

type object  (zorunlu)

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

Her zaman "file_search_call" olarak ayarlanır.

id dize  (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ı.

FileSearchResultDelta

result FileSearchResult  (isteğe bağlı)

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

Dosya Arama'nın sonucu.

type object  (zorunlu)

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

Her zaman "file_search_result" olarak ayarlanır.

call_id dize  (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ı.

GoogleMapsCallDelta

arguments GoogleMapsCallArguments  (isteğe bağlı)

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

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

Alanlar

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

Yürütülecek sorgular.

type object  (zorunlu)

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

Her zaman "google_maps_call" olarak ayarlanır.

id dize  (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ı.

GoogleMapsResultDelta

result GoogleMapsResult  (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ı)

Yerle ilgili 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ı.

type object  (zorunlu)

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

Her zaman "google_maps_result" olarak ayarlanır.

call_id dize  (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ı.

event_type dize  (zorunlu)

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

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

event_id dize  (isteğe bağlı)

Bu etkinlikten itibaren etkileşim akışını devam ettirmek için kullanılacak event_id jetonu.

ContentStop

index integer  (zorunlu)

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

event_type dize  (zorunlu)

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

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

event_id dize  (isteğe bağlı)

Bu etkinlikten itibaren etkileşim akışını devam ettirmek için kullanılacak event_id jetonu.

ErrorEvent

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_type dize  (zorunlu)

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

Her zaman "error" olarak ayarlanır.

event_id dize  (isteğe bağlı)

Bu etkinlikten itibaren etkileşim akışını devam ettirmek için kullanılacak event_id jetonu.

Örnekler

Etkileşim 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"
  }
}