Gemini v1beta の Interactions API が破壊的変更——`outputs` から `steps` へのスキーマ移行で 6 月 8 日以降に旧版廃止

概要

Google は 2026 年 5 月 26 日付けで、Gemini API の v1beta Interactions API に対して重要なスキーマ変更を実施した。主要な変更点は①レスポンスの outputs 配列が steps スキーマへ変更されたこと、②response_format フィールドの統合・簡素化、の 2 点。5 月 26 日から新仕様がデフォルトとなり、旧来の挙動は 2026 年 6 月 8 日に完全廃止される。Gemini API を使ったエージェント型アプリケーションやプロダクションシステムを持つ開発者は対応が必要。

※本記事は公開情報をもとに編集部が再構成したサマリです。一次情報は出典欄をご参照ください。

事実のポイント

• 変更対象: Gemini API v1beta の Interactions API エンドポイント
• 主要変更①: レスポンス構造の outputs 配列が steps スキーマへリネーム・再編。各ステップの詳細情報（ツール呼び出し結果・中間出力等）の構造が変わる
• 主要変更②: response_format フィールドの仕様統合。散在していたフォーマット指定オプションが統一されたフィールドに集約
• 移行タイムライン:
  • 5 月 26 日: 新仕様がデフォルト動作になる
  • 6 月 8 日: 旧来のレスポンス形式（outputs 形式）の提供を完全停止
• 影響対象: Gemini API の Interactions エンドポイントを v1beta で呼び出しているすべてのアプリケーション・サービス
• 公式マイグレーションガイド: ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026 に対応方法が記載

用語・背景の補足

Gemini Interactions API: Google Gemini のマルチターン・ツール使用・エージェント型インタラクションを管理するための API エンドポイント群。複数のツール呼び出しや推論ステップを持つ複雑なタスクに利用される。

v1beta: Google の API バージョニングにおけるベータ版ラベル。正式安定版（v1）への移行前の段階で、破壊的変更が発生しやすい。本番環境での利用は v1 ステーブルが推奨されるが、最新機能はまず v1beta で提供される。

破壊的変更（Breaking Change）: 既存の API 呼び出しコードを修正なしでは動作しなくなるような変更。フィールドのリネーム・削除・データ型の変更などが典型例。移行期間が設定されることが多い。

注意点

• 旧形式（outputs）の廃止期限は 6 月 8 日であり、対応が遅れると本番システムが障害を起こす可能性がある
• v1beta を利用するすべての Gemini 連携サービスで影響が発生しうる
• Google の公式マイグレーションガイドを最初に確認し、実際のコードへの影響範囲を事前に特定することが推奨される
• v1 ステーブル版が利用可能な場合は、v1beta から v1 への移行も検討に値する

編集部見解

（追記予定）