Gemini API

Gemini Interactions API は、デベロッパーが Gemini モデルを使用して生成 AI アプリケーションを構築できる試験運用版の API です。Gemini は、マルチモーダルに対応するように一から構築された、Google の最も高性能なモデルです。言語、画像、音声、動画、コードなど、さまざまな種類の情報を一般化してシームレスに理解し、操作し、組み合わせることができます。Gemini API は、テキストと画像を横断した推論、コンテンツ生成、対話エージェント、要約システム、分類システムなどのユースケースで使用できます。

マークダウンとして表示 OpenAPI 仕様を表示する

インタラクションの作成

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

新しいインタラクションを作成します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

model ModelOption  （省略可）

インタラクションの生成に使用される `Model` の名前。
`agent` が指定されていない場合は必須。

有効な値:

  • gemini-2.5-flash

    100 万トークンのコンテキスト ウィンドウをサポートし、思考予算を備えた初のハイブリッド推論モデル。

  • gemini-2.5-flash-image

    速度、柔軟性、コンテキスト理解に最適化された Google のネイティブ画像生成モデル。テキストの入力と出力の料金は、2.5 Flash と同じです。

  • gemini-2.5-flash-lite

    最も小型で費用対効果の高いモデル。大規模な使用向けに構築されています。

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

    費用対効果、高スループット、高品質を重視して最適化された Gemini 2.5 Flash Lite に基づく最新モデル。

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

    Google のネイティブ音声モデルは、より高品質な音声出力に最適化されており、話し方のペースや自然さ、詳細度、ムードをより適切に表現できます。

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

    2.5 Flash モデルに基づく最新モデル。2.5 Flash Preview は、思考を必要とする大規模な処理、低レイテンシ、大容量のタスク、エージェントのユースケースに最適です。

  • gemini-2.5-flash-preview-tts

    強力で低レイテンシの制御可能な音声生成向けに最適化された 2.5 Flash Text-to-Speech モデル。

  • gemini-2.5-pro

    コーディングや複雑な推論タスクに優れた、最先端の多目的モデル。

  • gemini-2.5-pro-preview-tts

    Google の 2.5 Pro テキスト音声変換モデルは、強力で低レイテンシの音声生成に最適化されており、より自然な出力を実現し、プロンプトを簡単に操作できます。

  • gemini-3-flash-preview

    スピードを重視して構築された Google の最もインテリジェントなモデル。最先端のインテリジェンスと優れた検索機能およびグラウンディング機能を組み合わせたものです。

  • gemini-3-pro-image-preview

    画像の生成と編集のための最先端モデル。

  • gemini-3-pro-preview

    最先端の推論とマルチモーダル理解を備え、強力なエージェント機能とバイブ コーディング機能を備えた、Google の最もインテリジェントなモデルです。

  • gemini-3.1-pro-preview

    前例のない深さとニュアンスを備えた、強力なマルチモーダル理解とコーディング機能を備えた、最新の SOTA 推論モデル。

  • gemini-3.1-flash-image-preview

    Flash の速度と効率性、現実に基づいた生成機能を備えた、プロレベルのビジュアル インテリジェンス。

プロンプトを完成させるモデル。\n\n 詳細については、[モデル](https://ai.google.dev/gemini-api/docs/models) をご覧ください。

agent AgentOption  （省略可）

インタラクションの生成に使用される `Agent` の名前。
`model` が指定されていない場合は必須。

有効な値:

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

    Gemini Deep Research エージェント

やり取りするエージェント。

input Content または配列（Content）または配列（Turn）または文字列  （必須）

インタラクションの入力（モデルとエージェントの両方に共通）。

system_instruction 文字列  （省略可）

インタラクションのシステム指示。

tools 配列（Tool）  （省略可）

モデルがインタラクション中に呼び出す可能性のあるツール宣言のリスト。

response_format オブジェクト  （省略可）

生成されたレスポンスが、このフィールドで指定された JSON スキーマに準拠した JSON オブジェクトであることを強制します。

response_mime_type 文字列  （省略可）

レスポンスの MIME タイプ。response_format が設定されている場合は必須です。

stream boolean  （省略可）

入力専用。インタラクションがストリーミングされるかどうか。

store boolean  （省略可）

入力専用。後で取得するためにレスポンスとリクエストを保存するかどうか。

background boolean  （省略可）

入力専用。モデルのやり取りをバックグラウンドで実行するかどうか。

generation_config GenerationConfig  （省略可）

モデル構成
モデルのインタラクションの構成パラメータ。
`agent_config` の代替。`model` が設定されている場合にのみ適用されます。

モデル インタラクションの構成パラメータ。

フィールド

temperature number  （省略可）

出力のランダム性を制御します。

top_p number  （省略可）

サンプリング時に考慮するトークンの累積確率の最大値。

seed 整数  （省略可）

再現性のためにデコードで使用されるシード。

stop_sequences 配列（文字列）  （省略可）

出力インタラクションを停止する文字シーケンスのリスト。

thinking_level ThinkingLevel  （省略可）

モデルが生成する思考トークンのレベル。

有効な値:

  • minimal
  • low
  • medium
  • high

thinking_summaries ThinkingSummaries  （省略可）

レスポンスに思考の要約を含めるかどうか。

有効な値:

  • auto
  • none

max_output_tokens integer  （省略可）

レスポンスに含めるトークンの最大数。

speech_config SpeechConfig  （省略可）

音声インタラクションの構成。

音声インタラクションの構成。

フィールド

voice string  （省略可）

話者の声。

language 文字列  （省略可）

音声の言語。

speaker string  （省略可）

話者の名前。プロンプトで指定された話者の名前と一致している必要があります。

image_config ImageConfig  （省略可）

画像インタラクションの構成。

画像インタラクションの構成。

フィールド

aspect_ratio 列挙型（文字列）  （省略可）

説明が入力されていません。

有効な値:

  • 1:1
  • 2:3
  • 3:2
  • 3:4
  • 4:3
  • 4:5
  • 5:4
  • 9:16
  • 16:9
  • 21:9
  • 1:8
  • 8:1
  • 1:4
  • 4:1
image_size 列挙型（文字列）  （省略可）

説明が入力されていません。

有効な値:

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig または ToolChoiceType  （省略可）

やり取りに使用するツール。

agent_config オブジェクト  （省略可）

エージェントの構成
エージェントの構成。
`generation_config` の代替。`agent` が設定されている場合にのみ適用されます。

可能なタイプ

ポリモーフィック ディスクリミネータ: type

DynamicAgentConfig

動的エージェントの構成。

type object  （必須）

説明が入力されていません。

常に "dynamic" に設定。

DeepResearchAgentConfig

Deep Research エージェントの構成。

thinking_summaries ThinkingSummaries  （省略可）

レスポンスに思考の要約を含めるかどうか。

有効な値:

  • auto
  • none

type object  （必須）

説明が入力されていません。

常に "deep-research" に設定。

previous_interaction_id string  （省略可）

以前のインタラクションの ID（存在する場合）。

response_modalities ResponseModality  （省略可）

リクエストされたレスポンスのモダリティ（TEXT、IMAGE、AUDIO）。

有効な値:

  • text
  • image
  • audio

レスポンス

Interaction リソースを返します。

シンプルなリクエスト

返信の例

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-11-26T12:25:15Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 20,
    "total_thought_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

マルチターン

返信の例

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "The capital of France is Paris."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 50
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 50,
    "total_output_tokens": 10,
    "total_thought_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

画像入力

返信の例

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 10
      },
      {
        "modality": "image",
        "tokens": 258
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 268,
    "total_output_tokens": 20,
    "total_thought_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

関数呼び出し

返信の例

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "id": "gth23981",
      "name": "get_weather",
      "arguments": {
        "location": "Boston, MA"
      }
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 100
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 100,
    "total_output_tokens": 25,
    "total_thought_tokens": 0,
    "total_tokens": 125,
    "total_tool_use_tokens": 50
  }
}

Deep Research

返信の例

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "agent",
  "outputs": [
    {
      "type": "text",
      "text": "Here is a comprehensive research report on the current state of cancer research..."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 20
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 20,
    "total_output_tokens": 1000,
    "total_thought_tokens": 500,
    "total_tokens": 1520,
    "total_tool_use_tokens": 0
  }
}

インタラクションの取得

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

`Interaction.id` に基づいて、単一のインタラクションの完全な詳細を取得します。

パス / クエリ パラメータ

id 文字列  （必須）

取得するインタラクションの一意の識別子。

stream boolean  （省略可）

true に設定すると、生成されたコンテンツが段階的にストリーミングされます。

デフォルト設定: False

last_event_id 文字列  （省略可）

省略可。設定されている場合、イベント ID でマークされたイベントの次のチャンクからインタラクション ストリームを再開します。`stream` が true の場合にのみ使用できます。

include_input ブール値  （省略可）

true に設定すると、入力がレスポンスに含まれます。

デフォルト設定: False

api_version 文字列  （省略可）

使用する API のバージョン。

レスポンス

Interaction リソースを返します。

インタラクションを取得

返信の例

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "I'm doing great, thank you for asking! How can I help you today?"
    }
  ]
}

インタラクションの削除

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

ID でインタラクションを削除します。

パス / クエリ パラメータ

id 文字列  （必須）

削除するインタラクションの一意の識別子。

api_version 文字列  （省略可）

使用する API のバージョン。

レスポンス

成功すると、レスポンスは空になります。

インタラクションを削除

インタラクションのキャンセル

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

ID でインタラクションをキャンセルします。これは、実行中のバックグラウンド インタラクションにのみ適用されます。

パス / クエリ パラメータ

id 文字列  （必須）

キャンセルするインタラクションの一意の識別子。

api_version 文字列  （省略可）

使用する API のバージョン。

レスポンス

Interaction リソースを返します。

インタラクションのキャンセル

返信の例

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "cancelled",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "agent"
}

リソース

インタラクション

Interaction リソース。

フィールド

model ModelOption  （省略可）

インタラクションの生成に使用される `Model` の名前。

有効な値:

  • gemini-2.5-flash

    100 万トークンのコンテキスト ウィンドウをサポートし、思考予算を備えた初のハイブリッド推論モデル。

  • gemini-2.5-flash-image

    速度、柔軟性、コンテキスト理解に最適化された Google のネイティブ画像生成モデル。テキストの入力と出力の料金は、2.5 Flash と同じです。

  • gemini-2.5-flash-lite

    最も小型で費用対効果の高いモデル。大規模な使用向けに構築されています。

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

    費用対効果、高スループット、高品質を重視して最適化された Gemini 2.5 Flash Lite に基づく最新モデル。

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

    Google のネイティブ音声モデルは、より高品質な音声出力に最適化されており、話し方のペースや自然さ、詳細度、ムードをより適切に表現できます。

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

    2.5 Flash モデルに基づく最新モデル。2.5 Flash Preview は、思考を必要とする大規模な処理、低レイテンシ、大容量のタスク、エージェントのユースケースに最適です。

  • gemini-2.5-flash-preview-tts

    強力で低レイテンシの制御可能な音声生成向けに最適化された 2.5 Flash Text-to-Speech モデル。

  • gemini-2.5-pro

    コーディングや複雑な推論タスクに優れた、最先端の多目的モデル。

  • gemini-2.5-pro-preview-tts

    Google の 2.5 Pro テキスト音声変換モデルは、強力で低レイテンシの音声生成に最適化されており、より自然な出力を実現し、プロンプトを簡単に操作できます。

  • gemini-3-flash-preview

    スピードを重視して構築された Google の最もインテリジェントなモデル。最先端のインテリジェンスと優れた検索機能およびグラウンディング機能を組み合わせたものです。

  • gemini-3-pro-image-preview

    画像の生成と編集のための最先端モデル。

  • gemini-3-pro-preview

    最先端の推論とマルチモーダル理解を備え、強力なエージェント機能とバイブ コーディング機能を備えた、Google の最もインテリジェントなモデルです。

  • gemini-3.1-pro-preview

    前例のない深さとニュアンスを備えた、強力なマルチモーダル理解とコーディング機能を備えた、最新の SOTA 推論モデル。

  • gemini-3.1-flash-image-preview

    Flash の速度と効率性、現実に基づいた生成機能を備えた、プロレベルのビジュアル インテリジェンス。

プロンプトを完成させるモデル。\n\n 詳細については、[モデル](https://ai.google.dev/gemini-api/docs/models) をご覧ください。

agent AgentOption  （省略可）

インタラクションの生成に使用される `Agent` の名前。

有効な値:

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

    Gemini Deep Research エージェント

やり取りするエージェント。

id 文字列  （省略可）

出力専用。インタラクション完了の一意の識別子。

status 列挙型（文字列）  （省略可）

出力専用。インタラクションのステータス。

有効な値:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created 文字列  （省略可）

出力専用。レスポンスが作成された時刻（ISO 8601 形式（YYYY-MM-DDThh:mm:ssZ））。

updated 文字列  （省略可）

出力専用。レスポンスが最後に更新された日時（ISO 8601 形式（YYYY-MM-DDThh:mm:ssZ））。

role 文字列  （省略可）

出力専用。インタラクションの役割。

outputs 配列（Content）  （省略可）

出力専用。モデルからのレスポンス。

system_instruction 文字列  （省略可）

インタラクションのシステム指示。

tools 配列（Tool）  （省略可）

モデルがインタラクション中に呼び出す可能性のあるツール宣言のリスト。

usage Usage  （省略可）

出力専用。インタラクション リクエストのトークン使用量に関する統計情報。

インタラクション リクエストのトークン使用量に関する統計情報。

フィールド

total_input_tokens integer  （省略可）

プロンプト（コンテキスト）内のトークン数。

input_tokens_by_modality ModalityTokens  (省略可)

入力トークンの使用状況をモダリティ別に分類した内訳。

単一のレスポンス モダリティのトークン数。

フィールド

modality ResponseModality  （省略可）

トークン数に関連付けられたモダリティ。

有効な値:

  • text
  • image
  • audio

トークン 整数  （省略可）

モダリティのトークン数。

total_cached_tokens integer  （省略可）

プロンプトのキャッシュに保存された部分（キャッシュに保存されたコンテンツ）のトークン数。

cached_tokens_by_modality ModalityTokens  （省略可）

モダリティ別のキャッシュ保存されたトークンの使用状況の内訳。

単一のレスポンス モダリティのトークン数。

フィールド

modality ResponseModality  （省略可）

トークン数に関連付けられたモダリティ。

有効な値:

  • text
  • image
  • audio

トークン 整数  （省略可）

モダリティのトークン数。

total_output_tokens integer  （省略可）

生成されたすべてのレスポンスのトークンの合計数。

output_tokens_by_modality ModalityTokens  （省略可）

出力トークンの使用状況をモダリティ別に分類した内訳。

単一のレスポンス モダリティのトークン数。

フィールド

modality ResponseModality  （省略可）

トークン数に関連付けられたモダリティ。

有効な値:

  • text
  • image
  • audio

トークン 整数  （省略可）

モダリティのトークン数。

total_tool_use_tokens integer  （省略可）

ツール使用プロンプト内のトークン数。

tool_use_tokens_by_modality ModalityTokens  （省略可）

モダリティ別のツール使用トークンの使用状況の内訳。

単一のレスポンス モダリティのトークン数。

フィールド

modality ResponseModality  （省略可）

トークン数に関連付けられたモダリティ。

有効な値:

  • text
  • image
  • audio

トークン 整数  （省略可）

モダリティのトークン数。

total_thought_tokens 整数  （省略可）

思考モデルの思考トークンの数。

total_tokens integer  （省略可）

インタラクション リクエストのトークンの合計数（プロンプト + レスポンス + その他の内部トークン）。

response_modalities ResponseModality  （省略可）

リクエストされたレスポンスのモダリティ（TEXT、IMAGE、AUDIO）。

有効な値:

  • text
  • image
  • audio

response_format オブジェクト  （省略可）

生成されたレスポンスが、このフィールドで指定された JSON スキーマに準拠した JSON オブジェクトであることを強制します。

response_mime_type 文字列  （省略可）

レスポンスの MIME タイプ。response_format が設定されている場合は必須です。

previous_interaction_id string  （省略可）

以前のインタラクションの ID（存在する場合）。

input Content または配列（Content）または配列（Turn）または文字列  （必須）

インタラクションの入力（モデルとエージェントの両方に共通）。

agent_config object  （省略可）

エージェントのインタラクションの構成パラメータ。

可能なタイプ

ポリモーフィック ディスクリミネータ: type

DynamicAgentConfig

動的エージェントの構成。

type object  （必須）

説明が入力されていません。

常に "dynamic" に設定。

DeepResearchAgentConfig

Deep Research エージェントの構成。

thinking_summaries ThinkingSummaries  （省略可）

レスポンスに思考の要約を含めるかどうか。

有効な値:

  • auto
  • none

type object  （必須）

説明が入力されていません。

常に "deep-research" に設定。

例

例

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-12-04T15:01:45Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 23,
    "total_thought_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

データモデル

コンテンツ

レスポンスの内容。

可能なタイプ

ポリモーフィック ディスクリミネータ: type

TextContent

テキスト コンテンツ ブロック。

text 文字列  （必須）

テキスト コンテンツ。

annotations Annotation  （省略可）

モデル生成コンテンツの引用情報。

モデル生成コンテンツの引用情報。

可能なタイプ

ポリモーフィック ディスクリミネータ: type

UrlCitation

URL 引用アノテーション。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

type string  （必須）

説明が入力されていません。

常に "url_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

FileCitation

ファイル引用アノテーション。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

テキストの一部に帰属するソース。

type string  （必須）

説明が入力されていません。

常に "file_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

PlaceCitation

場所の引用アノテーション。

place_id 文字列  （省略可）

場所の ID。`places/{place_id}` 形式です。

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。

Google マップの特定の場所の機能に関する質問に回答するユーザー レビューのスニペットをカプセル化します。

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

Google マップのユーザー レビューに対応するリンク。

review_id 文字列  （省略可）

レビュー スニペットの ID。

type string  （必須）

説明が入力されていません。

常に "place_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

type object  （必須）

説明が入力されていません。

常に "text" に設定。

ImageContent

画像コンテンツ ブロック。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

mime_type 列挙型（文字列）  （省略可）

画像の MIME タイプ。

有効な値:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  （省略可）

メディアの解像度。

有効な値:

  • low
  • medium
  • high
  • ultra_high

type object  （必須）

説明が入力されていません。

常に "image" に設定。

AudioContent

音声コンテンツ ブロック。

data 文字列  （省略可）

音声コンテンツ。

uri string  （省略可）

音声の URI。

mime_type 列挙型（文字列）  （省略可）

音声の MIME タイプ。

有効な値:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  （必須）

説明が入力されていません。

常に "audio" に設定。

DocumentContent

ドキュメントのコンテンツ ブロック。

data 文字列  （省略可）

ドキュメントのコンテンツ。

uri string  （省略可）

ドキュメントの URI。

mime_type 列挙型（文字列）  （省略可）

ドキュメントの MIME タイプ。

有効な値:

  • application/pdf
type object  （必須）

説明が入力されていません。

常に "document" に設定。

VideoContent

動画コンテンツ ブロック。

data 文字列  （省略可）

動画コンテンツ。

uri string  （省略可）

動画の URI。

mime_type 列挙型（文字列）  （省略可）

動画の MIME タイプ。

有効な値:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  （省略可）

メディアの解像度。

有効な値:

  • low
  • medium
  • high
  • ultra_high

type object  （必須）

説明が入力されていません。

常に "video" に設定。

ThoughtContent

思考コンテンツ ブロック。

signature string  （省略可）

生成の一部となるバックエンド ソースと一致するシグネチャ。

summary ThoughtSummaryContent  （省略可）

考えの要約。

可能なタイプ

ポリモーフィック ディスクリミネータ: type

TextContent

テキスト コンテンツ ブロック。

text 文字列  （必須）

テキスト コンテンツ。

annotations Annotation  （省略可）

モデル生成コンテンツの引用情報。

モデル生成コンテンツの引用情報。

可能なタイプ

ポリモーフィック ディスクリミネータ: type

UrlCitation

URL 引用アノテーション。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

type string  （必須）

説明が入力されていません。

常に "url_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

FileCitation

ファイル引用アノテーション。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

テキストの一部に帰属するソース。

type string  （必須）

説明が入力されていません。

常に "file_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

PlaceCitation

場所の引用アノテーション。

place_id 文字列  （省略可）

場所の ID。`places/{place_id}` 形式です。

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。

Google マップの特定の場所の機能に関する質問に回答するユーザー レビューのスニペットをカプセル化します。

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

Google マップのユーザー レビューに対応するリンク。

review_id 文字列  （省略可）

レビュー スニペットの ID。

type string  （必須）

説明が入力されていません。

常に "place_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

type object  （必須）

説明が入力されていません。

常に "text" に設定。

ImageContent

画像コンテンツ ブロック。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

mime_type 列挙型（文字列）  （省略可）

画像の MIME タイプ。

有効な値:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  （省略可）

メディアの解像度。

有効な値:

  • low
  • medium
  • high
  • ultra_high

type object  （必須）

説明が入力されていません。

常に "image" に設定。

type object  （必須）

説明が入力されていません。

常に "thought" に設定。

FunctionCallContent

関数ツール呼び出しのコンテンツ ブロック。

name string  （必須）

呼び出すツールの名前。

引数 オブジェクト  （必須）

関数に渡す引数。

type object  （必須）

説明が入力されていません。

常に "function_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

FunctionResultContent

関数ツールの結果コンテンツ ブロック。

name string  （省略可）

呼び出されたツールの名前。

is_error ブール値  （省略可）

ツール呼び出しでエラーが発生したかどうか。

result array (FunctionResultSubcontent) または string  （必須）

ツール呼び出しの結果。

type object  （必須）

説明が入力されていません。

常に "function_result" に設定。

call_id string  （必須）

関数呼び出しブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

CodeExecutionCallContent

コード実行コンテンツ。

arguments CodeExecutionCallArguments  （必須）

コード実行に渡す引数。

コード実行に渡す引数。

フィールド

language enum（文字列）  （省略可）

`code` のプログラミング言語。

有効な値:

  • python
code 文字列  （省略可）

実行されるコード。

type object  （必須）

説明が入力されていません。

常に "code_execution_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

CodeExecutionResultContent

コード実行結果のコンテンツ。

result string  （必須）

コード実行の出力。

is_error ブール値  （省略可）

コード実行でエラーが発生したかどうか。

type object  （必須）

説明が入力されていません。

常に "code_execution_result" に設定。

call_id string  （必須）

コード実行呼び出しブロックの ID と一致させる ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

UrlContextCallContent

URL コンテキストのコンテンツ。

arguments UrlContextCallArguments  （必須）

URL コンテキストに渡す引数。

URL コンテキストに渡す引数。

フィールド

urls 配列（文字列）  （省略可）

取得する URL。

type object  （必須）

説明が入力されていません。

常に "url_context_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

UrlContextResultContent

URL コンテキストの結果コンテンツ。

result UrlContextResult  （必須）

URL コンテキストの結果。

URL コンテキストの結果。

フィールド

url 文字列  （省略可）

取得された URL。

status 列挙型（文字列）  （省略可）

URL 取得のステータス。

有効な値:

  • success
  • error
  • paywall
  • unsafe
is_error ブール値  （省略可）

URL コンテキストでエラーが発生したかどうか。

type object  （必須）

説明が入力されていません。

常に "url_context_result" に設定。

call_id string  （必須）

URL コンテキスト呼び出しブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

GoogleSearchCallContent

Google 検索のコンテンツ。

引数 GoogleSearchCallArguments  （必須）

Google 検索に渡す引数。

Google 検索に渡す引数。

フィールド

queries 配列（文字列）  （省略可）

ウェブ検索のフォローアップ用のウェブ検索クエリ。

search_type enum（文字列）  （省略可）

有効になっている検索グラウンディングのタイプ。

有効な値:

  • web_search
  • image_search
type object  （必須）

説明が入力されていません。

常に "google_search_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

GoogleSearchResultContent

Google 検索結果のコンテンツ。

result GoogleSearchResult  （必須）

Google 検索の結果。

Google 検索の結果。

フィールド

search_suggestions 文字列  （省略可）

ウェブページまたはアプリのウェブビューに埋め込むことができるウェブ コンテンツ スニペット。

is_error ブール値  （省略可）

Google 検索でエラーが発生したかどうか。

type object  （必須）

説明が入力されていません。

常に "google_search_result" に設定。

call_id string  （必須）

Google 検索呼び出しブロックの ID と一致させる ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

McpServerToolCallContent

MCPServer ツール呼び出しのコンテンツ。

name string  （必須）

呼び出されたツールの名前。

server_name string  （必須）

使用された MCP サーバーの名前。

引数 オブジェクト  （必須）

関数の引数の JSON オブジェクト。

type object  （必須）

説明が入力されていません。

常に "mcp_server_tool_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

McpServerToolResultContent

MCPServer ツールの結果コンテンツ。

name string  （省略可）

この特定のツール呼び出しで呼び出されるツールの名前。

server_name 文字列  （省略可）

使用された MCP サーバーの名前。

result array (FunctionResultSubcontent) または string  （必須）

MCP サーバー呼び出しからの出力。シンプルなテキストまたはリッチ コンテンツにできます。

type object  （必須）

説明が入力されていません。

常に "mcp_server_tool_result" に設定。

call_id string  （必須）

MCP サーバー ツール呼び出しブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

FileSearchCallContent

ファイル検索のコンテンツ。

type object  （必須）

説明が入力されていません。

常に "file_search_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

FileSearchResultContent

ファイル検索結果のコンテンツ。

result FileSearchResult  （省略可）

ファイル検索の結果。

ファイル検索の結果。

type object  （必須）

説明が入力されていません。

常に "file_search_result" に設定。

call_id string  （必須）

ファイル検索呼び出しブロックの ID と一致させる ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

GoogleMapsCallContent

Google マップのコンテンツ。

arguments GoogleMapsCallArguments  (省略可)

Google マップツールに渡す引数。

Google マップツールに渡す引数。

フィールド

queries 配列（文字列）  （省略可）

実行するクエリ。

type object  （必須）

説明が入力されていません。

常に "google_maps_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

GoogleMapsResultContent

Google マップの結果コンテンツ。

result GoogleMapsResult  （必須）

Google マップの検索結果。

Google マップの結果。

フィールド

places Places  （省略可）

見つかった場所。

フィールド

place_id 文字列  （省略可）

場所の ID。`places/{place_id}` 形式です。

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。

Google マップの特定の場所の機能に関する質問に回答するユーザー レビューのスニペットをカプセル化します。

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

Google マップのユーザー レビューに対応するリンク。

review_id 文字列  （省略可）

レビュー スニペットの ID。

widget_context_token string  （省略可）

Google マップ ウィジェット コンテキスト トークンのリソース名。

type object  （必須）

説明が入力されていません。

常に "google_maps_result" に設定。

call_id string  （必須）

Google マップのコールブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

例

テキスト

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

画像

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

音声

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

ドキュメント

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

動画

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

思考

{
  "type": "thought",
  "summary": [
    {
      "type": "text",
      "text": "The user is asking about the weather. I should use the get_weather tool."
    }
  ],
  "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh"
}

関数呼び出し

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

関数の結果

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

コード実行の呼び出し

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

コード実行結果

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

URL コンテキストの呼び出し

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

Url Context Result

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

Google 検索通話

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

Google 検索結果

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

Mcp Server Tool Call

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

Mcp サーバー ツールの結果

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

ファイル検索呼び出し

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

ファイル検索の結果

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

Google マップ通話

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

Google マップの検索結果

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

ツール

可能なタイプ

ポリモーフィック ディスクリミネータ: type

関数

モデルで使用できるツール。

name string  （省略可）

関数名。

説明 文字列  （省略可）

関数の説明。

parameters object  （省略可）

関数のパラメータの JSON スキーマ。

type string  （必須）

説明が入力されていません。

常に "function" に設定。

GoogleSearch

モデルが Google を検索するために使用できるツール。

search_types 配列（列挙型（文字列））  （省略可）

有効にする検索グラウンディングのタイプ。

有効な値:

  • web_search
  • image_search
type string  （必須）

説明が入力されていません。

常に "google_search" に設定。

CodeExecution

モデルがコードを実行するために使用できるツール。

type string  （必須）

説明が入力されていません。

常に "code_execution" に設定。

UrlContext

モデルが URL コンテキストを取得するために使用できるツール。

type string  （必須）

説明が入力されていません。

常に "url_context" に設定。

ComputerUse

モデルがコンピュータとやり取りするために使用できるツール。

environment enum（文字列）  （省略可）

運用中の環境。

有効な値:

  • browser
excludedPredefinedFunctions 配列（文字列）  （省略可）

モデル呼び出しから除外される事前定義関数のリスト。

type string  （必須）

説明が入力されていません。

常に "computer_use" に設定。

McpServer

MCPServer は、モデルから呼び出してアクションを実行できるサーバーです。

name string  （省略可）

MCPServer の名前。

url 文字列  （省略可）

MCPServer エンドポイントの完全な URL。例: "https://api.example.com/mcp"

headers object  （省略可）

省略可: 認証ヘッダー、タイムアウトなどのフィールド（必要な場合）。

allowed_tools AllowedTools  （省略可）

許可されているツール。

許可されたツールの構成。

フィールド

mode ToolChoiceType  （省略可）

ツール選択のモード。

有効な値:

  • auto
  • any
  • none
  • validated

tools 配列（文字列）  （省略可）

許可されたツールの名前。

type string  （必須）

説明が入力されていません。

常に "mcp_server" に設定。

FileSearch

モデルがファイルの検索に使用できるツール。

file_search_store_names 配列（文字列）  （省略可）

検索するファイル検索ストアの名前。

top_k 整数  （省略可）

取得するセマンティック検索チャンクの数。

metadata_filter 文字列  （省略可）

セマンティック検索のドキュメントとチャンクに適用するメタデータ フィルタ。

type string  （必須）

説明が入力されていません。

常に "file_search" に設定。

GoogleMaps

モデルが Google マップを呼び出すために使用できるツール。

enable_widget ブール値  （省略可）

レスポンスのツール呼び出し結果でウィジェット コンテキスト トークンを返すかどうか。

latitude number  （省略可）

ユーザーの現在地の緯度。

longitude number  （省略可）

ユーザーの現在地の経度。

type string  （省略可）

説明が入力されていません。

常に "google_maps" に設定。

例

関数

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

GoogleMaps

CANNOT TRANSLATE

フィールド

role 文字列  （省略可）

このターンの発信者。入力の場合は user、モデル出力の場合は model である必要があります。

content 配列（Content）または文字列  （省略可）

ターンの内容。

例

ユーザーのターン

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

モデルの回転

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

InteractionSseEvent

可能なタイプ

ポリモーフィック ディスクリミネータ: event_type

InteractionStartEvent

interaction インタラクション  （必須）

説明が入力されていません。

event_type enum（文字列）  （必須）

説明が入力されていません。

有効な値:

  • interaction.start
event_id 文字列  （省略可）

このイベントからインタラクション ストリームを再開するために使用される event_id トークン。

InteractionCompleteEvent

interaction インタラクション  （必須）

ペイロード サイズを小さくするために、出力が空の完了したインタラクション。実際の出力には、上記の ContentDelta イベントを使用します。

event_type enum（文字列）  （必須）

説明が入力されていません。

有効な値:

  • interaction.complete
event_id 文字列  （省略可）

このイベントからインタラクション ストリームを再開するために使用される event_id トークン。

InteractionStatusUpdate

interaction_id string  （必須）

説明が入力されていません。

status 列挙型（文字列）  （必須）

説明が入力されていません。

有効な値:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_type string  （必須）

説明が入力されていません。

常に "interaction.status_update" に設定。

event_id 文字列  （省略可）

このイベントからインタラクション ストリームを再開するために使用される event_id トークン。

ContentStart

index integer  （必須）

説明が入力されていません。

content コンテンツ  （必須）

説明が入力されていません。

event_type string  （必須）

説明が入力されていません。

常に "content.start" に設定。

event_id 文字列  （省略可）

このイベントからインタラクション ストリームを再開するために使用される event_id トークン。

ContentDelta

index integer  （必須）

説明が入力されていません。

delta object  （必須）

説明が入力されていません。

可能なタイプ

ポリモーフィック ディスクリミネータ: type

TextDelta

text 文字列  （必須）

説明が入力されていません。

annotations Annotation  （省略可）

モデル生成コンテンツの引用情報。

モデル生成コンテンツの引用情報。

可能なタイプ

ポリモーフィック ディスクリミネータ: type

UrlCitation

URL 引用アノテーション。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

type string  （必須）

説明が入力されていません。

常に "url_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

FileCitation

ファイル引用アノテーション。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

テキストの一部に帰属するソース。

type string  （必須）

説明が入力されていません。

常に "file_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

PlaceCitation

場所の引用アノテーション。

place_id 文字列  （省略可）

場所の ID。`places/{place_id}` 形式です。

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。

Google マップの特定の場所の機能に関する質問に回答するユーザー レビューのスニペットをカプセル化します。

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

Google マップのユーザー レビューに対応するリンク。

review_id 文字列  （省略可）

レビュー スニペットの ID。

type string  （必須）

説明が入力されていません。

常に "place_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

type object  （必須）

説明が入力されていません。

常に "text" に設定。

ImageDelta

data 文字列  （省略可）

説明が入力されていません。

uri string  （省略可）

説明が入力されていません。

mime_type 列挙型（文字列）  （省略可）

説明が入力されていません。

有効な値:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  （省略可）

メディアの解像度。

有効な値:

  • low
  • medium
  • high
  • ultra_high

type object  （必須）

説明が入力されていません。

常に "image" に設定。

AudioDelta

data 文字列  （省略可）

説明が入力されていません。

uri string  （省略可）

説明が入力されていません。

mime_type 列挙型（文字列）  （省略可）

説明が入力されていません。

有効な値:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  （必須）

説明が入力されていません。

常に "audio" に設定。

DocumentDelta

data 文字列  （省略可）

説明が入力されていません。

uri string  （省略可）

説明が入力されていません。

mime_type 列挙型（文字列）  （省略可）

説明が入力されていません。

有効な値:

  • application/pdf
type object  （必須）

説明が入力されていません。

常に "document" に設定。

VideoDelta

data 文字列  （省略可）

説明が入力されていません。

uri string  （省略可）

説明が入力されていません。

mime_type 列挙型（文字列）  （省略可）

説明が入力されていません。

有効な値:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  （省略可）

メディアの解像度。

有効な値:

  • low
  • medium
  • high
  • ultra_high

type object  （必須）

説明が入力されていません。

常に "video" に設定。

ThoughtSummaryDelta

content ThoughtSummaryContent  （省略可）

思考に追加する新しい要約項目。

可能なタイプ

ポリモーフィック ディスクリミネータ: type

TextContent

テキスト コンテンツ ブロック。

text 文字列  （必須）

テキスト コンテンツ。

annotations Annotation  （省略可）

モデル生成コンテンツの引用情報。

モデル生成コンテンツの引用情報。

可能なタイプ

ポリモーフィック ディスクリミネータ: type

UrlCitation

URL 引用アノテーション。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

type string  （必須）

説明が入力されていません。

常に "url_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

FileCitation

ファイル引用アノテーション。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

テキストの一部に帰属するソース。

type string  （必須）

説明が入力されていません。

常に "file_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

PlaceCitation

場所の引用アノテーション。

place_id 文字列  （省略可）

場所の ID。`places/{place_id}` 形式です。

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。

Google マップの特定の場所の機能に関する質問に回答するユーザー レビューのスニペットをカプセル化します。

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

Google マップのユーザー レビューに対応するリンク。

review_id 文字列  （省略可）

レビュー スニペットの ID。

type string  （必須）

説明が入力されていません。

常に "place_citation" に設定。

start_index integer  （省略可）

このソースに起因するレスポンスのセグメントの開始。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

type object  （必須）

説明が入力されていません。

常に "text" に設定。

ImageContent

画像コンテンツ ブロック。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

mime_type 列挙型（文字列）  （省略可）

画像の MIME タイプ。

有効な値:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  （省略可）

メディアの解像度。

有効な値:

  • low
  • medium
  • high
  • ultra_high

type object  （必須）

説明が入力されていません。

常に "image" に設定。

type object  （必須）

説明が入力されていません。

常に "thought_summary" に設定。

ThoughtSignatureDelta

signature string  （省略可）

生成の一部となるバックエンド ソースと一致するシグネチャ。

type object  （必須）

説明が入力されていません。

常に "thought_signature" に設定。

FunctionCallDelta

name string  （必須）

説明が入力されていません。

引数 オブジェクト  （必須）

説明が入力されていません。

type object  （必須）

説明が入力されていません。

常に "function_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

FunctionResultDelta

name string  （省略可）

説明が入力されていません。

is_error ブール値  （省略可）

説明が入力されていません。

result オブジェクトまたは文字列  （必須）

ツール呼び出し結果の差分。

type object  （必須）

説明が入力されていません。

常に "function_result" に設定。

call_id string  （必須）

関数呼び出しブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

CodeExecutionCallDelta

arguments CodeExecutionCallArguments  （必須）

説明が入力されていません。

コード実行に渡す引数。

フィールド

language enum（文字列）  （省略可）

`code` のプログラミング言語。

有効な値:

  • python
code 文字列  （省略可）

実行されるコード。

type object  （必須）

説明が入力されていません。

常に "code_execution_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

CodeExecutionResultDelta

result string  （必須）

説明が入力されていません。

is_error ブール値  （省略可）

説明が入力されていません。

type object  （必須）

説明が入力されていません。

常に "code_execution_result" に設定。

call_id string  （必須）

関数呼び出しブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

UrlContextCallDelta

arguments UrlContextCallArguments  （必須）

説明が入力されていません。

URL コンテキストに渡す引数。

フィールド

urls 配列（文字列）  （省略可）

取得する URL。

type object  （必須）

説明が入力されていません。

常に "url_context_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

UrlContextResultDelta

result UrlContextResult  （必須）

説明が入力されていません。

URL コンテキストの結果。

フィールド

url 文字列  （省略可）

取得された URL。

status 列挙型（文字列）  （省略可）

URL 取得のステータス。

有効な値:

  • success
  • error
  • paywall
  • unsafe
is_error ブール値  （省略可）

説明が入力されていません。

type object  （必須）

説明が入力されていません。

常に "url_context_result" に設定。

call_id string  （必須）

関数呼び出しブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

GoogleSearchCallDelta

引数 GoogleSearchCallArguments  （必須）

説明が入力されていません。

Google 検索に渡す引数。

フィールド

queries 配列（文字列）  （省略可）

ウェブ検索のフォローアップ用のウェブ検索クエリ。

type object  （必須）

説明が入力されていません。

常に "google_search_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

GoogleSearchResultDelta

result GoogleSearchResult  （必須）

説明が入力されていません。

Google 検索の結果。

フィールド

search_suggestions 文字列  （省略可）

ウェブページまたはアプリのウェブビューに埋め込むことができるウェブ コンテンツ スニペット。

is_error ブール値  （省略可）

説明が入力されていません。

type object  （必須）

説明が入力されていません。

常に "google_search_result" に設定。

call_id string  （必須）

関数呼び出しブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

McpServerToolCallDelta

name string  （必須）

説明が入力されていません。

server_name string  （必須）

説明が入力されていません。

引数 オブジェクト  （必須）

説明が入力されていません。

type object  （必須）

説明が入力されていません。

常に "mcp_server_tool_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

McpServerToolResultDelta

name string  （省略可）

説明が入力されていません。

server_name 文字列  （省略可）

説明が入力されていません。

result オブジェクトまたは文字列  （必須）

ツール呼び出し結果の差分。

type object  （必須）

説明が入力されていません。

常に "mcp_server_tool_result" に設定。

call_id string  （必須）

関数呼び出しブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

FileSearchCallDelta

type object  （必須）

説明が入力されていません。

常に "file_search_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

FileSearchResultDelta

result FileSearchResult  （省略可）

説明が入力されていません。

ファイル検索の結果。

type object  （必須）

説明が入力されていません。

常に "file_search_result" に設定。

call_id string  （必須）

関数呼び出しブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

GoogleMapsCallDelta

arguments GoogleMapsCallArguments  (省略可)

Google マップツールに渡す引数。

Google マップツールに渡す引数。

フィールド

queries 配列（文字列）  （省略可）

実行するクエリ。

type object  （必須）

説明が入力されていません。

常に "google_maps_call" に設定。

id 文字列  （必須）

この特定のツール呼び出しの一意の ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

GoogleMapsResultDelta

result GoogleMapsResult  （必須）

Google マップの検索結果。

Google マップの結果。

フィールド

places Places  （省略可）

見つかった場所。

フィールド

place_id 文字列  （省略可）

場所の ID。`places/{place_id}` 形式です。

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。

Google マップの特定の場所の機能に関する質問に回答するユーザー レビューのスニペットをカプセル化します。

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

Google マップのユーザー レビューに対応するリンク。

review_id 文字列  （省略可）

レビュー スニペットの ID。

widget_context_token string  （省略可）

Google マップ ウィジェット コンテキスト トークンのリソース名。

type object  （必須）

説明が入力されていません。

常に "google_maps_result" に設定。

call_id string  （必須）

関数呼び出しブロックの ID と一致する ID。

signature string  （省略可）

バックエンド検証用の署名ハッシュ。

event_type string  （必須）

説明が入力されていません。

常に "content.delta" に設定。

event_id 文字列  （省略可）

このイベントからインタラクション ストリームを再開するために使用される event_id トークン。

ContentStop

index integer  （必須）

説明が入力されていません。

event_type string  （必須）

説明が入力されていません。

常に "content.stop" に設定。

event_id 文字列  （省略可）

このイベントからインタラクション ストリームを再開するために使用される event_id トークン。

ErrorEvent

error Error  （省略可）

説明が入力されていません。

インタラクションからのエラー メッセージ。

フィールド

code 文字列  （省略可）

エラーの種類を識別する URI。

message string  （省略可）

人が読める形式のエラー メッセージ。

event_type string  （必須）

説明が入力されていません。

常に "error" に設定。

event_id 文字列  （省略可）

このイベントからインタラクション ストリームを再開するために使用される event_id トークン。

例

Interaction Start（インタラクションの開始）

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

Interaction Complete

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

Interaction Status Update

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

コンテンツの開始

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

コンテンツの差分

{
  "event_type": "content.delta",
  "delta": {
    "type": "text",
    "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save"
  },
  "index": 1
}

コンテンツの停止

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

エラーイベント

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