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

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

Для получения более подробной информации о самом протоколе см. стандарт Model Context Protocol .

Обзор

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

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

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

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

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

Начиная

Для использования MCP выполните следующие шаги:

1. Используйте совместимый инструмент.

Откройте интегрированную среду разработки (IDE) или помощник по программированию, поддерживающий протокол контекста модели (Model Context Protocol) с потоковой передачей HTTP-трафика.

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

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

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

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

3. Добавить инструкции для агента (необязательно)

Чтобы ваш агент мог напрямую переводить код с помощью MCP, предоставьте ему системные инструкции: Протокол агента MerchantIntegrator . Эти инструкции помогут агенту правильно использовать MCP для перевода кода. В зависимости от используемого инструмента, вы можете предоставить эти инструкции либо в конфигурации системных инструкций, либо в качестве дополнительного контекстного файла для агента.

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

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

Сценарий 1: Миграция products.insert Вставьте код

Вы можете попросить агента напрямую перенести код интеграции Content API для products.insert в Shopping в Merchant API.

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

"Перенести код products.insert в API продавца"

Предоставив вашему агенту системные инструкции: протокол агента MerchantIntegrator и доступ к MCP, ваш агент сможет напрямую в вашей IDE переводить код Content API для покупок в код Merchant API. В этом случае он определит productInputs.insert как эквивалентный вызов и сопоставит атрибуты продукта из старого формата с новым форматом, требуемым Merchant API. Он также сможет обновить необходимые импорты и файл управления зависимостями (например, requirements.txt , pom.xml или package.json ). Вы можете указать агенту внести изменения на месте или создать новую папку.

Сценарий 2: Найти эквивалентную функциональность

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

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

«Какой аналог метода accountstatuses.get в Content API для Shopping используется в Merchant API?»

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

«Как теперь использовать products.custombatch в Merchant API?»

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

Сценарий 6: Перевод запроса для формирования отчета

Вы можете попросить агента перевести запрос для формирования отчетов из Content API для покупок в 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 получает последнюю справочную документацию по отчетности, руководства для разработчиков и руководства по миграции. На основе этой информации он преобразует запрос в новую структуру и обновляет поля, присваивая им новые имена и значения.

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

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

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