API 統合と Code Assist Toolkit

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 統合と Code Assist ツールキットを使用して、好みのワークフローに合わせて設定を調整します。

• 直接コンテキストを取得するための Merchant API デベロッパー ドキュメント MCP サーバー
• ワークフロー駆動型ガイダンスの**Merchant API エージェント スキル**

次の図は、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 メソッドがないことを説明します。代わりに、Content-Type が multipart の 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 エージェント スキル

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

Merchant API エージェント スキルは、Gemini や Claude Code などのさまざまな AI 搭載のコマンドライン ツールや IDE と互換性があります。

仕組み

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

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

ワークフローの例:

1. AI 開発ツールで Merchant API について質問します。
2. Merchant API エージェント スキルは、ユーザーの意図を分析し、正確なクエリを作成して、手順に関する知識をリクエストに適用します。
3. エージェント スキルは、merchantapi.googleapis.com/devdocs/mcp/ にある Merchant API Dev Doc MCP サーバーにコンテキストのリクエストを送信します。
4. MCP サービスは、Merchant API の公式ドキュメント、ガイド、コードサンプルのインデックス付きコレクションを検索します。
5. 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 Bad Request」が表示されます。どうすればよいですか？」

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

ナレッジベースのソース

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

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