Gemini API

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

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

CreateWebhook

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

新しい Webhook を作成します。

リクエストの本文

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

name string  （省略可）

省略可。ユーザーが指定した Webhook の名前。

uri 文字列  （必須）

必須。Webhook イベントの送信先 URI。

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

必須。Webhook が登録されているイベント。使用可能なイベント: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

レスポンス

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

name string  （省略可）

省略可。ユーザーが指定した Webhook の名前。

uri string  （省略可）

必須。Webhook イベントの送信先 URI。

subscribed_events 配列（オブジェクトまたは文字列）  （省略可）

必須。Webhook が登録されているイベント。使用可能なイベント: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

create_time 文字列  （省略可）

出力専用。Webhook が作成されたときのタイムスタンプ。

update_time 文字列  （省略可）

出力専用。Webhook が最後に更新されたときのタイムスタンプ。

signing_secrets SigningSecret  （省略可）

出力専用。この Webhook に関連付けられている署名シークレット。

Webhook ペイロードの検証に使用される署名シークレットを表します。

フィールド

truncated_secret 文字列  （省略可）

出力専用。署名シークレットの切り捨てられたバージョン。

expire_time 文字列  （省略可）

出力専用。署名シークレットの有効期限。

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

出力専用。Webhook の状態。

有効な値:

  • enabled
  • disabled
  • disabled_due_to_failed_deliveries
new_signing_secret 文字列  （省略可）

出力専用。Webhook の新しい署名シークレット。作成時にのみ入力されます。

id 文字列  （省略可）

出力専用。Webhook の ID。

例

返信の例

{
  "name": "string",
  "uri": "string",
  "subscribed_events": [
    "string"
  ],
  "create_time": "string",
  "update_time": "string",
  "signing_secrets": [
    {
      "truncated_secret": "string",
      "expire_time": "string"
    }
  ],
  "state": "enabled",
  "new_signing_secret": "string",
  "id": "string"
}

ListWebhooks

get https://generativelanguage.googleapis.com/v1beta/webhooks

すべての Webhook を一覧表示します。

パス / クエリ パラメータ

page_size integer  （省略可）

省略可。返す Webhook の最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合、最大で 50 個の Webhook が返されます。最大値は 1000 です。

page_token 文字列  （省略可）

省略可。前回の `ListWebhooks` 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

レスポンス

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

webhooks 配列（Webhook）  （省略可）

Webhook。

next_page_token string  （省略可）

次のページを取得するために `page_token` として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

例

返信の例

{
  "webhooks": [
    {
      "name": "string",
      "uri": "string",
      "subscribed_events": [
        "string"
      ],
      "create_time": "string",
      "update_time": "string",
      "signing_secrets": [
        {
          "truncated_secret": "string",
          "expire_time": "string"
        }
      ],
      "state": "enabled",
      "new_signing_secret": "string",
      "id": "string"
    }
  ],
  "next_page_token": "string"
}

GetWebhook

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

特定の Webhook を取得します。

パス / クエリ パラメータ

id 文字列  （必須）

必須。取得する Webhook の ID。

レスポンス

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

name string  （省略可）

省略可。ユーザーが指定した Webhook の名前。

uri string  （省略可）

必須。Webhook イベントの送信先 URI。

subscribed_events 配列（オブジェクトまたは文字列）  （省略可）

必須。Webhook が登録されているイベント。使用可能なイベント: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

create_time 文字列  （省略可）

出力専用。Webhook が作成されたときのタイムスタンプ。

update_time 文字列  （省略可）

出力専用。Webhook が最後に更新されたときのタイムスタンプ。

signing_secrets SigningSecret  （省略可）

出力専用。この Webhook に関連付けられている署名シークレット。

Webhook ペイロードの検証に使用される署名シークレットを表します。

フィールド

truncated_secret 文字列  （省略可）

出力専用。署名シークレットの切り捨てられたバージョン。

expire_time 文字列  （省略可）

出力専用。署名シークレットの有効期限。

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

出力専用。Webhook の状態。

有効な値:

  • enabled
  • disabled
  • disabled_due_to_failed_deliveries
new_signing_secret 文字列  （省略可）

出力専用。Webhook の新しい署名シークレット。作成時にのみ入力されます。

id 文字列  （省略可）

出力専用。Webhook の ID。

例

返信の例

{
  "name": "string",
  "uri": "string",
  "subscribed_events": [
    "string"
  ],
  "create_time": "string",
  "update_time": "string",
  "signing_secrets": [
    {
      "truncated_secret": "string",
      "expire_time": "string"
    }
  ],
  "state": "enabled",
  "new_signing_secret": "string",
  "id": "string"
}

UpdateWebhook

patch https://generativelanguage.googleapis.com/v1beta/webhooks/{id}

既存の Webhook を更新します。

パス / クエリ パラメータ

id 文字列  （必須）

必須。更新する Webhook の ID。

update_mask 文字列  （省略可）

省略可。更新するフィールドのリスト。

リクエストの本文

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

name string  （省略可）

省略可。ユーザーが指定した Webhook の名前。

uri string  （省略可）

省略可。Webhook イベントの送信先 URI。

subscribed_events 配列（オブジェクトまたは文字列）  （省略可）

省略可。Webhook が登録されているイベント。使用可能なイベント: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

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

省略可。Webhook の状態。

有効な値:

  • enabled
  • disabled
  • disabled_due_to_failed_deliveries

レスポンス

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

name string  （省略可）

省略可。ユーザーが指定した Webhook の名前。

uri string  （省略可）

必須。Webhook イベントの送信先 URI。

subscribed_events 配列（オブジェクトまたは文字列）  （省略可）

必須。Webhook が登録されているイベント。使用可能なイベント: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

create_time 文字列  （省略可）

出力専用。Webhook が作成されたときのタイムスタンプ。

update_time 文字列  （省略可）

出力専用。Webhook が最後に更新されたときのタイムスタンプ。

signing_secrets SigningSecret  （省略可）

出力専用。この Webhook に関連付けられている署名シークレット。

Webhook ペイロードの検証に使用される署名シークレットを表します。

フィールド

truncated_secret 文字列  （省略可）

出力専用。署名シークレットの切り捨てられたバージョン。

expire_time 文字列  （省略可）

出力専用。署名シークレットの有効期限。

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

出力専用。Webhook の状態。

有効な値:

  • enabled
  • disabled
  • disabled_due_to_failed_deliveries
new_signing_secret 文字列  （省略可）

出力専用。Webhook の新しい署名シークレット。作成時にのみ入力されます。

id 文字列  （省略可）

出力専用。Webhook の ID。

例

返信の例

{
  "name": "string",
  "uri": "string",
  "subscribed_events": [
    "string"
  ],
  "create_time": "string",
  "update_time": "string",
  "signing_secrets": [
    {
      "truncated_secret": "string",
      "expire_time": "string"
    }
  ],
  "state": "enabled",
  "new_signing_secret": "string",
  "id": "string"
}

DeleteWebhook

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

Webhook を削除します。

パス / クエリ パラメータ

id 文字列  （必須）

必須。削除する Webhook の ID。形式: `{webhook_id}`

レスポンス

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

例

RotateSigningSecret

post https://generativelanguage.googleapis.com/v1beta/webhooks/{id}:rotateSigningSecret

Webhook の新しい署名シークレットを生成します。

パス / クエリ パラメータ

id 文字列  （必須）

必須。署名シークレットを生成する Webhook の ID。形式: `{webhook_id}`

リクエストの本文

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

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

省略可。以前の署名シークレットの取り消し動作。

有効な値:

  • revoke_previous_secrets_after_h24
  • revoke_previous_secrets_immediately

レスポンス

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

secret string  （省略可）

出力専用。新しく生成された署名シークレット。

例

返信の例

{
  "secret": "string"
}

PingWebhook

post https://generativelanguage.googleapis.com/v1beta/webhooks/{id}:ping

Webhook に ping イベントを送信します。

パス / クエリ パラメータ

id 文字列  （必須）

必須。ping を送信する Webhook の ID。形式: `{webhook_id}`

リクエストの本文

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

レスポンス

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

例

リソース

Webhook

Webhook リソース。

フィールド

name string  （省略可）

省略可。ユーザーが指定した Webhook の名前。

uri string  （省略可）

必須。Webhook イベントの送信先 URI。

subscribed_events 配列（オブジェクトまたは文字列）  （省略可）

必須。Webhook が登録されているイベント。使用可能なイベント: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

create_time 文字列  （省略可）

出力専用。Webhook が作成されたときのタイムスタンプ。

update_time 文字列  （省略可）

出力専用。Webhook が最後に更新されたときのタイムスタンプ。

signing_secrets SigningSecret  （省略可）

出力専用。この Webhook に関連付けられている署名シークレット。

Webhook ペイロードの検証に使用される署名シークレットを表します。

フィールド

truncated_secret 文字列  （省略可）

出力専用。署名シークレットの切り捨てられたバージョン。

expire_time 文字列  （省略可）

出力専用。署名シークレットの有効期限。

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

出力専用。Webhook の状態。

有効な値:

  • enabled
  • disabled
  • disabled_due_to_failed_deliveries
new_signing_secret 文字列  （省略可）

出力専用。Webhook の新しい署名シークレット。作成時にのみ入力されます。

id 文字列  （省略可）

出力専用。Webhook の ID。

データモデル

InteractionSseEvent

可能なタイプ

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

InteractionCreatedEvent

event_type object  （必須）

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

常に "interaction.created" に設定。

interaction Interaction  （必須）

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

Interaction リソース。

フィールド

model ModelOption  （省略可）

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

有効な値:

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

    直接インターフェース操作用に設計されたエージェント機能モデル。Gemini がデジタル環境を認識して操作できるようにします。

  • 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

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

  • gemini-3.1-pro-preview

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

  • gemini-3.1-flash-image-preview

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

  • gemini-3.1-flash-lite-preview

    最も費用対効果の高いモデル。大量のエージェント タスク、翻訳、簡単なデータ処理向けに最適化されています。

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: 強力で低レイテンシの音声生成。自然な出力、ステアリング可能なプロンプト、正確なナレーション制御のための新しい表現力豊かな音声タグをお楽しみください。

  • lyria-3-clip-preview

    高忠実度のオーディオ クリップと正確なリズム制御に最適化された、低レイテンシの音楽生成モデル。

  • lyria-3-pro-preview

    高度なフルソング生成モデル。作曲に関する深い理解を備え、多様な音楽スタイルにわたる正確な構造制御と複雑なトランジションに最適化されています。

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

agent AgentOption  （省略可）

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

有効な値:

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

    Gemini Deep Research エージェント

  • deep-research-preview-04-2026

    Gemini Deep Research エージェント

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

    Gemini Deep Research Max エージェント

操作するエージェント。

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 文字列  （省略可）

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

system_instruction 文字列  （省略可）

対応のシステム指示。

tools Tool  （省略可）

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

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

可能なタイプ

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

関数

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

type object  （必須）

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

常に "function" に設定。

name string  （省略可）

関数名。

説明 文字列  （省略可）

関数の説明。

parameters object  （省略可）

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

CodeExecution

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

type object  （必須）

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

常に "code_execution" に設定。

UrlContext

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

type object  （必須）

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

常に "url_context" に設定。

ComputerUse

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

type object  （必須）

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

常に "computer_use" に設定。

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

運用中の環境。

有効な値:

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

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

McpServer

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

type object  （必須）

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

常に "mcp_server" に設定。

name string  （省略可）

MCPServer の名前。

url 文字列  （省略可）

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

headers object  （省略可）

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

allowed_tools AllowedTools  （省略可）

許可されているツール。

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

フィールド

mode ToolChoiceType  （省略可）

ツール選択のモード。

有効な値:

  • auto
  • any
  • none
  • validated

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

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

GoogleSearch

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

type object  （必須）

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

常に "google_search" に設定。

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

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

有効な値:

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

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

type object  （必須）

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

常に "file_search" に設定。

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

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

top_k 整数  （省略可）

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

metadata_filter 文字列  （省略可）

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

GoogleMaps

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

type object  （必須）

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

常に "google_maps" に設定。

enable_widget ブール値  （省略可）

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

latitude number  （省略可）

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

longitude number  （省略可）

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

取得

モデルがファイルを取得するために使用できるツール。

type object  （必須）

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

常に "retrieval" に設定。

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

有効にするファイル取得の種類。

有効な値:

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig  （省略可）

VertexAISearch の構成を指定するために使用されます。

VertexAISearch の構成を指定するために使用されます。

フィールド

engine 文字列  （省略可）

省略可。Vertex AI Search エンジンを指定するために使用されます。

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

省略可。Vertex AI Search データストアを指定するために使用されます。

usage Usage  （省略可）

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

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

フィールド

total_input_tokens integer  （省略可）

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

input_tokens_by_modality ModalityTokens  (省略可)

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

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

フィールド

modality ResponseModality  （省略可）

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

有効な値:

  • text
  • image
  • audio
  • video
  • document

トークン 整数  （省略可）

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

total_cached_tokens integer  （省略可）

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

cached_tokens_by_modality ModalityTokens  （省略可）

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

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

フィールド

modality ResponseModality  （省略可）

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

有効な値:

  • text
  • image
  • audio
  • video
  • document

トークン 整数  （省略可）

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

total_output_tokens integer  （省略可）

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

output_tokens_by_modality ModalityTokens  （省略可）

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

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

フィールド

modality ResponseModality  （省略可）

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

有効な値:

  • text
  • image
  • audio
  • video
  • document

トークン 整数  （省略可）

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

total_tool_use_tokens integer  （省略可）

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

tool_use_tokens_by_modality ModalityTokens  （省略可）

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

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

フィールド

modality ResponseModality  （省略可）

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

有効な値:

  • text
  • image
  • audio
  • video
  • document

トークン 整数  （省略可）

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

total_thought_tokens 整数  （省略可）

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

total_tokens integer  （省略可）

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

grounding_tool_count GroundingToolCount  （省略可）

グラウンディング ツールの数。

接地ツールの数。

フィールド

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

カウントに関連付けられているグラウンディング ツールのタイプ。

有効な値:

  • google_search
  • google_maps
  • retrieval
count 整数  （省略可）

接地ツールの数。

response_modalities ResponseModality  （省略可）

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

有効な値:

  • text
  • image
  • audio
  • video
  • document

response_mime_type 文字列  （省略可）

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

previous_interaction_id string  （省略可）

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

service_tier ServiceTier  （省略可）

インタラクションのサービス階層。

有効な値:

  • flex
  • standard
  • priority

webhook_config WebhookConfig  （省略可）

省略可。インタラクションが完了したときに通知を受け取るための Webhook 構成。

リクエストの webhook イベントを構成するためのメッセージ。

フィールド

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

省略可。設定すると、登録済みの Webhook の代わりに、これらの Webhook URI が Webhook イベントに使用されます。

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

省略可。各イベントの Webhook への送信時に返されるユーザー メタデータ。

steps Step  （省略可）

出力専用。インタラクションを構成する手順。

インタラクションのステップ。

可能なタイプ

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

UserInputStep

ユーザーが提供した入力。

type object  （必須）

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

常に "user_input" に設定。

content Content  （省略可）

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

レスポンスの内容。

可能なタイプ

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

TextContent

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

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

必須。テキスト コンテンツ。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

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

常に "place_citation" に設定。

place_id 文字列  （省略可）

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

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

ImageContent

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

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

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

画像の 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

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

type object  （必須）

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

常に "audio" に設定。

data 文字列  （省略可）

音声コンテンツ。

uri string  （省略可）

音声の URI。

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

音声の 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
channels integer  （省略可）

音声チャンネルの数。

sample_rate integer  （省略可）

音声のサンプルレート。

DocumentContent

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

type object  （必須）

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

常に "document" に設定。

data 文字列  （省略可）

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

uri string  （省略可）

ドキュメントの URI。

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

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

有効な値:

  • application/pdf
VideoContent

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

type object  （必須）

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

常に "video" に設定。

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

ModelOutputStep

モデルによって生成された出力。

type object  （必須）

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

常に "model_output" に設定。

content Content  （省略可）

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

レスポンスの内容。

可能なタイプ

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

TextContent

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

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

必須。テキスト コンテンツ。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

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

常に "place_citation" に設定。

place_id 文字列  （省略可）

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

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

ImageContent

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

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

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

画像の 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

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

type object  （必須）

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

常に "audio" に設定。

data 文字列  （省略可）

音声コンテンツ。

uri string  （省略可）

音声の URI。

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

音声の 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
channels integer  （省略可）

音声チャンネルの数。

sample_rate integer  （省略可）

音声のサンプルレート。

DocumentContent

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

type object  （必須）

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

常に "document" に設定。

data 文字列  （省略可）

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

uri string  （省略可）

ドキュメントの URI。

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

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

有効な値:

  • application/pdf
VideoContent

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

type object  （必須）

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

常に "video" に設定。

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

ThoughtStep

思考ステップ。

type object  （必須）

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

常に "thought" に設定。

signature string  （省略可）

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

summary ThoughtSummaryContent  （省略可）

考えの要約。

可能なタイプ

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

TextContent

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

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

必須。テキスト コンテンツ。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

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

常に "place_citation" に設定。

place_id 文字列  （省略可）

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

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

ImageContent

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

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

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

画像の 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

関数ツール呼び出しステップ。

type object  （必須）

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

常に "function_call" に設定。

name string  （必須）

必須。呼び出すツールの名前。

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

必須。関数に渡す引数。

id 文字列  （必須）

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

signature string  （省略可）

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

CodeExecutionCallStep

コード実行の呼び出しステップ。

type object  （必須）

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

常に "code_execution_call" に設定。

arguments CodeExecutionCallStepArguments  （必須）

必須。コード実行に渡す引数。

コード実行に渡す引数。

フィールド

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

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

有効な値:

  • python
code 文字列  （省略可）

実行されるコード。

id 文字列  （必須）

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

signature string  （省略可）

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

UrlContextCallStep

URL コンテキスト呼び出しステップ。

type object  （必須）

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

常に "url_context_call" に設定。

arguments UrlContextCallStepArguments  （必須）

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

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

フィールド

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

取得する URL。

id 文字列  （必須）

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

signature string  （省略可）

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

McpServerToolCallStep

MCPServer ツール呼び出しステップ。

type object  （必須）

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

常に "mcp_server_tool_call" に設定。

name string  （必須）

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

server_name string  （必須）

必須。使用される MCP サーバーの名前。

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

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

id 文字列  （必須）

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

signature string  （省略可）

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

GoogleSearchCallStep

Google 検索の呼び出しステップ。

type object  （必須）

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

常に "google_search_call" に設定。

arguments GoogleSearchCallStepArguments  （必須）

必須。Google 検索に渡す引数。

Google 検索に渡す引数。

フィールド

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

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

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

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

有効な値:

  • web_search
  • image_search
  • enterprise_web_search
id 文字列  （必須）

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

signature string  （省略可）

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

FileSearchCallStep

ファイル検索のコールステップ。

type object  （必須）

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

常に "file_search_call" に設定。

id 文字列  （必須）

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

signature string  （省略可）

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

GoogleMapsCallStep

Google マップの通話ステップ。

type object  （必須）

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

常に "google_maps_call" に設定。

arguments GoogleMapsCallStepArguments  (省略可)

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

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

フィールド

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

実行するクエリ。

id 文字列  （必須）

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

signature string  （省略可）

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

FunctionResultStep

関数ツールの呼び出しの結果。

type object  （必須）

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

常に "function_result" に設定。

name string  （省略可）

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

is_error ブール値  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

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

ツール呼び出しの結果。

CodeExecutionResultStep

コード実行結果のステップ。

type object  （必須）

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

常に "code_execution_result" に設定。

result string  （必須）

必須。コード実行の出力。

is_error ブール値  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

UrlContextResultStep

URL コンテキストの結果ステップ。

type object  （必須）

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

常に "url_context_result" に設定。

result UrlContextResultItem  （必須）

必須。URL コンテキストの結果。

URL コンテキストの結果。

フィールド

url 文字列  （省略可）

取得された URL。

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

URL 取得のステータス。

有効な値:

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

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

call_id string  （必須）

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

signature string  （省略可）

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

GoogleSearchResultStep

Google 検索の検索結果ステップ。

type object  （必須）

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

常に "google_search_result" に設定。

result GoogleSearchResultItem  （必須）

必須。Google 検索の結果。

Google 検索の結果。

フィールド

search_suggestions 文字列  （省略可）

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

is_error ブール値  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

McpServerToolResultStep

MCPServer ツール結果ステップ。

type object  （必須）

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

常に "mcp_server_tool_result" に設定。

name string  （省略可）

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

server_name 文字列  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

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

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

FileSearchResultStep

ファイル検索結果の手順。

type object  （必須）

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

常に "file_search_result" に設定。

call_id string  （必須）

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

signature string  （省略可）

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

GoogleMapsResultStep

Google マップの結果ステップ。

type object  （必須）

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

常に "google_maps_result" に設定。

result GoogleMapsResultItem  （必須）

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

Google マップの結果。

フィールド

places GoogleMapsResultPlaces  （省略可）

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

フィールド

place_id 文字列  （省略可）

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

name string  （省略可）

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

url 文字列  （省略可）

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

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

widget_context_token string  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

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

インタラクションの入力。

response_format ResponseFormat または ResponseFormatList  （省略可）

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

agent_config object  （省略可）

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

可能なタイプ

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

DynamicAgentConfig

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

type object  （必須）

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

常に "dynamic" に設定。

DeepResearchAgentConfig

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

type object  （必須）

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

常に "deep-research" に設定。

thinking_summaries ThinkingSummaries  （省略可）

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

有効な値:

  • auto
  • none

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

レスポンスに可視化を含めるかどうか。

有効な値:

  • off
  • auto
collaborative_planning ブール値  （省略可）

Deep Research エージェントの人間参加型プランニングを有効にします。true に設定すると、Deep Research エージェントはレスポンスでリサーチプランを提供します。エージェントは、次のターンでお客様がプランを確認した場合にのみ続行します。

event_id 文字列  （省略可）

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

InteractionCompletedEvent

event_type object  （必須）

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

常に "interaction.completed" に設定。

interaction Interaction  （必須）

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

Interaction リソース。

フィールド

model ModelOption  （省略可）

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

有効な値:

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

    直接インターフェース操作用に設計されたエージェント機能モデル。Gemini がデジタル環境を認識して操作できるようにします。

  • 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

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

  • gemini-3.1-pro-preview

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

  • gemini-3.1-flash-image-preview

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

  • gemini-3.1-flash-lite-preview

    最も費用対効果の高いモデル。大量のエージェント タスク、翻訳、簡単なデータ処理向けに最適化されています。

  • gemini-3.1-flash-tts-preview

    Gemini 3.1 Flash TTS: 強力で低レイテンシの音声生成。自然な出力、ステアリング可能なプロンプト、正確なナレーション制御のための新しい表現力豊かな音声タグをお楽しみください。

  • lyria-3-clip-preview

    高忠実度のオーディオ クリップと正確なリズム制御に最適化された、低レイテンシの音楽生成モデル。

  • lyria-3-pro-preview

    高度なフルソング生成モデル。作曲に関する深い理解を備え、多様な音楽スタイルにわたる正確な構造制御と複雑なトランジションに最適化されています。

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

agent AgentOption  （省略可）

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

有効な値:

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

    Gemini Deep Research エージェント

  • deep-research-preview-04-2026

    Gemini Deep Research エージェント

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

    Gemini Deep Research Max エージェント

操作するエージェント。

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 文字列  （省略可）

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

system_instruction 文字列  （省略可）

対応のシステム指示。

tools Tool  （省略可）

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

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

可能なタイプ

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

関数

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

type object  （必須）

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

常に "function" に設定。

name string  （省略可）

関数名。

説明 文字列  （省略可）

関数の説明。

parameters object  （省略可）

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

CodeExecution

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

type object  （必須）

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

常に "code_execution" に設定。

UrlContext

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

type object  （必須）

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

常に "url_context" に設定。

ComputerUse

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

type object  （必須）

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

常に "computer_use" に設定。

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

運用中の環境。

有効な値:

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

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

McpServer

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

type object  （必須）

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

常に "mcp_server" に設定。

name string  （省略可）

MCPServer の名前。

url 文字列  （省略可）

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

headers object  （省略可）

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

allowed_tools AllowedTools  （省略可）

許可されているツール。

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

フィールド

mode ToolChoiceType  （省略可）

ツール選択のモード。

有効な値:

  • auto
  • any
  • none
  • validated

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

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

GoogleSearch

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

type object  （必須）

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

常に "google_search" に設定。

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

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

有効な値:

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

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

type object  （必須）

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

常に "file_search" に設定。

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

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

top_k 整数  （省略可）

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

metadata_filter 文字列  （省略可）

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

GoogleMaps

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

type object  （必須）

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

常に "google_maps" に設定。

enable_widget ブール値  （省略可）

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

latitude number  （省略可）

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

longitude number  （省略可）

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

取得

モデルがファイルを取得するために使用できるツール。

type object  （必須）

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

常に "retrieval" に設定。

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

有効にするファイル取得の種類。

有効な値:

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig  （省略可）

VertexAISearch の構成を指定するために使用されます。

VertexAISearch の構成を指定するために使用されます。

フィールド

engine 文字列  （省略可）

省略可。Vertex AI Search エンジンを指定するために使用されます。

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

省略可。Vertex AI Search データストアを指定するために使用されます。

usage Usage  （省略可）

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

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

フィールド

total_input_tokens integer  （省略可）

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

input_tokens_by_modality ModalityTokens  (省略可)

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

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

フィールド

modality ResponseModality  （省略可）

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

有効な値:

  • text
  • image
  • audio
  • video
  • document

トークン 整数  （省略可）

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

total_cached_tokens integer  （省略可）

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

cached_tokens_by_modality ModalityTokens  （省略可）

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

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

フィールド

modality ResponseModality  （省略可）

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

有効な値:

  • text
  • image
  • audio
  • video
  • document

トークン 整数  （省略可）

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

total_output_tokens integer  （省略可）

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

output_tokens_by_modality ModalityTokens  （省略可）

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

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

フィールド

modality ResponseModality  （省略可）

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

有効な値:

  • text
  • image
  • audio
  • video
  • document

トークン 整数  （省略可）

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

total_tool_use_tokens integer  （省略可）

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

tool_use_tokens_by_modality ModalityTokens  （省略可）

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

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

フィールド

modality ResponseModality  （省略可）

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

有効な値:

  • text
  • image
  • audio
  • video
  • document

トークン 整数  （省略可）

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

total_thought_tokens 整数  （省略可）

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

total_tokens integer  （省略可）

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

grounding_tool_count GroundingToolCount  （省略可）

グラウンディング ツールの数。

接地ツールの数。

フィールド

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

カウントに関連付けられているグラウンディング ツールのタイプ。

有効な値:

  • google_search
  • google_maps
  • retrieval
count 整数  （省略可）

接地ツールの数。

response_modalities ResponseModality  （省略可）

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

有効な値:

  • text
  • image
  • audio
  • video
  • document

response_mime_type 文字列  （省略可）

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

previous_interaction_id string  （省略可）

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

service_tier ServiceTier  （省略可）

インタラクションのサービス階層。

有効な値:

  • flex
  • standard
  • priority

webhook_config WebhookConfig  （省略可）

省略可。インタラクションが完了したときに通知を受け取るための Webhook 構成。

リクエストの webhook イベントを構成するためのメッセージ。

フィールド

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

省略可。設定すると、登録済みの Webhook の代わりに、これらの Webhook URI が Webhook イベントに使用されます。

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

省略可。各イベントの Webhook への送信時に返されるユーザー メタデータ。

steps Step  （省略可）

出力専用。インタラクションを構成する手順。

インタラクションのステップ。

可能なタイプ

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

UserInputStep

ユーザーが提供した入力。

type object  （必須）

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

常に "user_input" に設定。

content Content  （省略可）

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

レスポンスの内容。

可能なタイプ

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

TextContent

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

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

必須。テキスト コンテンツ。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

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

常に "place_citation" に設定。

place_id 文字列  （省略可）

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

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

ImageContent

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

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

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

画像の 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

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

type object  （必須）

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

常に "audio" に設定。

data 文字列  （省略可）

音声コンテンツ。

uri string  （省略可）

音声の URI。

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

音声の 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
channels integer  （省略可）

音声チャンネルの数。

sample_rate integer  （省略可）

音声のサンプルレート。

DocumentContent

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

type object  （必須）

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

常に "document" に設定。

data 文字列  （省略可）

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

uri string  （省略可）

ドキュメントの URI。

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

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

有効な値:

  • application/pdf
VideoContent

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

type object  （必須）

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

常に "video" に設定。

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

ModelOutputStep

モデルによって生成された出力。

type object  （必須）

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

常に "model_output" に設定。

content Content  （省略可）

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

レスポンスの内容。

可能なタイプ

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

TextContent

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

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

必須。テキスト コンテンツ。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

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

常に "place_citation" に設定。

place_id 文字列  （省略可）

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

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

ImageContent

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

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

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

画像の 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

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

type object  （必須）

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

常に "audio" に設定。

data 文字列  （省略可）

音声コンテンツ。

uri string  （省略可）

音声の URI。

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

音声の 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
channels integer  （省略可）

音声チャンネルの数。

sample_rate integer  （省略可）

音声のサンプルレート。

DocumentContent

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

type object  （必須）

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

常に "document" に設定。

data 文字列  （省略可）

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

uri string  （省略可）

ドキュメントの URI。

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

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

有効な値:

  • application/pdf
VideoContent

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

type object  （必須）

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

常に "video" に設定。

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

ThoughtStep

思考ステップ。

type object  （必須）

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

常に "thought" に設定。

signature string  （省略可）

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

summary ThoughtSummaryContent  （省略可）

考えの要約。

可能なタイプ

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

TextContent

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

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

必須。テキスト コンテンツ。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

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

常に "place_citation" に設定。

place_id 文字列  （省略可）

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

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

ImageContent

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

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

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

画像の 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

関数ツール呼び出しステップ。

type object  （必須）

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

常に "function_call" に設定。

name string  （必須）

必須。呼び出すツールの名前。

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

必須。関数に渡す引数。

id 文字列  （必須）

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

signature string  （省略可）

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

CodeExecutionCallStep

コード実行の呼び出しステップ。

type object  （必須）

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

常に "code_execution_call" に設定。

arguments CodeExecutionCallStepArguments  （必須）

必須。コード実行に渡す引数。

コード実行に渡す引数。

フィールド

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

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

有効な値:

  • python
code 文字列  （省略可）

実行されるコード。

id 文字列  （必須）

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

signature string  （省略可）

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

UrlContextCallStep

URL コンテキスト呼び出しステップ。

type object  （必須）

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

常に "url_context_call" に設定。

arguments UrlContextCallStepArguments  （必須）

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

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

フィールド

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

取得する URL。

id 文字列  （必須）

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

signature string  （省略可）

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

McpServerToolCallStep

MCPServer ツール呼び出しステップ。

type object  （必須）

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

常に "mcp_server_tool_call" に設定。

name string  （必須）

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

server_name string  （必須）

必須。使用される MCP サーバーの名前。

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

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

id 文字列  （必須）

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

signature string  （省略可）

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

GoogleSearchCallStep

Google 検索の呼び出しステップ。

type object  （必須）

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

常に "google_search_call" に設定。

arguments GoogleSearchCallStepArguments  （必須）

必須。Google 検索に渡す引数。

Google 検索に渡す引数。

フィールド

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

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

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

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

有効な値:

  • web_search
  • image_search
  • enterprise_web_search
id 文字列  （必須）

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

signature string  （省略可）

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

FileSearchCallStep

ファイル検索のコールステップ。

type object  （必須）

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

常に "file_search_call" に設定。

id 文字列  （必須）

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

signature string  （省略可）

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

GoogleMapsCallStep

Google マップの通話ステップ。

type object  （必須）

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

常に "google_maps_call" に設定。

arguments GoogleMapsCallStepArguments  (省略可)

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

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

フィールド

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

実行するクエリ。

id 文字列  （必須）

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

signature string  （省略可）

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

FunctionResultStep

関数ツールの呼び出しの結果。

type object  （必須）

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

常に "function_result" に設定。

name string  （省略可）

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

is_error ブール値  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

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

ツール呼び出しの結果。

CodeExecutionResultStep

コード実行結果のステップ。

type object  （必須）

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

常に "code_execution_result" に設定。

result string  （必須）

必須。コード実行の出力。

is_error ブール値  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

UrlContextResultStep

URL コンテキストの結果ステップ。

type object  （必須）

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

常に "url_context_result" に設定。

result UrlContextResultItem  （必須）

必須。URL コンテキストの結果。

URL コンテキストの結果。

フィールド

url 文字列  （省略可）

取得された URL。

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

URL 取得のステータス。

有効な値:

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

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

call_id string  （必須）

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

signature string  （省略可）

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

GoogleSearchResultStep

Google 検索の検索結果ステップ。

type object  （必須）

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

常に "google_search_result" に設定。

result GoogleSearchResultItem  （必須）

必須。Google 検索の結果。

Google 検索の結果。

フィールド

search_suggestions 文字列  （省略可）

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

is_error ブール値  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

McpServerToolResultStep

MCPServer ツール結果ステップ。

type object  （必須）

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

常に "mcp_server_tool_result" に設定。

name string  （省略可）

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

server_name 文字列  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

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

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

FileSearchResultStep

ファイル検索結果の手順。

type object  （必須）

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

常に "file_search_result" に設定。

call_id string  （必須）

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

signature string  （省略可）

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

GoogleMapsResultStep

Google マップの結果ステップ。

type object  （必須）

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

常に "google_maps_result" に設定。

result GoogleMapsResultItem  （必須）

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

Google マップの結果。

フィールド

places GoogleMapsResultPlaces  （省略可）

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

フィールド

place_id 文字列  （省略可）

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

name string  （省略可）

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

url 文字列  （省略可）

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

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

widget_context_token string  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

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

インタラクションの入力。

response_format ResponseFormat または ResponseFormatList  （省略可）

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

agent_config object  （省略可）

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

可能なタイプ

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

DynamicAgentConfig

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

type object  （必須）

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

常に "dynamic" に設定。

DeepResearchAgentConfig

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

type object  （必須）

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

常に "deep-research" に設定。

thinking_summaries ThinkingSummaries  （省略可）

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

有効な値:

  • auto
  • none

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

レスポンスに可視化を含めるかどうか。

有効な値:

  • off
  • auto
collaborative_planning ブール値  （省略可）

Deep Research エージェントの人間参加型プランニングを有効にします。true に設定すると、Deep Research エージェントはレスポンスでリサーチプランを提供します。エージェントは、次のターンでお客様がプランを確認した場合にのみ続行します。

event_id 文字列  （省略可）

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

InteractionStatusUpdate

event_type object  （必須）

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

常に "interaction.status_update" に設定。

interaction_id string  （必須）

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

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

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

有効な値:

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

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

ErrorEvent

event_type object  （必須）

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

常に "error" に設定。

error Error  （省略可）

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

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

フィールド

code 文字列  （省略可）

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

message string  （省略可）

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

event_id 文字列  （省略可）

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

StepStart

event_type object  （必須）

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

常に "step.start" に設定。

index integer  （必須）

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

step Step  （必須）

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

インタラクションのステップ。

可能なタイプ

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

UserInputStep

ユーザーが提供した入力。

type object  （必須）

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

常に "user_input" に設定。

content Content  （省略可）

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

レスポンスの内容。

可能なタイプ

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

TextContent

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

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

必須。テキスト コンテンツ。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

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

常に "place_citation" に設定。

place_id 文字列  （省略可）

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

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

ImageContent

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

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

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

画像の 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

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

type object  （必須）

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

常に "audio" に設定。

data 文字列  （省略可）

音声コンテンツ。

uri string  （省略可）

音声の URI。

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

音声の 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
channels integer  （省略可）

音声チャンネルの数。

sample_rate integer  （省略可）

音声のサンプルレート。

DocumentContent

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

type object  （必須）

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

常に "document" に設定。

data 文字列  （省略可）

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

uri string  （省略可）

ドキュメントの URI。

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

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

有効な値:

  • application/pdf
VideoContent

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

type object  （必須）

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

常に "video" に設定。

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

ModelOutputStep

モデルによって生成された出力。

type object  （必須）

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

常に "model_output" に設定。

content Content  （省略可）

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

レスポンスの内容。

可能なタイプ

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

TextContent

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

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

必須。テキスト コンテンツ。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

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

常に "place_citation" に設定。

place_id 文字列  （省略可）

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

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

ImageContent

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

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

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

画像の 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

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

type object  （必須）

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

常に "audio" に設定。

data 文字列  （省略可）

音声コンテンツ。

uri string  （省略可）

音声の URI。

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

音声の 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
channels integer  （省略可）

音声チャンネルの数。

sample_rate integer  （省略可）

音声のサンプルレート。

DocumentContent

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

type object  （必須）

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

常に "document" に設定。

data 文字列  （省略可）

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

uri string  （省略可）

ドキュメントの URI。

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

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

有効な値:

  • application/pdf
VideoContent

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

type object  （必須）

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

常に "video" に設定。

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

ThoughtStep

思考ステップ。

type object  （必須）

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

常に "thought" に設定。

signature string  （省略可）

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

summary ThoughtSummaryContent  （省略可）

考えの要約。

可能なタイプ

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

TextContent

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

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

必須。テキスト コンテンツ。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

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

常に "place_citation" に設定。

place_id 文字列  （省略可）

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

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

ImageContent

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

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

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

画像の 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

関数ツール呼び出しステップ。

type object  （必須）

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

常に "function_call" に設定。

name string  （必須）

必須。呼び出すツールの名前。

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

必須。関数に渡す引数。

id 文字列  （必須）

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

signature string  （省略可）

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

CodeExecutionCallStep

コード実行の呼び出しステップ。

type object  （必須）

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

常に "code_execution_call" に設定。

arguments CodeExecutionCallStepArguments  （必須）

必須。コード実行に渡す引数。

コード実行に渡す引数。

フィールド

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

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

有効な値:

  • python
code 文字列  （省略可）

実行されるコード。

id 文字列  （必須）

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

signature string  （省略可）

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

UrlContextCallStep

URL コンテキスト呼び出しステップ。

type object  （必須）

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

常に "url_context_call" に設定。

arguments UrlContextCallStepArguments  （必須）

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

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

フィールド

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

取得する URL。

id 文字列  （必須）

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

signature string  （省略可）

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

McpServerToolCallStep

MCPServer ツール呼び出しステップ。

type object  （必須）

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

常に "mcp_server_tool_call" に設定。

name string  （必須）

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

server_name string  （必須）

必須。使用される MCP サーバーの名前。

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

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

id 文字列  （必須）

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

signature string  （省略可）

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

GoogleSearchCallStep

Google 検索の呼び出しステップ。

type object  （必須）

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

常に "google_search_call" に設定。

arguments GoogleSearchCallStepArguments  （必須）

必須。Google 検索に渡す引数。

Google 検索に渡す引数。

フィールド

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

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

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

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

有効な値:

  • web_search
  • image_search
  • enterprise_web_search
id 文字列  （必須）

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

signature string  （省略可）

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

FileSearchCallStep

ファイル検索のコールステップ。

type object  （必須）

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

常に "file_search_call" に設定。

id 文字列  （必須）

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

signature string  （省略可）

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

GoogleMapsCallStep

Google マップの通話ステップ。

type object  （必須）

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

常に "google_maps_call" に設定。

arguments GoogleMapsCallStepArguments  (省略可)

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

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

フィールド

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

実行するクエリ。

id 文字列  （必須）

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

signature string  （省略可）

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

FunctionResultStep

関数ツールの呼び出しの結果。

type object  （必須）

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

常に "function_result" に設定。

name string  （省略可）

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

is_error ブール値  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

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

ツール呼び出しの結果。

CodeExecutionResultStep

コード実行結果のステップ。

type object  （必須）

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

常に "code_execution_result" に設定。

result string  （必須）

必須。コード実行の出力。

is_error ブール値  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

UrlContextResultStep

URL コンテキストの結果ステップ。

type object  （必須）

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

常に "url_context_result" に設定。

result UrlContextResultItem  （必須）

必須。URL コンテキストの結果。

URL コンテキストの結果。

フィールド

url 文字列  （省略可）

取得された URL。

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

URL 取得のステータス。

有効な値:

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

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

call_id string  （必須）

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

signature string  （省略可）

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

GoogleSearchResultStep

Google 検索の検索結果ステップ。

type object  （必須）

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

常に "google_search_result" に設定。

result GoogleSearchResultItem  （必須）

必須。Google 検索の結果。

Google 検索の結果。

フィールド

search_suggestions 文字列  （省略可）

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

is_error ブール値  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

McpServerToolResultStep

MCPServer ツール結果ステップ。

type object  （必須）

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

常に "mcp_server_tool_result" に設定。

name string  （省略可）

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

server_name 文字列  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

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

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

FileSearchResultStep

ファイル検索結果の手順。

type object  （必須）

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

常に "file_search_result" に設定。

call_id string  （必須）

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

signature string  （省略可）

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

GoogleMapsResultStep

Google マップの結果ステップ。

type object  （必須）

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

常に "google_maps_result" に設定。

result GoogleMapsResultItem  （必須）

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

Google マップの結果。

フィールド

places GoogleMapsResultPlaces  （省略可）

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

フィールド

place_id 文字列  （省略可）

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

name string  （省略可）

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

url 文字列  （省略可）

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

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

widget_context_token string  （省略可）

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

call_id string  （必須）

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

signature string  （省略可）

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

event_id 文字列  （省略可）

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

StepDelta

event_type object  （必須）

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

常に "step.delta" に設定。

index integer  （必須）

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

delta StepDeltaData  （必須）

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

可能なタイプ

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

TextDelta

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

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

ImageDelta

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

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

uri string  （省略可）

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

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

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

有効な値:

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

メディアの解像度。

有効な値:

  • low
  • medium
  • high
  • ultra_high

AudioDelta

type object  （必須）

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

常に "audio" に設定。

data 文字列  （省略可）

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

uri string  （省略可）

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

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

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

有効な値:

  • 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 整数  （省略可）

非推奨です。代わりに sample_rate を使用してください。この値は無視されます。

sample_rate integer  （省略可）

音声のサンプルレート。

channels integer  （省略可）

音声チャンネルの数。

DocumentDelta

type object  （必須）

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

常に "document" に設定。

data 文字列  （省略可）

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

uri string  （省略可）

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

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

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

有効な値:

  • application/pdf
VideoDelta

type object  （必須）

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

常に "video" に設定。

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

ThoughtSummaryDelta

type object  （必須）

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

常に "thought_summary" に設定。

content ThoughtSummaryContent  （省略可）

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

可能なタイプ

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

TextContent

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

type object  （必須）

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

常に "text" に設定。

text 文字列  （必須）

必須。テキスト コンテンツ。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

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

常に "place_citation" に設定。

place_id 文字列  （省略可）

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

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

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

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

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

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

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

ImageContent

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

type object  （必須）

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

常に "image" に設定。

data 文字列  （省略可）

画像コンテンツ。

uri string  （省略可）

画像の URI。

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

画像の 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

type object  （必須）

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

常に "thought_signature" に設定。

signature string  （省略可）

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

TextAnnotationDelta

type object  （必須）

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

常に "text_annotation_delta" に設定。

annotations Annotation  （省略可）

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

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

可能なタイプ

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

UrlCitation

URL 引用アノテーション。

type object  （必須）

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

常に "url_citation" に設定。

url 文字列  （省略可）

URL。

title string  （省略可）

URL のタイトル。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

FileCitation

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

type object  （必須）

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

常に "file_citation" に設定。

document_uri 文字列  （省略可）

ファイルの URI。

file_name string  （省略可）

ファイルの名前。

source 文字列  （省略可）

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

custom_metadata object  （省略可）

ユーザーが取得したコンテキストに関するメタデータを提供しました。

page_number integer  （省略可）

引用したドキュメントのページ番号（該当する場合）。

media_id 文字列  （省略可）

画像引用の場合のメディア ID（該当する場合）。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

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

PlaceCitation

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

type object  （必須）

説明が入力されていません。

常に "place_citation" に設定。

place_id 文字列  （省略可）

場所の ID。`places/{place_id}` 形式です。

name string  （省略可）

場所のタイトル。

url 文字列  （省略可）

場所の URI 参照。

review_snippets ReviewSnippet  （省略可）

Google マップの特定の場所の特徴に関する回答の生成に使用されるクチコミのスニペット。

Google マップの特定の場所の機能に関する質問に回答するユーザー レビューのスニペットをカプセル化します。

フィールド

title string  （省略可）

レビューのタイトル。

url 文字列  （省略可）

Google マップのユーザー レビューに対応するリンク。

review_id 文字列  （省略可）

クチコミ抜粋の ID。

start_index integer  （省略可）

このソースに帰属するレスポンスのセグメントの開始。インデックスはセグメントの開始位置を示し、バイト単位で測定されます。

end_index integer  （省略可）

帰属セグメントの終了位置（この位置自体は含みません）。

ArgumentsDelta

type object  （必須）

説明が入力されていません。

常に "arguments_delta" に設定。

partial_arguments 文字列  （省略可）

説明が入力されていません。

event_id 文字列  （省略可）

このイベントからインタラクション ストリームを再開するために使用される event_id トークン。

StepStop

event_type object  （必須）

説明が入力されていません。

常に "step.stop" に設定。

index integer  （必須）

説明が入力されていません。

event_id 文字列  （省略可）

このイベントからインタラクション ストリームを再開するために使用される 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
}