Gemini Interactions API は、デベロッパーが Gemini モデルを使用して生成 AI アプリケーションを構築できる試験運用版の API です。Gemini は、マルチモーダル向けに一から構築された、Google の最も高性能なモデルです。言語、画像、音声、動画、コードなど、さまざまな種類の情報を一般化してシームレスに理解し、操作し、組み合わせることができます。Gemini API は、テキストと画像を横断した推論、コンテンツ生成、対話エージェント、要約システム、分類システムなどのユースケースで使用できます。
インタラクションの作成
新しいインタラクションを作成します。
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
model ModelOption (省略可)
インタラクションの生成に使用される `Model` の名前。
`agent` が指定されていない場合は必須。
有効な値:
-
gemini-2.5-computer-use-preview-10-2025直接インターフェース操作用に設計されたエージェント機能モデル。Gemini がデジタル環境を認識して操作できるようにします。
-
gemini-2.5-flash100 万トークンのコンテキスト ウィンドウをサポートし、思考予算を備えた初のハイブリッド推論モデル。
-
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-2025Google のネイティブ音声モデルは、より高品質な音声出力に最適化されており、話し方のペースや自然さ、詳細度、ムードをより適切に表現できます。
-
gemini-2.5-flash-preview-09-20252.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-ttsGoogle の 2.5 Pro テキスト音声変換モデルは、強力で低レイテンシの音声生成に最適化されており、より自然な出力を実現し、プロンプトを簡単に操作できます。
-
gemini-3-flash-previewスピードを重視して構築された Google の最もインテリジェントなモデル。最先端のインテリジェンスと優れた検索機能およびグラウンディング機能を組み合わせたものです。
-
gemini-3-pro-image-preview画像の生成と編集のための最先端モデル。
-
gemini-3-pro-previewSOTA の推論とマルチモーダル理解を備え、強力なエージェント機能とバイブ コーディング機能を備えた、Google の最もインテリジェントなモデル。
-
gemini-3.1-pro-preview前例のない深さとニュアンスを備えた、強力なマルチモーダル理解とコーディング機能を備えた、最新の SOTA 推論モデル。
-
gemini-3.1-flash-image-previewFlash レベルの効率性と現実に基づいた生成機能を備えた、プロレベルのビジュアル インテリジェンス。
-
gemini-3.1-flash-lite-preview最も費用対効果の高いモデル。大量のエージェント タスク、翻訳、簡単なデータ処理向けに最適化されています。
-
gemini-3.1-flash-tts-previewGemini 3.1 Flash TTS: 強力で低レイテンシの音声生成。自然な出力、ステアリング可能なプロンプト、正確なナレーション制御のための新しい表現力豊かな音声タグをお楽しみください。
-
lyria-3-clip-preview高忠実度のオーディオ クリップと正確なリズム制御に最適化された、低レイテンシの音楽生成モデル。
-
lyria-3-pro-preview高度なフルソング生成モデル。作曲に関する深い理解を備え、多様な音楽スタイルにわたる正確な構造制御と複雑なトランジションに最適化されています。
agent AgentOption (省略可)
インタラクションの生成に使用される `Agent` の名前。
`model` が指定されていない場合は必須。
有効な値:
-
deep-research-pro-preview-12-2025Gemini Deep Research エージェント
-
deep-research-preview-04-2026Gemini Deep Research エージェント
-
deep-research-max-preview-04-2026Gemini Deep Research Max エージェント
対応のシステム指示。
モデルがインタラクション中に呼び出す可能性のあるツール宣言のリスト。
生成されたレスポンスが、このフィールドで指定された JSON スキーマに準拠した JSON オブジェクトであることを強制します。
レスポンスの MIME タイプ。response_format が設定されている場合は必須です。
入力専用。インタラクションがストリーミングされるかどうか。
入力専用。後で取得するためにレスポンスとリクエストを保存するかどうか。
入力専用。モデルのやり取りをバックグラウンドで実行するかどうか。
generation_config GenerationConfig (省略可)
モデル構成
モデルのインタラクションの構成パラメータ。
`agent_config` の代替。`model` が設定されている場合にのみ適用されます。
フィールド
出力のランダム性を制御します。
サンプリング時に考慮するトークンの累積確率の最大値。
再現性のためにデコードで使用されるシード。
出力インタラクションを停止する文字シーケンスのリスト。
thinking_level ThinkingLevel (省略可)
モデルが生成する思考トークンのレベル。
有効な値:
-
minimal -
low -
medium -
high
thinking_summaries ThinkingSummaries (省略可)
レスポンスに思考の要約を含めるかどうか。
有効な値:
-
auto -
none
レスポンスに含めるトークンの最大数。
speech_config SpeechConfig (省略可)
音声インタラクションの構成。
フィールド
話者の声。
音声の言語。
話者の名前。プロンプトで指定された話者の名前と一致している必要があります。
image_config ImageConfig (省略可)
画像インタラクションの構成。
フィールド
説明が入力されていません。
有効な値:
-
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
説明が入力されていません。
有効な値:
-
1K -
2K -
4K -
512
ツールの選択構成。
agent_config オブジェクト (省略可)
エージェントの構成
エージェントの構成。
`generation_config` の代替。`agent` が設定されている場合にのみ適用されます。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
DynamicAgentConfig
動的エージェントの構成。
説明が入力されていません。
常に "dynamic" に設定。
DeepResearchAgentConfig
Deep Research エージェントの構成。
説明が入力されていません。
常に "deep-research" に設定。
thinking_summaries ThinkingSummaries (省略可)
レスポンスに思考の要約を含めるかどうか。
有効な値:
-
auto -
none
レスポンスに可視化を含めるかどうか。
有効な値:
-
off -
auto
Deep Research エージェントの人間参加型プランニングを有効にします。true に設定すると、Deep Research エージェントはレスポンスでリサーチプランを提供します。エージェントは、次のターンでお客様がプランを確認した場合にのみ続行します。
以前のインタラクションの ID(存在する場合)。
response_modalities ResponseModality (省略可)
リクエストされたレスポンスのモダリティ(TEXT、IMAGE、AUDIO)。
有効な値:
-
text -
image -
audio -
video -
document
service_tier ServiceTier (省略可)
インタラクションのサービス階層。
有効な値:
-
flex -
standard -
priority
webhook_config WebhookConfig (省略可)
省略可。インタラクションが完了したときに通知を受け取るための Webhook 構成。
フィールド
省略可。設定すると、登録済みの Webhook の代わりに、これらの Webhook URI が Webhook イベントに使用されます。
省略可。各イベントの Webhook への送信時に返されるユーザー メタデータ。
レスポンス
Interaction リソースを返します。
シンプルなリクエスト
返信の例
{ "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 } }
マルチターン
返信の例
{ "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 } }
画像入力
返信の例
{ "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 } }
関数呼び出し
返信の例
{ "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
返信の例
{ "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 } }
インタラクションの取得
`Interaction.id` に基づいて、単一のインタラクションの完全な詳細を取得します。
パス / クエリ パラメータ
取得するインタラクションの一意の識別子。
true に設定すると、生成されたコンテンツが段階的にストリーミングされます。
デフォルト設定: False
省略可。設定されている場合、イベント ID でマークされたイベントの次のチャンクからインタラクション ストリームを再開します。`stream` が true の場合にのみ使用できます。
true に設定すると、入力がレスポンスに含まれます。
デフォルト設定: False
使用する 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", "steps": [ { "type": "model_output", "content": [ { "type": "text", "text": "I'm doing great, thank you for asking! How can I help you today?" } ] } ] }
インタラクションの削除
ID でインタラクションを削除します。
パス / クエリ パラメータ
削除するインタラクションの一意の識別子。
使用する API のバージョン。
レスポンス
成功すると、レスポンスは空になります。
インタラクションを削除
インタラクションのキャンセル
ID でインタラクションをキャンセルします。これは、実行中のバックグラウンド インタラクションにのみ適用されます。
パス / クエリ パラメータ
キャンセルするインタラクションの固有識別子。
使用する 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" }
リソース
インタラクション
Interaction リソース。
フィールド
model ModelOption (省略可)
インタラクションの生成に使用される `Model` の名前。
有効な値:
-
gemini-2.5-computer-use-preview-10-2025直接インターフェース操作用に設計されたエージェント機能モデル。Gemini がデジタル環境を認識して操作できるようにします。
-
gemini-2.5-flash100 万トークンのコンテキスト ウィンドウをサポートし、思考予算を備えた初のハイブリッド推論モデル。
-
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-2025Google のネイティブ音声モデルは、より高品質な音声出力に最適化されており、話し方のペースや自然さ、詳細度、ムードをより適切に表現できます。
-
gemini-2.5-flash-preview-09-20252.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-ttsGoogle の 2.5 Pro テキスト音声変換モデルは、強力で低レイテンシの音声生成に最適化されており、より自然な出力を実現し、プロンプトを簡単に操作できます。
-
gemini-3-flash-previewスピードを重視して構築された Google の最もインテリジェントなモデル。最先端のインテリジェンスと優れた検索機能およびグラウンディング機能を組み合わせたものです。
-
gemini-3-pro-image-preview画像の生成と編集のための最先端モデル。
-
gemini-3-pro-previewSOTA の推論とマルチモーダル理解を備え、強力なエージェント機能とバイブ コーディング機能を備えた、Google の最もインテリジェントなモデル。
-
gemini-3.1-pro-preview前例のない深さとニュアンスを備えた、強力なマルチモーダル理解とコーディング機能を備えた、最新の SOTA 推論モデル。
-
gemini-3.1-flash-image-previewFlash レベルの効率性と現実に基づいた生成機能を備えた、プロレベルのビジュアル インテリジェンス。
-
gemini-3.1-flash-lite-preview最も費用対効果の高いモデル。大量のエージェント タスク、翻訳、簡単なデータ処理向けに最適化されています。
-
gemini-3.1-flash-tts-previewGemini 3.1 Flash TTS: 強力で低レイテンシの音声生成。自然な出力、ステアリング可能なプロンプト、正確なナレーション制御のための新しい表現力豊かな音声タグをお楽しみください。
-
lyria-3-clip-preview高忠実度のオーディオ クリップと正確なリズム制御に最適化された、低レイテンシの音楽生成モデル。
-
lyria-3-pro-preview高度なフルソング生成モデル。作曲に関する深い理解を備え、多様な音楽スタイルにわたる正確な構造制御と複雑なトランジションに最適化されています。
agent AgentOption (省略可)
インタラクションの生成に使用される `Agent` の名前。
有効な値:
-
deep-research-pro-preview-12-2025Gemini Deep Research エージェント
-
deep-research-preview-04-2026Gemini Deep Research エージェント
-
deep-research-max-preview-04-2026Gemini Deep Research Max エージェント
必須。出力専用。インタラクション完了の一意の識別子。
必須。出力専用。インタラクションのステータス。
有効な値:
-
in_progress -
requires_action -
completed -
failed -
cancelled -
incomplete
必須。出力専用。レスポンスが作成された時刻(ISO 8601 形式(YYYY-MM-DDThh:mm:ssZ))。
必須。出力専用。レスポンスが最後に更新された時刻(ISO 8601 形式(YYYY-MM-DDThh:mm:ssZ))。
出力専用。インタラクションの役割。
対応のシステム指示。
モデルがインタラクション中に呼び出す可能性のあるツール宣言のリスト。
usage Usage (省略可)
出力専用。インタラクション リクエストのトークン使用量に関する統計情報。
フィールド
プロンプト(コンテキスト)内のトークン数。
input_tokens_by_modality ModalityTokens (省略可)
入力トークンの使用状況をモダリティ別に分類した内訳。
フィールド
modality ResponseModality (省略可)
トークン数に関連付けられたモダリティ。
有効な値:
-
text -
image -
audio -
video -
document
モダリティのトークン数。
プロンプトのキャッシュに保存された部分(キャッシュに保存されたコンテンツ)のトークン数。
cached_tokens_by_modality ModalityTokens (省略可)
モダリティ別のキャッシュ保存されたトークンの使用状況の内訳。
フィールド
modality ResponseModality (省略可)
トークン数に関連付けられたモダリティ。
有効な値:
-
text -
image -
audio -
video -
document
モダリティのトークン数。
生成されたすべてのレスポンスのトークンの合計数。
output_tokens_by_modality ModalityTokens (省略可)
出力トークンの使用状況をモダリティ別に分類した内訳。
フィールド
modality ResponseModality (省略可)
トークン数に関連付けられたモダリティ。
有効な値:
-
text -
image -
audio -
video -
document
モダリティのトークン数。
ツール使用プロンプト内のトークン数。
tool_use_tokens_by_modality ModalityTokens (省略可)
モダリティ別のツール使用トークンの使用状況の内訳。
フィールド
modality ResponseModality (省略可)
トークン数に関連付けられたモダリティ。
有効な値:
-
text -
image -
audio -
video -
document
モダリティのトークン数。
思考モデルの思考トークンの数。
インタラクション リクエストのトークンの合計数(プロンプト + レスポンス + その他の内部トークン)。
grounding_tool_count GroundingToolCount (省略可)
グラウンディング ツールの数。
フィールド
カウントに関連付けられているグラウンディング ツールのタイプ。
有効な値:
-
google_search -
google_maps -
retrieval
接地ツールの数。
response_modalities ResponseModality (省略可)
リクエストされたレスポンスのモダリティ(TEXT、IMAGE、AUDIO)。
有効な値:
-
text -
image -
audio -
video -
document
レスポンスの MIME タイプ。response_format が設定されている場合は必須です。
以前のインタラクションの ID(存在する場合)。
service_tier ServiceTier (省略可)
インタラクションのサービス階層。
有効な値:
-
flex -
standard -
priority
webhook_config WebhookConfig (省略可)
省略可。インタラクションが完了したときに通知を受け取るための Webhook 構成。
フィールド
省略可。設定すると、登録済みの Webhook の代わりに、これらの Webhook URI が Webhook イベントに使用されます。
省略可。各イベントの Webhook への送信時に返されるユーザー メタデータ。
steps Step (省略可)
出力専用。インタラクションを構成する手順。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
UserInputStep
ユーザーが提供した入力。
説明が入力されていません。
常に "user_input" に設定。
説明が入力されていません。
ModelOutputStep
モデルによって生成された出力。
説明が入力されていません。
常に "model_output" に設定。
説明が入力されていません。
ThoughtStep
思考ステップ。
説明が入力されていません。
常に "thought" に設定。
バックエンド検証用の署名ハッシュ。
summary ThoughtSummaryContent (省略可)
考えの要約。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
TextContent
テキスト コンテンツ ブロック。
説明が入力されていません。
常に "text" に設定。
必須。テキスト コンテンツ。
annotations Annotation (省略可)
モデル生成コンテンツの引用情報。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
UrlCitation
URL 引用アノテーション。
説明が入力されていません。
常に "url_citation" に設定。
URL。
URL のタイトル。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
FileCitation
ファイル引用アノテーション。
説明が入力されていません。
常に "file_citation" に設定。
ファイルの URI。
ファイルの名前。
テキストの一部に帰属するソース。
ユーザーが取得したコンテキストに関するメタデータを提供しました。
引用したドキュメントのページ番号(該当する場合)。
画像引用の場合のメディア ID(該当する場合)。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
PlaceCitation
場所の引用アノテーション。
説明が入力されていません。
常に "place_citation" に設定。
場所の ID。`places/{place_id}` 形式です。
場所のタイトル。
場所の URI 参照。
review_snippets ReviewSnippet (省略可)
Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。
フィールド
レビューのタイトル。
Google マップのユーザー レビューに対応するリンク。
クチコミ抜粋の ID。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
ImageContent
画像コンテンツ ブロック。
説明が入力されていません。
常に "image" に設定。
画像コンテンツ。
画像の URI。
画像の MIME タイプ。
有効な値:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif -
image/gif -
image/bmp -
image/tiff
resolution MediaResolution (省略可)
メディアの解像度。
有効な値:
-
low -
medium -
high -
ultra_high
FunctionCallStep
関数ツール呼び出しステップ。
説明が入力されていません。
常に "function_call" に設定。
必須。呼び出すツールの名前。
必須。関数に渡す引数。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
CodeExecutionCallStep
コード実行の呼び出しステップ。
説明が入力されていません。
常に "code_execution_call" に設定。
arguments CodeExecutionCallStepArguments (必須)
必須。コード実行に渡す引数。
フィールド
`code` のプログラミング言語。
有効な値:
-
python
実行されるコード。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
UrlContextCallStep
URL コンテキスト呼び出しステップ。
説明が入力されていません。
常に "url_context_call" に設定。
arguments UrlContextCallStepArguments (必須)
必須。URL コンテキストに渡す引数。
フィールド
取得する URL。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
McpServerToolCallStep
MCPServer ツール呼び出しステップ。
説明が入力されていません。
常に "mcp_server_tool_call" に設定。
必須。呼び出されたツールの名前。
必須。使用される MCP サーバーの名前。
必須。関数の引数の JSON オブジェクト。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
GoogleSearchCallStep
Google 検索の呼び出しステップ。
説明が入力されていません。
常に "google_search_call" に設定。
arguments GoogleSearchCallStepArguments (必須)
必須。Google 検索に渡す引数。
フィールド
ウェブ検索のフォローアップ用のウェブ検索クエリ。
有効になっている検索グラウンディングのタイプ。
有効な値:
-
web_search -
image_search -
enterprise_web_search
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
FileSearchCallStep
ファイル検索のコールステップ。
説明が入力されていません。
常に "file_search_call" に設定。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
GoogleMapsCallStep
Google マップの通話ステップ。
説明が入力されていません。
常に "google_maps_call" に設定。
arguments GoogleMapsCallStepArguments (省略可)
Google マップツールに渡す引数。
フィールド
実行するクエリ。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
FunctionResultStep
関数ツールの呼び出しの結果。
説明が入力されていません。
常に "function_result" に設定。
呼び出されたツールの名前。
ツール呼び出しでエラーが発生したかどうか。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
ツール呼び出しの結果。
CodeExecutionResultStep
コード実行結果のステップ。
説明が入力されていません。
常に "code_execution_result" に設定。
必須。コード実行の出力。
コード実行でエラーが発生したかどうか。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
UrlContextResultStep
URL コンテキストの結果ステップ。
説明が入力されていません。
常に "url_context_result" に設定。
result UrlContextResultItem (必須)
必須。URL コンテキストの結果。
フィールド
取得された URL。
URL 取得のステータス。
有効な値:
-
success -
error -
paywall -
unsafe
URL コンテキストでエラーが発生したかどうか。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
GoogleSearchResultStep
Google 検索の検索結果ステップ。
説明が入力されていません。
常に "google_search_result" に設定。
result GoogleSearchResultItem (必須)
必須。Google 検索の結果。
フィールド
ウェブページまたはアプリのウェブビューに埋め込むことができるウェブ コンテンツ スニペット。
Google 検索でエラーが発生したかどうか。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
McpServerToolResultStep
MCPServer ツール結果ステップ。
説明が入力されていません。
常に "mcp_server_tool_result" に設定。
この特定のツール呼び出しで呼び出されるツールの名前。
使用される MCP サーバーの名前。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
MCP サーバー呼び出しからの出力。シンプルなテキストまたはリッチ コンテンツにできます。
FileSearchResultStep
ファイル検索結果の手順。
説明が入力されていません。
常に "file_search_result" に設定。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
GoogleMapsResultStep
Google マップの結果ステップ。
説明が入力されていません。
常に "google_maps_result" に設定。
result GoogleMapsResultItem (必須)
説明が入力されていません。
フィールド
places GoogleMapsResultPlaces (省略可)
説明が入力されていません。
フィールド
説明が入力されていません。
説明が入力されていません。
説明が入力されていません。
review_snippets ReviewSnippet (省略可)
説明が入力されていません。
フィールド
レビューのタイトル。
Google マップのユーザー レビューに対応するリンク。
クチコミ抜粋の ID。
説明が入力されていません。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
生成されたレスポンスが、このフィールドで指定された JSON スキーマに準拠した JSON オブジェクトであることを強制します。
agent_config object (省略可)
エージェントのインタラクションの構成パラメータ。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
DynamicAgentConfig
動的エージェントの構成。
説明が入力されていません。
常に "dynamic" に設定。
DeepResearchAgentConfig
Deep Research エージェントの構成。
説明が入力されていません。
常に "deep-research" に設定。
thinking_summaries ThinkingSummaries (省略可)
レスポンスに思考の要約を含めるかどうか。
有効な値:
-
auto -
none
レスポンスに可視化を含めるかどうか。
有効な値:
-
off -
auto
Deep Research エージェントの人間参加型プランニングを有効にします。true に設定すると、Deep Research エージェントはレスポンスでリサーチプランを提供します。エージェントは、次のターンでお客様がプランを確認した場合にのみ続行します。
例
例
{ "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 } }
データモデル
コンテンツ
レスポンスの内容。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
TextContent
テキスト コンテンツ ブロック。
説明が入力されていません。
常に "text" に設定。
必須。テキスト コンテンツ。
annotations Annotation (省略可)
モデル生成コンテンツの引用情報。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
UrlCitation
URL 引用アノテーション。
説明が入力されていません。
常に "url_citation" に設定。
URL。
URL のタイトル。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
FileCitation
ファイル引用アノテーション。
説明が入力されていません。
常に "file_citation" に設定。
ファイルの URI。
ファイルの名前。
テキストの一部に帰属するソース。
ユーザーが取得したコンテキストに関するメタデータを提供しました。
引用したドキュメントのページ番号(該当する場合)。
画像引用の場合のメディア ID(該当する場合)。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
PlaceCitation
場所の引用アノテーション。
説明が入力されていません。
常に "place_citation" に設定。
場所の ID。`places/{place_id}` 形式です。
場所のタイトル。
場所の URI 参照。
review_snippets ReviewSnippet (省略可)
Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。
フィールド
レビューのタイトル。
Google マップのユーザー レビューに対応するリンク。
クチコミ抜粋の ID。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
ImageContent
画像コンテンツ ブロック。
説明が入力されていません。
常に "image" に設定。
画像コンテンツ。
画像の URI。
画像の MIME タイプ。
有効な値:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif -
image/gif -
image/bmp -
image/tiff
resolution MediaResolution (省略可)
メディアの解像度。
有効な値:
-
low -
medium -
high -
ultra_high
AudioContent
音声コンテンツ ブロック。
説明が入力されていません。
常に "audio" に設定。
音声コンテンツ。
音声の URI。
音声の MIME タイプ。
有効な値:
-
audio/wav -
audio/mp3 -
audio/aiff -
audio/aac -
audio/ogg -
audio/flac -
audio/mpeg -
audio/m4a -
audio/l16 -
audio/opus -
audio/alaw -
audio/mulaw
音声チャンネルの数。
音声のサンプルレート。
DocumentContent
ドキュメントのコンテンツ ブロック。
説明が入力されていません。
常に "document" に設定。
ドキュメントのコンテンツ。
ドキュメントの URI。
ドキュメントの MIME タイプ。
有効な値:
-
application/pdf
VideoContent
動画コンテンツ ブロック。
説明が入力されていません。
常に "video" に設定。
動画コンテンツ。
動画の URI。
動画の 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": "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
関数
モデルで使用できるツール。
説明が入力されていません。
常に "function" に設定。
関数名。
関数の説明。
関数のパラメータの JSON スキーマ。
CodeExecution
モデルがコードを実行するために使用できるツール。
説明が入力されていません。
常に "code_execution" に設定。
UrlContext
モデルが URL コンテキストを取得するために使用できるツール。
説明が入力されていません。
常に "url_context" に設定。
ComputerUse
モデルがコンピュータとやり取りするために使用できるツール。
説明が入力されていません。
常に "computer_use" に設定。
運用中の環境。
有効な値:
-
browser
モデル呼び出しから除外される事前定義関数のリスト。
McpServer
MCPServer は、モデルから呼び出してアクションを実行できるサーバーです。
説明が入力されていません。
常に "mcp_server" に設定。
MCPServer の名前。
MCPServer エンドポイントの完全な URL。例: "https://api.example.com/mcp"
省略可: 認証ヘッダー、タイムアウトなどのフィールド(必要な場合)。
allowed_tools AllowedTools (省略可)
許可されているツール。
フィールド
mode ToolChoiceType (省略可)
ツール選択のモード。
有効な値:
-
auto -
any -
none -
validated
許可されたツールの名前。
GoogleSearch
モデルが Google を検索するために使用できるツール。
説明が入力されていません。
常に "google_search" に設定。
有効にする検索グラウンディングのタイプ。
有効な値:
-
web_search -
image_search -
enterprise_web_search
FileSearch
モデルがファイルの検索に使用できるツール。
説明が入力されていません。
常に "file_search" に設定。
検索するファイル検索ストアの名前。
取得するセマンティック検索チャンクの数。
セマンティック検索のドキュメントとチャンクに適用するメタデータ フィルタ。
GoogleMaps
モデルが Google マップを呼び出すために使用できるツール。
説明が入力されていません。
常に "google_maps" に設定。
レスポンスのツール呼び出し結果でウィジェット コンテキスト トークンを返すかどうか。
ユーザーの現在地の緯度。
ユーザーの現在地の経度。
取得
モデルがファイルを取得するために使用できるツール。
説明が入力されていません。
常に "retrieval" に設定。
有効にするファイル取得の種類。
有効な値:
-
vertex_ai_search
vertex_ai_search_config VertexAISearchConfig (省略可)
VertexAISearch の構成を指定するために使用されます。
フィールド
省略可。Vertex AI Search エンジンを指定するために使用されます。
省略可。Vertex AI Search データストアを指定するために使用されます。
例
関数
CodeExecution
UrlContext
ComputerUse
McpServer
GoogleSearch
FileSearch
GoogleMaps
取得
このタイプで使用できる例はありません。
InteractionSseEvent
可能なタイプ
ポリモーフィック ディスクリミネータ: event_type
InteractionCreatedEvent
説明が入力されていません。
常に "interaction.created" に設定。
説明が入力されていません。
このイベントからインタラクション ストリームを再開するために使用される event_id トークン。
InteractionCompletedEvent
説明が入力されていません。
常に "interaction.completed" に設定。
必須。ペイロード サイズを小さくするために、出力が空の完了したインタラクション。実際の出力には、上記の ContentDelta イベントを使用します。
このイベントからインタラクション ストリームを再開するために使用される event_id トークン。
InteractionStatusUpdate
説明が入力されていません。
常に "interaction.status_update" に設定。
説明が入力されていません。
説明が入力されていません。
有効な値:
-
in_progress -
requires_action -
completed -
failed -
cancelled -
incomplete
このイベントからインタラクション ストリームを再開するために使用される event_id トークン。
ErrorEvent
説明が入力されていません。
常に "error" に設定。
error Error (省略可)
説明が入力されていません。
フィールド
エラーの種類を識別する URI。
人が読める形式のエラー メッセージ。
このイベントからインタラクション ストリームを再開するために使用される event_id トークン。
StepStart
説明が入力されていません。
常に "step.start" に設定。
説明が入力されていません。
step Step (必須)
説明が入力されていません。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
UserInputStep
ユーザーが提供した入力。
説明が入力されていません。
常に "user_input" に設定。
説明が入力されていません。
ModelOutputStep
モデルによって生成された出力。
説明が入力されていません。
常に "model_output" に設定。
説明が入力されていません。
ThoughtStep
思考ステップ。
説明が入力されていません。
常に "thought" に設定。
バックエンド検証用の署名ハッシュ。
summary ThoughtSummaryContent (省略可)
考えの要約。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
TextContent
テキスト コンテンツ ブロック。
説明が入力されていません。
常に "text" に設定。
必須。テキスト コンテンツ。
annotations Annotation (省略可)
モデル生成コンテンツの引用情報。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
UrlCitation
URL 引用アノテーション。
説明が入力されていません。
常に "url_citation" に設定。
URL。
URL のタイトル。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
FileCitation
ファイル引用アノテーション。
説明が入力されていません。
常に "file_citation" に設定。
ファイルの URI。
ファイルの名前。
テキストの一部に帰属するソース。
ユーザーが取得したコンテキストに関するメタデータを提供しました。
引用したドキュメントのページ番号(該当する場合)。
画像引用の場合のメディア ID(該当する場合)。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
PlaceCitation
場所の引用アノテーション。
説明が入力されていません。
常に "place_citation" に設定。
場所の ID。`places/{place_id}` 形式です。
場所のタイトル。
場所の URI 参照。
review_snippets ReviewSnippet (省略可)
Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。
フィールド
レビューのタイトル。
Google マップのユーザー レビューに対応するリンク。
クチコミ抜粋の ID。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
ImageContent
画像コンテンツ ブロック。
説明が入力されていません。
常に "image" に設定。
画像コンテンツ。
画像の URI。
画像の MIME タイプ。
有効な値:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif -
image/gif -
image/bmp -
image/tiff
resolution MediaResolution (省略可)
メディアの解像度。
有効な値:
-
low -
medium -
high -
ultra_high
FunctionCallStep
関数ツール呼び出しステップ。
説明が入力されていません。
常に "function_call" に設定。
必須。呼び出すツールの名前。
必須。関数に渡す引数。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
CodeExecutionCallStep
コード実行の呼び出しステップ。
説明が入力されていません。
常に "code_execution_call" に設定。
arguments CodeExecutionCallStepArguments (必須)
必須。コード実行に渡す引数。
フィールド
`code` のプログラミング言語。
有効な値:
-
python
実行されるコード。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
UrlContextCallStep
URL コンテキスト呼び出しステップ。
説明が入力されていません。
常に "url_context_call" に設定。
arguments UrlContextCallStepArguments (必須)
必須。URL コンテキストに渡す引数。
フィールド
取得する URL。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
McpServerToolCallStep
MCPServer ツール呼び出しステップ。
説明が入力されていません。
常に "mcp_server_tool_call" に設定。
必須。呼び出されたツールの名前。
必須。使用される MCP サーバーの名前。
必須。関数の引数の JSON オブジェクト。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
GoogleSearchCallStep
Google 検索の呼び出しステップ。
説明が入力されていません。
常に "google_search_call" に設定。
arguments GoogleSearchCallStepArguments (必須)
必須。Google 検索に渡す引数。
フィールド
ウェブ検索のフォローアップ用のウェブ検索クエリ。
有効になっている検索グラウンディングのタイプ。
有効な値:
-
web_search -
image_search -
enterprise_web_search
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
FileSearchCallStep
ファイル検索のコールステップ。
説明が入力されていません。
常に "file_search_call" に設定。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
GoogleMapsCallStep
Google マップの通話ステップ。
説明が入力されていません。
常に "google_maps_call" に設定。
arguments GoogleMapsCallStepArguments (省略可)
Google マップツールに渡す引数。
フィールド
実行するクエリ。
必須。この特定のツール呼び出しの一意の ID。
バックエンド検証用の署名ハッシュ。
FunctionResultStep
関数ツールの呼び出しの結果。
説明が入力されていません。
常に "function_result" に設定。
呼び出されたツールの名前。
ツール呼び出しでエラーが発生したかどうか。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
ツール呼び出しの結果。
CodeExecutionResultStep
コード実行結果のステップ。
説明が入力されていません。
常に "code_execution_result" に設定。
必須。コード実行の出力。
コード実行でエラーが発生したかどうか。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
UrlContextResultStep
URL コンテキストの結果ステップ。
説明が入力されていません。
常に "url_context_result" に設定。
result UrlContextResultItem (必須)
必須。URL コンテキストの結果。
フィールド
取得された URL。
URL 取得のステータス。
有効な値:
-
success -
error -
paywall -
unsafe
URL コンテキストでエラーが発生したかどうか。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
GoogleSearchResultStep
Google 検索の検索結果ステップ。
説明が入力されていません。
常に "google_search_result" に設定。
result GoogleSearchResultItem (必須)
必須。Google 検索の結果。
フィールド
ウェブページまたはアプリのウェブビューに埋め込むことができるウェブ コンテンツ スニペット。
Google 検索でエラーが発生したかどうか。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
McpServerToolResultStep
MCPServer ツール結果ステップ。
説明が入力されていません。
常に "mcp_server_tool_result" に設定。
この特定のツール呼び出しで呼び出されるツールの名前。
使用される MCP サーバーの名前。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
MCP サーバー呼び出しからの出力。シンプルなテキストまたはリッチ コンテンツにできます。
FileSearchResultStep
ファイル検索結果の手順。
説明が入力されていません。
常に "file_search_result" に設定。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
GoogleMapsResultStep
Google マップの結果ステップ。
説明が入力されていません。
常に "google_maps_result" に設定。
result GoogleMapsResultItem (必須)
説明が入力されていません。
フィールド
places GoogleMapsResultPlaces (省略可)
説明が入力されていません。
フィールド
説明が入力されていません。
説明が入力されていません。
説明が入力されていません。
review_snippets ReviewSnippet (省略可)
説明が入力されていません。
フィールド
レビューのタイトル。
Google マップのユーザー レビューに対応するリンク。
クチコミ抜粋の ID。
説明が入力されていません。
必須。関数呼び出しブロックの ID と一致する ID。
バックエンド検証用の署名ハッシュ。
このイベントからインタラクション ストリームを再開するために使用される event_id トークン。
StepDelta
説明が入力されていません。
常に "step.delta" に設定。
説明が入力されていません。
delta StepDeltaData (必須)
説明が入力されていません。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
TextDelta
説明が入力されていません。
常に "text" に設定。
説明が入力されていません。
ImageDelta
説明が入力されていません。
常に "image" に設定。
説明が入力されていません。
説明が入力されていません。
説明が入力されていません。
有効な値:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif -
image/gif -
image/bmp -
image/tiff
resolution MediaResolution (省略可)
メディアの解像度。
有効な値:
-
low -
medium -
high -
ultra_high
AudioDelta
説明が入力されていません。
常に "audio" に設定。
説明が入力されていません。
説明が入力されていません。
説明が入力されていません。
有効な値:
-
audio/wav -
audio/mp3 -
audio/aiff -
audio/aac -
audio/ogg -
audio/flac -
audio/mpeg -
audio/m4a -
audio/l16 -
audio/opus -
audio/alaw -
audio/mulaw
非推奨です。代わりに sample_rate を使用してください。この値は無視されます。
音声のサンプルレート。
音声チャンネルの数。
DocumentDelta
説明が入力されていません。
常に "document" に設定。
説明が入力されていません。
説明が入力されていません。
説明が入力されていません。
有効な値:
-
application/pdf
VideoDelta
説明が入力されていません。
常に "video" に設定。
説明が入力されていません。
説明が入力されていません。
説明が入力されていません。
有効な値:
-
video/mp4 -
video/mpeg -
video/mpg -
video/mov -
video/avi -
video/x-flv -
video/webm -
video/wmv -
video/3gpp
resolution MediaResolution (省略可)
メディアの解像度。
有効な値:
-
low -
medium -
high -
ultra_high
ThoughtSummaryDelta
説明が入力されていません。
常に "thought_summary" に設定。
content ThoughtSummaryContent (省略可)
思考に追加する新しい要約項目。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
TextContent
テキスト コンテンツ ブロック。
説明が入力されていません。
常に "text" に設定。
必須。テキスト コンテンツ。
annotations Annotation (省略可)
モデル生成コンテンツの引用情報。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
UrlCitation
URL 引用アノテーション。
説明が入力されていません。
常に "url_citation" に設定。
URL。
URL のタイトル。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
FileCitation
ファイル引用アノテーション。
説明が入力されていません。
常に "file_citation" に設定。
ファイルの URI。
ファイルの名前。
テキストの一部に帰属するソース。
ユーザーが取得したコンテキストに関するメタデータを提供しました。
引用したドキュメントのページ番号(該当する場合)。
画像引用の場合のメディア ID(該当する場合)。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
PlaceCitation
場所の引用アノテーション。
説明が入力されていません。
常に "place_citation" に設定。
場所の ID。`places/{place_id}` 形式です。
場所のタイトル。
場所の URI 参照。
review_snippets ReviewSnippet (省略可)
Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。
フィールド
レビューのタイトル。
Google マップのユーザー レビューに対応するリンク。
クチコミ抜粋の ID。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
ImageContent
画像コンテンツ ブロック。
説明が入力されていません。
常に "image" に設定。
画像コンテンツ。
画像の URI。
画像の MIME タイプ。
有効な値:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif -
image/gif -
image/bmp -
image/tiff
resolution MediaResolution (省略可)
メディアの解像度。
有効な値:
-
low -
medium -
high -
ultra_high
ThoughtSignatureDelta
説明が入力されていません。
常に "thought_signature" に設定。
生成の一部となるバックエンド ソースと一致するシグネチャ。
TextAnnotationDelta
説明が入力されていません。
常に "text_annotation_delta" に設定。
annotations Annotation (省略可)
モデル生成コンテンツの引用情報。
可能なタイプ
ポリモーフィック ディスクリミネータ: type
UrlCitation
URL 引用アノテーション。
説明が入力されていません。
常に "url_citation" に設定。
URL。
URL のタイトル。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
FileCitation
ファイル引用アノテーション。
説明が入力されていません。
常に "file_citation" に設定。
ファイルの URI。
ファイルの名前。
テキストの一部に帰属するソース。
ユーザーが取得したコンテキストに関するメタデータを提供しました。
引用したドキュメントのページ番号(該当する場合)。
画像引用の場合のメディア ID(該当する場合)。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
PlaceCitation
場所の引用アノテーション。
説明が入力されていません。
常に "place_citation" に設定。
場所の ID。`places/{place_id}` 形式です。
場所のタイトル。
場所の URI 参照。
review_snippets ReviewSnippet (省略可)
Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。
フィールド
レビューのタイトル。
Google マップのユーザー レビューに対応するリンク。
クチコミ抜粋の ID。
このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。
帰属セグメントの終了位置(この位置自体は含みません)。
ArgumentsDelta
説明が入力されていません。
常に "arguments_delta" に設定。
説明が入力されていません。
このイベントからインタラクション ストリームを再開するために使用される event_id トークン。
StepStop
説明が入力されていません。
常に "step.stop" に設定。
説明が入力されていません。
このイベントからインタラクション ストリームを再開するために使用される event_id トークン。
例
Interaction Created
{ "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" }
Interaction Completed(インタラクション完了)
{ "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" }
Interaction Status Update
{ "event_type": "interaction.status_update", "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM", "status": "in_progress" }
エラーイベント
{ "event_type": "error", "error": { "message": "Failed to get completed interaction: Result not found.", "code": "not_found" } }
ステップ開始
{ "event_type": "step.start", "index": 0, "step": { "type": "model_output" } }
歩数の差分
{ "event_type": "step.delta", "index": 0, "delta": { "type": "text", "text": "Hello" } }
ステップ ストップ
{ "event_type": "step.stop", "index": 0 }