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 genelleyip akıcı bir şekilde anlayabilir, birbiriyle harmanlayabilir ve tüm bu formatlar arasında işlem yapabilir. 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 ortamlarda algılama ve gezinme olanağı sağlayan bir ajan tabanlı yetenek modeli.

  • 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ı 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 Önizlemesi; 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 uygun seçenektir.

  • 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 özellikleriyle 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 stillerinde 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şime geçilecek temsilci.

input İçerik veya dizi (İçerik) ya da dizi (Adım) 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 ResponseFormat veya ResponseFormatList  (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 ServiceTier  (isteğe bağlı)

Etkileşimin hizmet katmanı.

Olası değerler:

  • flex
  • standard
  • priority

webhook_config WebhookConfig  (isteğe bağlı)

İsteğe bağlı. Etkileşim tamamlandığında bildirim almak için webhook yapılandırması.

Bir istek için webhook etkinliklerini yapılandırma mesajı.

Alanlar

uris dizi (dize)  (isteğe bağlı)

İsteğe bağlı. Ayarlanırsa bu webhook URI'leri, kayıtlı webhook'lar yerine webhook etkinlikleri için kullanılır.

user_metadata object  (isteğe bağlı)

İsteğe bağlı. Webhook'lara her etkinlik gönderiminde döndürülecek kullanıcı meta verileri.

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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?"
        }
      ]
    }
  ],
  "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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "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",
  "steps": [
    {
      "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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "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"
}

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 ortamlarda algılama ve gezinme olanağı sağlayan bir ajan tabanlı yetenek modeli.

  • 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ı 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 Önizlemesi; 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 uygun seçenektir.

  • 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 özellikleriyle 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 stillerinde 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şime geçilecek 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ü.

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

grounding_tool_count GroundingToolCount  (isteğe bağlı)

Topraklama aracı sayısı.

Topraklama aracı sayısının sayısı.

Alanlar

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

Sayımla ilişkili temellendirme aracı türü.

Olası değerler:

  • google_search
  • google_maps
  • retrieval
count integer  (isteğe bağlı)

Topraklama aracı sayısının sayısı.

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

Etkileşimin hizmet katmanı.

Olası değerler:

  • flex
  • standard
  • priority

webhook_config WebhookConfig  (isteğe bağlı)

İsteğe bağlı. Etkileşim tamamlandığında bildirim almak için webhook yapılandırması.

Bir istek için webhook etkinliklerini yapılandırma mesajı.

Alanlar

uris dizi (dize)  (isteğe bağlı)

İsteğe bağlı. Ayarlanırsa bu webhook URI'leri, kayıtlı webhook'lar yerine webhook etkinlikleri için kullanılır.

user_metadata object  (isteğe bağlı)

İsteğe bağlı. Webhook'lara her etkinlik gönderiminde döndürülecek kullanıcı meta verileri.

steps Step  (isteğe bağlı)

Yalnızca çıkış. Etkileşimi oluşturan adımlar.

Etkileşimdeki bir adım.

Olası Türler

Polimorfik ayırıcı: type

UserInputStep

Kullanıcı tarafından sağlanan giriş.

type object  (zorunlu)

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

Her zaman "user_input" olarak ayarlanır.

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

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

ModelOutputStep

Model tarafından oluşturulan çıkış.

type object  (zorunlu)

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

Her zaman "model_output" olarak ayarlanır.

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

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

ThoughtStep

Düşünme adımı.

type object  (zorunlu)

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

Her zaman "thought" olarak ayarlanır.

signature string  (isteğe bağlı)

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

summary ThoughtSummaryContent  (isteğe bağlı)

Düşüncenin özeti.

Olası Türler

Polimorfik ayı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 oluşturulan içeriklerin alıntı bilgileri.

Model tarafından oluşturulan içeriklerin alıntı bilgileri.

Olası Türler

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

custom_metadata object  (isteğe bağlı)

Alınan bağlamla ilgili kullanıcı tarafından sağlanan meta veriler.

page_number integer  (isteğe bağlı)

Alıntı yapılan belgenin sayfa numarası (varsa).

media_id dize  (isteğe bağlı)

Resim alıntıları için varsa medya 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ç).

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

FunctionCallStep

Bir işlev aracı çağrısı adımı.

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

CodeExecutionCallStep

Kod yürütme çağrısı adımı.

type object  (zorunlu)

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

Her zaman "code_execution_call" olarak ayarlanır.

arguments CodeExecutionCallStepArguments  (zorunlu)

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

UrlContextCallStep

URL bağlamı arama adımı.

type object  (zorunlu)

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

Her zaman "url_context_call" olarak ayarlanır.

arguments UrlContextCallStepArguments  (required)

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

McpServerToolCallStep

MCPServer aracı çağrı adımı.

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

GoogleSearchCallStep

Google Arama görüşmesi adımı.

type object  (zorunlu)

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

Her zaman "google_search_call" olarak ayarlanır.

arguments GoogleSearchCallStepArguments  (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ı.

FileSearchCallStep

Dosya Arama çağrı adımı.

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

GoogleMapsCallStep

Google Haritalar görüşmesi adımı.

type object  (zorunlu)

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

Her zaman "google_maps_call" olarak ayarlanır.

arguments GoogleMapsCallStepArguments  (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.

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

FunctionResultStep

Bir işlev aracı çağrısının sonucu.

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.

CodeExecutionResultStep

Kod yürütme sonucu adımı.

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

UrlContextResultStep

URL bağlamı sonuç adımı.

type object  (zorunlu)

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

Her zaman "url_context_result" olarak ayarlanır.

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

GoogleSearchResultStep

Google Arama sonucu adımı.

type object  (zorunlu)

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

Her zaman "google_search_result" olarak ayarlanır.

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

McpServerToolResultStep

MCPServer aracı sonuç adımı.

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.

FileSearchResultStep

Dosya arama sonucu adımı.

type object  (zorunlu)

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

Her zaman "file_search_result" olarak ayarlanır.

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

GoogleMapsResultStep

Google Haritalar sonucu adımı.

type object  (zorunlu)

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

Her zaman "google_maps_result" olarak ayarlanır.

result GoogleMapsResultItem  (zorunlu)

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

Google Haritalar'ın sonucu.

Alanlar

places GoogleMapsResultPlaces  (isteğe bağlı)

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

Alanlar

place_id dize  (isteğe bağlı)

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

name string  (isteğe bağlı)

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

url string  (isteğe bağlı)

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

review_snippets ReviewSnippet  (isteğe bağlı)

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

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

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

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

Etkileşimin girişi.

response_format ResponseFormat veya ResponseFormatList  (isteğe bağlı)

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

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",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?"
        }
      ]
    }
  ],
  "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 ayı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 oluşturulan içeriklerin alıntı bilgileri.

Model tarafından oluşturulan içeriklerin alıntı bilgileri.

Olası Türler

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

custom_metadata object  (isteğe bağlı)

Alınan bağlamla ilgili kullanıcı tarafından sağlanan meta veriler.

page_number integer  (isteğe bağlı)

Alıntı yapılan belgenin sayfa numarası (varsa).

media_id dize  (isteğe bağlı)

Resim alıntıları için varsa medya 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ç).

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

Ses kanallarının sayısı.

sample_rate integer  (isteğe bağlı)

Sesin örnekleme hızı.

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

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

Araç

Model tarafından kullanılabilen bir araç.

Olası Türler

Polimorfik ayı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
excluded_predefined_functions 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 yapmak 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 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.

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

InteractionSseEvent

Olası Türler

Polimorfik ayırıcı: event_type

InteractionCreatedEvent

event_type object  (zorunlu)

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

Her zaman "interaction.created" 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.

InteractionCompletedEvent

event_type object  (zorunlu)

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

Her zaman "interaction.completed" 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.

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.

StepStart

event_type object  (zorunlu)

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

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

index integer  (zorunlu)

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

step Step  (zorunlu)

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

Etkileşimdeki bir adım.

Olası Türler

Polimorfik ayırıcı: type

UserInputStep

Kullanıcı tarafından sağlanan giriş.

type object  (zorunlu)

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

Her zaman "user_input" olarak ayarlanır.

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

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

ModelOutputStep

Model tarafından oluşturulan çıkış.

type object  (zorunlu)

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

Her zaman "model_output" olarak ayarlanır.

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

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

ThoughtStep

Düşünme adımı.

type object  (zorunlu)

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

Her zaman "thought" olarak ayarlanır.

signature string  (isteğe bağlı)

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

summary ThoughtSummaryContent  (isteğe bağlı)

Düşüncenin özeti.

Olası Türler

Polimorfik ayı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 oluşturulan içeriklerin alıntı bilgileri.

Model tarafından oluşturulan içeriklerin alıntı bilgileri.

Olası Türler

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

custom_metadata object  (isteğe bağlı)

Alınan bağlamla ilgili kullanıcı tarafından sağlanan meta veriler.

page_number integer  (isteğe bağlı)

Alıntı yapılan belgenin sayfa numarası (varsa).

media_id dize  (isteğe bağlı)

Resim alıntıları için varsa medya 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ç).

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

FunctionCallStep

Bir işlev aracı çağrısı adımı.

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

CodeExecutionCallStep

Kod yürütme çağrısı adımı.

type object  (zorunlu)

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

Her zaman "code_execution_call" olarak ayarlanır.

arguments CodeExecutionCallStepArguments  (zorunlu)

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

UrlContextCallStep

URL bağlamı arama adımı.

type object  (zorunlu)

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

Her zaman "url_context_call" olarak ayarlanır.

arguments UrlContextCallStepArguments  (required)

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

McpServerToolCallStep

MCPServer aracı çağrı adımı.

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

GoogleSearchCallStep

Google Arama görüşmesi adımı.

type object  (zorunlu)

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

Her zaman "google_search_call" olarak ayarlanır.

arguments GoogleSearchCallStepArguments  (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ı.

FileSearchCallStep

Dosya Arama çağrı adımı.

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

GoogleMapsCallStep

Google Haritalar görüşmesi adımı.

type object  (zorunlu)

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

Her zaman "google_maps_call" olarak ayarlanır.

arguments GoogleMapsCallStepArguments  (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.

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

FunctionResultStep

Bir işlev aracı çağrısının sonucu.

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.

CodeExecutionResultStep

Kod yürütme sonucu adımı.

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

UrlContextResultStep

URL bağlamı sonuç adımı.

type object  (zorunlu)

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

Her zaman "url_context_result" olarak ayarlanır.

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

GoogleSearchResultStep

Google Arama sonucu adımı.

type object  (zorunlu)

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

Her zaman "google_search_result" olarak ayarlanır.

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

McpServerToolResultStep

MCPServer aracı sonuç adımı.

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.

FileSearchResultStep

Dosya arama sonucu adımı.

type object  (zorunlu)

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

Her zaman "file_search_result" olarak ayarlanır.

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

GoogleMapsResultStep

Google Haritalar sonucu adımı.

type object  (zorunlu)

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

Her zaman "google_maps_result" olarak ayarlanır.

result GoogleMapsResultItem  (zorunlu)

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

Google Haritalar'ın sonucu.

Alanlar

places GoogleMapsResultPlaces  (isteğe bağlı)

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

Alanlar

place_id dize  (isteğe bağlı)

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

name string  (isteğe bağlı)

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

url string  (isteğe bağlı)

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

review_snippets ReviewSnippet  (isteğe bağlı)

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

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

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

event_id dize  (isteğe bağlı)

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

StepDelta

event_type object  (zorunlu)

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

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

index integer  (zorunlu)

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

delta StepDeltaData  (zorunlu)

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

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

Kullanımdan kaldırıldı. Bunun yerine sample_rate kullanın. Değer yok sayılır.

sample_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 ayı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 oluşturulan içeriklerin alıntı bilgileri.

Model tarafından oluşturulan içeriklerin alıntı bilgileri.

Olası Türler

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

custom_metadata object  (isteğe bağlı)

Alınan bağlamla ilgili kullanıcı tarafından sağlanan meta veriler.

page_number integer  (isteğe bağlı)

Alıntı yapılan belgenin sayfa numarası (varsa).

media_id dize  (isteğe bağlı)

Resim alıntıları için varsa medya 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ç).

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.

TextAnnotationDelta

type object  (zorunlu)

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

Her zaman "text_annotation_delta" olarak ayarlanır.

annotations Annotation  (isteğe bağlı)

Model tarafından oluşturulan içeriklerin alıntı bilgileri.

Model tarafından oluşturulan içeriklerin alıntı bilgileri.

Olası Türler

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

custom_metadata object  (isteğe bağlı)

Alınan bağlamla ilgili kullanıcı tarafından sağlanan meta veriler.

page_number integer  (isteğe bağlı)

Alıntı yapılan belgenin sayfa numarası (varsa).

media_id dize  (isteğe bağlı)

Resim alıntıları için varsa medya 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ç).

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ç).

ArgumentsDelta

type object  (zorunlu)

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

Her zaman "arguments_delta" olarak ayarlanır.

partial_arguments dize  (isteğe bağlı)

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.

StepStop

event_type object  (zorunlu)

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

Her zaman "step.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.

Örnekler

Etkileşim Oluşturuldu

{
  "event_type": "interaction.created",
  "interaction": {
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3-flash-preview",
    "status": "in_progress",
    "created": "2025-12-04T15:01:45Z",
    "updated": "2025-12-04T15:01:45Z"
  },
  "event_id": "evt_123"
}

Etkileşim Tamamlandı

{
  "event_type": "interaction.completed",
  "interaction": {
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3-flash-preview",
    "status": "completed",
    "created": "2025-12-04T15:01:45Z",
    "updated": "2025-12-04T15:01:45Z"
  },
  "event_id": "evt_123"
}

Etkileşim Durumu Güncellemesi

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

Hata Etkinliği

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

Adımı Başlat

{
  "event_type": "step.start",
  "index": 0,
  "step": {
    "type": "model_output"
  }
}

Adım Delta

{
  "event_type": "step.delta",
  "index": 0,
  "delta": {
    "type": "text",
    "text": "Hello"
  }
}

Step Stop

{
  "event_type": "step.stop",
  "index": 0
}