Интеграция API и набор инструментов Code Assist с использованием MCP

Получайте контекстную информацию о Merchant API от помощника по кодированию по вашему выбору. В вашей интегрированной среде разработки (IDE) теперь вы можете получить доступ к интеграции документации разработчика с помощью сервиса Model Context Protocol (MCP). Этот сервис ускоряет разработку для интеграции и миграции, предоставляя вашему помощнику по кодированию авторитетный контекст из официальной документации Google API.

Более подробную информацию о самом протоколе см. в стандарте Model Context Protocol .

Обзор

При переходе с Content API for Shopping на Merchant API или создании новой интеграции вам необходимо понимать структуру новых сервисов, названия ресурсов и методы. Сервис MCP упрощает этот процесс, предоставляя вашему помощнику по программированию официальную документацию и примеры кода.

Сервис использует узкоспециализированную платформу RAG (Retrieval-Augmented Generation). Когда вы задаёте помощнику по программированию в IDE с поддержкой MCP вопрос о Merchant API, сервис извлекает наиболее релевантные фрагменты текста и кода из официальных ресурсов Google и возвращает их вашему помощнику по программированию в качестве контекста. Это позволяет помощнику предоставлять точные и актуальные ответы, не покидая среду разработки.

Как это работает

Интеграция документации разработчиков с использованием MCP интегрируется в современный рабочий процесс разработки с использованием ИИ:

  1. Вы задаёте вопрос в своём помощнике по кодированию или агенте, совместимом с MCP. Это может быть вопрос на естественном языке или запрос примера кода для реализации методов API продавца.
  2. Ваш помощник по кодированию отправляет запрос контекста в конечную точку MCP.
  3. Служба MCP осуществляет поиск в своей индексированной коллекции официальной документации, руководств и примеров кода Merchant API, чтобы найти наиболее релевантную информацию.
  4. Служба возвращает эти авторитетные фрагменты в качестве контекста вашему помощнику по кодированию.
  5. Ваш помощник по кодированию использует этот высококачественный контекст для генерации точного и полезного ответа на ваш исходный вопрос.

Начиная

Для использования MCP вам понадобится IDE или помощник по кодированию, поддерживающий Model Context Protocol с потоковым транспортом HTTP.

Конфигурация конечной точки

Чтобы подключить свой инструмент к службе, используйте предоставленные данные удаленной конечной точки, для чего может потребоваться ввести либо прямой URL-адрес службы, либо определение MCP, в зависимости от конфигурации вашего инструмента.

URL-адрес сервиса:

MCP Server Name: "MAPI Docs MCP"
MCP Server URL:  "https://merchantapi.googleapis.com/devdocs/mcp/"

Примеры сценариев использования

MCP может ускорить ваш рабочий процесс в следующих распространенных случаях использования.

Сценарий 1: Миграция устаревшего вызова API

У вас есть существующее приложение, использующее Content API for Shopping, и вам необходимо его обновить. Вы можете запросить информацию о конкретном устаревшем методе, чтобы получить подробную информацию о новой реализации и соответствующий пример кода.

Запрос пользователя:

«Какой API-эквивалент метода accountstatuses.get в API контента для покупок?»

Служба MCP предоставляет контекст из официальных руководств по миграции и справочной документации, позволяя вашему помощнику предоставить подробный ответ, включая новое имя API, accounts.issues .

Сценарий 2: Поиск примера кода

Вы внедряете новую функцию и вам нужен практический пример для подражания.

Запрос пользователя:

«Покажите мне пример кода Python для добавления новой службы доставки с использованием API торговца».

Сервис MCP извлекает соответствующие примеры кода из официальных репозиториев Google GitHub и руководств для разработчиков. Ваш помощник может представить готовый к адаптации блок кода.

Сценарий 3: Понимание концепций API

Вы сталкиваетесь с новой концепцией или хотите понять структуру ресурса или общий шаблон API торговца.

Запрос пользователя:

«Как обновить инвентарь товара с помощью API продавца?»

Служба MCP возвращает контекст из документации по ресурсам продуктов и соответствующих руководств. Ваш помощник может объяснить, как использовать метод accounts.productInputs.insert , и предоставить частичный ресурс продукта, содержащий только productId и поля, связанные с инвентаризацией, которые необходимо обновить.

«Как авторизовать вызовы моего приложения с помощью Merchant API?»

Служба MCP извлекает контекст из официальных руководств по аутентификации, охватывающих различные методы авторизации. Ваш помощник может объяснить основные доступные варианты, например, использование учётной записи службы для взаимодействия между серверами или идентификатора клиента OAuth 2.0 при работе от имени пользователя.

Сценарий 4: Адаптация к изменениям API

API Merchant представляет новые шаблоны, такие как пакетные запросы, которые отличаются от Content API for Shopping. API Content for Shopping использует специальные методы custombatch , в то время как API Merchant использует встроенную функцию пакетной обработки HTTP.

Запрос пользователя:

«Какой новый способ создания products.custombatch в API Merchant?»

Служба MCP извлекает контекст из кода рефакторинга для параллельных запросов, объясняя, что в API Merchant отсутствуют специальные методы custombatch . Вместо этого она предоставляет документацию по использованию HTTP-пакетирования с Content-Type multipart . Ваш помощник может объяснить, как создать один HTTP-запрос, содержащий несколько вызовов API, отправленный на конечную точку https://merchantapi.googleapis.com/batch/{sub-api}/v1 , и предоставить пример структурирования multipart-запроса. Это превращает потенциально запутанную задачу миграции в управляемый процесс.

Источники базы знаний

Сервис MCP формирует свою базу знаний исключительно на основе открытых и официальных источников, чтобы гарантировать точность и достоверность предоставляемого контекста. Сервис индексирует весь контент официального сайта разработчика и репозитория примеров кода, включая:

Назад
Quickstart
Далее
Overview