API 統合と Code Assist Toolkit

API Integration と 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 Integration and Code Assist Toolkit を使用して、好みのワークフローに合わせて設定をカスタマイズします。

• 直接コンテキストを取得するための 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 の利用規約が適用されます。このサービスはデベロッパーのプライバシーを優先し、コーディング支援が発行したクエリに基づいて、信頼できる一般公開ドキュメントのみを取得します。使用するアシスタントによって、サービスに送信されるクエリが決まります。ベスト プラクティスとして、機密情報や専有情報を送信しないでください。

Merchant API デベロッパー ドキュメント MCP サーバー

任意のコーディング支援から Merchant API に関するコンテキスト インテリジェンスを取得します。IDE 内で、Model Context Protocol（MCP）サービスを使用してデベロッパー向けドキュメントにアクセスできるようになりました。このサービスは、Google API の公式ドキュメントからコーディング アシスタントに重要な情報を提供します。プロトコル自体の詳細については、Model Context Protocol 標準をご覧ください。

仕組み

MCP 対応の IDE コーディング支援に Merchant API に関する質問をすると、サービスは公式リソースから最も関連性の高いテキストとコードのスニペットを取得し、専用の検索拡張生成（RAG）バックエンドを使用して、コーディング支援にコンテキストとして返します。RAG システムは、LLM を外部の最新のナレッジソースに接続することで、LLM からの回答の品質を向上させるシステムです。これにより、開発環境を離れることなく、アシスタントが正確で最新の回答を提供できるようになります。

ワークフローの例:

1. MCP 互換のコーディング支援アシスタントまたはエージェントで質問します（自然言語の質問、コードサンプルのリクエスト、コード変換など）。
2. コーディング支援が MCP エンドポイントにコンテキストのリクエストを送信します。
3. MCP サービスは、インデックスに登録された公式の Merchant API ドキュメント、ガイド、コードサンプルのコレクションを検索します。
4. サービスは、信頼できるスニペットをコンテキストとしてコーディング アシスタントに返します。
5. コーディング支援は、このコンテキストを利用して、グラウンディングされた回答またはコード変換タスクを生成します。

スタートガイド

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 サービスは、同時リクエストのコードをリファクタリングするからコンテキストを取得し、Merchant API に専用の custombatch メソッドが存在しないことを説明します。代わりに、multipart の Content-Type で HTTP バッチ処理を使用する方法について説明しています。アシスタントは、複数の API 呼び出しを含む単一の HTTP リクエストを作成して https://merchantapi.googleapis.com/batch/{sub-api}/v1 エンドポイントに送信する方法を説明し、マルチパート リクエストの構造化方法の例を示すことができます。これにより、混乱を招く可能性のある移行タスクがガイド付きプロセスに変換されます。

シナリオ 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 Agent Skills

エージェント スキル仕様は、AI デベロッパー ツール全体で採用されているオープン スタンダードです。エージェント スキルを使用すると、デベロッパー エクスペリエンスを向上させ、Content API for Shopping からの移行と新しい統合の構築の両方を最適化できます。Merchant API Agent Skills は、ドメイン固有の知識とツールをパッケージ化して AI エージェントの機能を強化し、ドキュメントのクエリ、コード生成、トラブルシューティングに関するオンデマンドの専門的なサポートを提供します。

Merchant API Agent Skills は、Antigravity や Claude Code など、さまざまな AI 搭載のコマンドライン ツールや IDE と互換性があります。

仕組み

Merchant API Agent Skills は、オープンな Agent Skills 標準に基づいて構築された、専門的なエキスパティーズ パッケージを提供します。エージェント スキル mapi-developer-assistant は、AI デベロッパー ツールと基盤となる Merchant API Dev Doc MCP サーバーの間のインテリジェントなレイヤとして機能します。ドメインの専門知識と手続き上のガイダンスが組み込まれており、次の特性があります。

• ゼロ構成: MCP サーバー接続を自動的に管理するため、エンドポイントを手動で設定する必要がありません。
• エキスパート ワークフロー: ユーザー プロンプトを最適化されたクエリに変換し、最も関連性の高い情報を効果的に取得します。
• コンテキスト管理とトークン効率: 「プログレッシブ ディスクロージャー」を使用して、オンデマンドで情報を読み込み、AI のコンテキスト ウィンドウを保持します。
• 出力形式の強化: 出力の形式と構造を指示して、実用的で読みやすく、一貫性のあるレスポンスを生成します。

ワークフローの例:

1. AI デベロッパー ツールで Merchant API について質問します。
2. Merchant API Agent Skill は、インテントを分析し、正確なクエリを作成して、リクエストに手続き型知識を適用します。
3. エージェント スキルは、merchantapi.googleapis.com/devdocs/mcp/ にある Merchant API Dev Doc MCP サーバーにコンテキストのリクエストを送信します。
4. MCP サービスは、インデックスに登録された公式の Merchant API ドキュメント、ガイド、コードサンプルのコレクションを検索します。
5. AI エージェントは、この情報を活用して、合成された実用的なレスポンスを提供します。

スタートガイド

Merchant API Agent Skills README には、次の手順が記載されています。

• Antigravity コマンドライン ツールなどのツールの前提条件。
• 選択したツールでエージェント スキルのサポートを有効にする。
• README の手順に沿って、GitHub リポジトリから mapi-developer-assistant スキルをインストールする。
• インストールの確認。
• 基本的なスキル管理コマンド。

Antigravity コマンドライン ツール、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 Bad Request」が表示されます。どうすればよいですか？」

「Merchant API の ProductInput と Product の違いは何ですか？」

ナレッジベースのソース

MCP サービスは、提供するコンテキストの正確性と信頼性を確保するため、公開されている公式のソースのみからナレッジベースを構築します。このサービスは、公式デベロッパー サイトとコードサンプル リポジトリのコンテンツ全体をインデックスに登録します。これには、次のものが含まれます。

• Merchant API デベロッパー サイト: すべてのガイド、リファレンス資料、ドキュメント。
• Merchant API Apps Script サービス: Apps Script からの Merchant API の使用例。
• 公式コードサンプル: GitHub リポジトリにある、Google が提供する Merchant API の公式コードサンプル。
• クライアント ライブラリ: Merchant API でサポートされているすべての公式クライアント ライブラリ。