API 統合と Code Assist ツールキットを使用して、Merchant API への移行を加速させ、AI を活用した開発ツールで新しい統合を構築します。
概要
Content API for Shopping から Merchant API に移行する場合や、新しい統合を構築する場合は、新しいサービス構造、リソース名、メソッドを理解する必要があります。AI 搭載の開発ツールは、特に次のオペレーションの支援に適しています。
- コードの変換と移行: 以前の Content API for Shopping のコードを新しい Merchant API の形式に変換する際に役立ちます。これには、プロダクト属性を新しい構造にマッピングし、依存関係管理ファイルを更新することが含まれます。
- API ドキュメントの専門知識: Google の公式 API ドキュメントの信頼できるコンテキストに基づいて、Merchant API のリソース、メソッド、フィールド、割り当て、ベスト プラクティスを明確に説明します。
- コード生成: Python、Java、PHP などの言語で、さまざまな Merchant API タスクのコード スニペットを生成します。
- トラブルシューティング: 一般的な API エラーの診断と修正を支援します。
開発環境と特定のユースケースに最適なオプションを選択します。API 統合とコード アシスト ツールキットを使用して、好みのワークフローに合わせて設定を調整します。
- Merchant API デベロッパー向けドキュメント MCP サーバー（コンテキストを直接取得する場合）
- Merchant API Agent Skills（ワークフロー主導のガイダンス）
次の図は、Antigravity、Visual Studio Code、Cursor、Copilot などの最も一般的な統合開発環境（IDE）で AI 支援コード移行を設定するオプションを示しています。Gemini、Claude、ChatGPT、Grok などのコーディング アシスタントを設定し、Merchant API デベロッパー ドキュメント MCP サーバーまたは Merchant API エージェント スキルを使用して、統合の速度を上げながら、より確実なものにすることができます。
Merchant API デベロッパー ドキュメント MCP サーバー
選択したコーディング アシスタントから Merchant API に関するコンテキスト インテリジェンスを取得します。IDE 内で、Model Context Protocol（MCP）サービスを使用してデベロッパー ドキュメントにアクセスできるようになりました。このサービスは、Google の公式 API ドキュメントからコーディング アシスタントのキー情報を取得します。プロトコル自体の詳細については、Model Context Protocol 標準をご覧ください。
仕組み
MCP 対応の IDE コーディング アシスタントに Merchant API について質問すると、サービスは公式リソースから最も関連性の高いテキストとコードのスニペットを取得し、専用の検索拡張生成（RAG）バックエンドを使用して、コーディング アシスタントのコンテキストとして返します。RAG システムは、LLM を外部の最新のナレッジソースに接続することで、LLM からの回答の品質を向上させるシステムです。これにより、開発環境から離れることなく、正確で最新の回答をアシスタントから得ることができます。
ワークフローの例:
- MCP 対応のコーディング アシスタントまたはエージェントで質問します（自然言語の質問、コードサンプルのリクエスト、コード変換など）。
- コーディング アシスタントがコンテキストのリクエストを MCP エンドポイントに送信します。
- MCP サービスは、Merchant API の公式ドキュメント、ガイド、コードサンプルのインデックス付きコレクションを検索します。
- サービスは、コーディング アシスタントのコンテキストとして信頼できるスニペットを返します。
- コーディング アシスタントはこのコンテキストを活用して、グラウンディングされた回答またはコード変換タスクを生成します。
スタートガイド
MCP を統合して使用する手順は次のとおりです。
1. 互換性のあるツールを使用する
ストリーミング可能な HTTP トランスポートで Model Context Protocol をサポートする IDE またはコーディング アシスタントを開きます。
2. エンドポイントを構成する
IDE またはコーディング アシスタントを MCP に接続するには、提供されたリモート エンドポイントの詳細を使用します。ツールの構成によっては、直接サービス URL または MCP 定義のいずれかの入力が必要になる場合があります。
構成設定:
Antigravity
Antigravity のドキュメントの手順に沿って操作します。
"mcpServers": {
"mapi-devdocs": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://merchantapi.googleapis.com/devdocs/mcp"
]
}
}
Visual Studio Code
Visual Studio Code のドキュメントの手順に沿って操作します。
"servers": {
"mapi-devdocs": {
"type": "http",
"url": "https://merchantapi.googleapis.com/devdocs/mcp/"
}
}
3. エージェントの手順を追加する（省略可）
エージェントが MCP を使用してコードを直接変換できるようにするには、システム指示: Merchant Integrator Agent Protocol を提供します。この手順は、コード変換に MCP を正しく使用する方法をエージェントに説明するものです。ツールに応じて、これらの指示はシステム指示の構成で指定するか、エージェントの追加のコンテキスト ファイルとして指定できます。
使用シナリオの例
MCP は、次の一般的なユースケースでワークフローを高速化できます。
シナリオ 1: products.insert コードを移行する
エージェントに、Content API for Shopping の products.insert 統合コードを Merchant API に直接移行するよう依頼できます。
ユーザー プロンプト:
「
products.insertコードを Merchant API に移行する」
エージェントにシステム手順と MCP へのアクセス権を付与すると、エージェントは IDE で Content API for Shopping コードを Merchant API コードに直接変換できます。この場合、productInputs.insert が同等の呼び出しとして識別され、以前の形式の商品属性が Merchant API で必要な新しい形式にマッピングされます。また、必要なインポートと依存関係管理ファイル（requirements.txt、pom.xml、package.json など）を更新することもできます。エージェントに、変更をインプレースで行うか、新しいフォルダを作成するかを指示できます。
シナリオ 2: 同等の機能を見つける
Content API for Shopping を使用する既存のアプリケーションがあり、更新する必要がある。特定の以前のメソッドについて問い合わせると、新しい実装の詳細と関連するコードサンプルを取得できます。
ユーザー プロンプト:
「Content API for Shopping の accountstatuses.get メソッドに相当する Merchant API は何ですか？」
MCP サービスは、公式の移行ガイドとリファレンス ドキュメントからコンテキストを提供します。これにより、アシスタントは新しい API 名 accounts.issues を含む詳細な回答を返すことができます。
シナリオ 3: コードサンプルを探す
新機能を実装しており、参考になる実用的な例が必要である。
ユーザー プロンプト:
「Merchant API を使用して新しい配送サービスを追加する Python コードのサンプルを教えて。」
MCP サービスは、Google の公式 GitHub リポジトリとデベロッパー ガイドから関連するコードサンプルを取得します。アシスタントは、すぐに適応できる完全なコードブロックを提示できます。
シナリオ 4: API のコンセプトを理解する
新しいコンセプトに遭遇した場合や、リソースの構造や Merchant API の全体的なパターンを理解したい場合。
ユーザー プロンプト:
「Merchant API を使用して商品の在庫を更新するにはどうすればよいですか？」
MCP サービスは、プロダクト リソースのドキュメントと関連するガイドからコンテキストを返します。アシスタントは、accounts.productInputs.insert メソッドの使用方法を説明し、更新する必要がある productId と在庫関連のフィールドのみを含む部分的な商品リソースを提供します。
「Merchant API でアプリケーション呼び出しを承認するにはどうすればよいですか？」
MCP サービスは、さまざまな認可方法を網羅した公式の認証ガイドからコンテキストを取得します。アシスタントは、サーバー間のやり取りにサービス アカウントを使用する、ユーザーの代わりに操作を行うときに OAuth 2.0 クライアント ID を使用するなど、利用可能な主なオプションを説明します。
シナリオ 5: API の変更への適応
Merchant API には、Content API for Shopping とは異なる新しいパターン（リクエストのバッチ処理など）が導入されています。Content API for Shopping は特定の custombatch メソッドを使用しますが、Merchant API は組み込みの汎用 HTTP バッチ処理機能を使用します。
ユーザー プロンプト:
「Merchant API で products.custombatch を行う新しい方法は何ですか？」
MCP サービスは、専用の custombatch メソッドが Merchant API に存在しないことを説明する Refactor code for concurrent requests からコンテキストを取得します。代わりに、multipart の Content-Type で HTTP バッチ処理を使用する方法に関するドキュメントを提供します。アシスタントは、https://merchantapi.googleapis.com/batch/{sub-api}/v1 エンドポイントに送信される複数の API 呼び出しを含む単一の HTTP リクエストを構築する方法を説明し、マルチパート リクエストの構造化方法の例を提供します。これにより、混乱を招く可能性のある移行タスクがガイド付きプロセスに変わります。
シナリオ 6: レポート クエリを変換する
エージェントに、Content API for Shopping のレポートクエリを Merchant API に変換するよう依頼できます。
ユーザー プロンプト:
「このレポートクエリを Content API から Merchant API に移行します。SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'」
MCP サービスは、最新のレポート作成リファレンス ドキュメント、デベロッパー ガイド、移行ガイドを取得します。この情報に基づいて、クエリを新しい構造に変換し、フィールドを新しい名前と値に更新します。
Merchant API エージェント スキル
エージェント スキル仕様は、AI 開発ツール全体で採用されているオープン スタンダードです。エージェント スキルを使用してデベロッパー エクスペリエンスを強化し、ショッピング向け Content API から移行して新しい統合を構築することで、両方を最適化します。Merchant API Agent Skills は、ドメイン固有の知識とツールをパッケージ化して AI エージェントの機能を強化し、ドキュメントのクエリ、コード生成、トラブルシューティングに関するオンデマンドの専門家によるサポートを提供します。
Merchant API エージェント スキルは、Gemini や Claude Code などのさまざまな AI 搭載のコマンドライン ツールや IDE と互換性があります。
仕組み
Merchant API エージェント スキルは、オープン エージェント スキル標準に基づいて構築された専門知識パッケージを提供します。エージェント スキル mapi-developer-assistant は、AI 開発ツールと基盤となる Merchant API Dev Doc MCP サーバーの間のインテリジェント レイヤとして機能します。ドメインの専門知識と手順のガイダンスが組み込まれており、次のプロパティがあります。
- ゼロ構成: MCP サーバー接続を自動的に管理し、エンドポイントを手動で設定する必要がなくなります。
- エキスパート ワークフロー: ユーザーのプロンプトを最適化されたクエリに絞り込み、最も関連性の高い情報を効果的に取得します。
- コンテキスト管理とトークンの効率性: 「プログレッシブ開示」を使用して、オンデマンドで情報を読み込み、AI のコンテキスト ウィンドウを保持します。
- 出力形式の強化: 実行可能で読みやすく、一貫性のあるレスポンスを得るために、出力をフォーマットして構造化する手順を提供します。
ワークフローの例:
- AI 開発ツールで Merchant API について質問する。
- Merchant API エージェント スキルは、インテントを分析し、正確なクエリを作成して、手続き型知識をリクエストに適用します。
- エージェント スキルは、
merchantapi.googleapis.com/devdocs/mcp/にある Merchant API Dev Doc MCP サーバーにコンテキストのリクエストを送信します。 - MCP サービスは、Merchant API の公式ドキュメント、ガイド、コードサンプルのインデックス付きコレクションを検索します。
- AI エージェントは、この情報を活用して、合成された行動可能な回答を提供します。
スタートガイド
Merchant API エージェント スキル README には、次の手順が記載されています。
- Gemini コマンドライン ツールなどのツールの前提条件。
- 選択したツールでエージェント スキルのサポートを有効にする。
- README の指示に従って、GitHub リポジトリから
mapi-developer-assistantスキルをインストールします。 - インストールを確認します。
- 基本的なスキル管理コマンド。
Gemini コマンドライン ツール、Claude Code など、さまざまな AI ツールのインストールと設定の詳細な手順については、README ファイルのガイダンスをご覧ください。
プロンプトの例
AI 開発ツールにインストールして有効にすると、通常、Merchant API に関連する質問をしたときに mapi-developer-assistant スキルが自動的に有効になります。
「Python で Merchant API を使用して商品を挿入するにはどうすればよいですか？」
「Content API の
accountstatuses.getメソッドに相当する Merchant API は何ですか？」
「Merchant API で認証を処理する Java の例を見せて。」
「
productInputs.insertを呼び出すと、検証エラーで「400 不正なリクエスト」が発生します。どうすればよいですか？」
「Merchant API の
ProductInputとProductの違いは何ですか？」
ナレッジベースのソース
MCP サービスは、提供するコンテキストの正確性と信頼性を確保するため、公開されている公式ソースのみに基づいてナレッジベースを構築します。このサービスは、公式デベロッパー サイトとコードサンプル リポジトリのコンテンツ全体をインデックスに登録します。これには次のものが含まれます。
- Merchant API デベロッパー サイト: すべてのガイド、参考資料、ドキュメント。
- Merchant API Apps Script サービス: Apps Script からの Merchant API の使用例。
- 公式コードサンプル: GitHub リポジトリにある Merchant API の公式コードサンプル（Google 提供）をすべて確認できます。
- クライアント ライブラリ: Merchant API でサポートされているすべての公式クライアント ライブラリ。