Сервис доступа к API для продавцов MCP (альфа-версия)

Используйте службу доступа по протоколу контекста модели (MCP) API для продавцов, чтобы получить авторизованный доступ к данным и аналитике вашего Merchant Center и создавать новые возможности для взаимодействия с агентами и автоматизированные рабочие процессы.

Обзор

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

В частности, это позволяет авторизованному доступу к данным вашего Merchant Center, а также к отчетам и аналитическим данным, созданным Google, для выполнения операций только для чтения и ограниченной записи, что позволяет решать такие задачи, как:

• Диагностика и устранение несоответствий продукции требованиям.
• Создавайте отчеты о производительности и аналитические данные.
• Ознакомьтесь с условиями включения автоматических улучшений.
• Создание и получение источников данных

Контроль безопасности и доступа

Сервис доступа к Merchant API MCP разработан с приоритетом на безопасность:

• Аутентификация : Выполнение инструмента регулируется стандартной аутентификацией API продавца , требующей использования OAuth 2.0 или учетных данных сервисной учетной записи. Мы рекомендуем использовать учетные данные с максимально ограниченными правами доступа.
• Безопасность выполнения : Хотя видимость инструмента для обнаружения агентами не ограничена, выполнение инструмента ограничено вашими конкретными учетными данными API.
• Меры безопасности : В качестве защитного механизма инструменты строго ограничены операциями только для чтения и инструментами записи с низким уровнем риска (например, созданием источников данных).

Важные соображения

Сервис доступа к Merchant API MCP находится в альфа-версии; его возможности и функционал будут расширены и могут изменяться.

Прежде чем начать, ознакомьтесь со следующими ограничениями и рекомендациями:

Изменения и релизы

Изменения могут происходить без предварительного уведомления и будут опубликованы в примечаниях к выпуску.

Безопасное тестирование

Мы рекомендуем сначала поэкспериментировать, используя тестовый или нерабочий аккаунт, прежде чем применять эти инструменты в реальной производственной среде.

Совместная квота

Сервис доступа к Merchant API MCP использует тот же пул квот, что и стандартные вызовы Merchant API. Запущенные агенты могут быстро исчерпать квоту, особенно при получении данных из источников. Мы настоятельно рекомендуем использовать тестовый аккаунт, чтобы предотвратить сбои в работе сервиса в производственной среде.

Фильтрация инструментов и безопасность

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

Краткое описание доступных возможностей

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

• Получите подробный статус и контекст отчетности для конкретных продуктов, используя точные названия ресурсов.
• Составляйте списки и осуществляйте поиск нескольких товаров.
• Получайте данные о производительности запросов , статусах продуктов, аналитику по популярным товарам, информацию о ценах, данные о конкурентах, а также аналитику партнерской программы YouTube Shopping.
• Выявите проблемы на уровне учетных записей, влияющие на видимость продукта или участие в программе.
• Вывод списка, создание, получение и проверка статуса загрузки источников данных.
• Перечислите общие причины отказа в приемке продукции по всему вашему ассортименту.
• Проверьте настройки автоматической обработки товаров, изображений и доставки.
• Проверьте активные регионы, невыполненные требования и штат участия для конкретных программ Merchant Center.

Начиная

Чтобы подключить вашу IDE, помощника по программированию или агента к службе доступа к Merchant API MCP, обновите настройки клиента MCP. Например, обновите файл mcp.json для Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code или вашей пользовательской платформы агента.

Для локальной настройки службы доступа к Merchant API MCP требуется учетная запись службы . Стандартная аутентификация OAuth для пользователей не поддерживается при локальном выполнении в режиме без графического интерфейса. Необходимо создать учетную запись службы, загрузить файл закрытого ключа в формате JSON и указать путь к ней, а также идентификатор вашего Merchant Center в качестве аргументов.

Подробные инструкции по созданию и загрузке служебной учетной записи см. в руководстве по служебным учетным записям .

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

Настройки конфигурации:

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

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

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

Сценарий 1: Диагностика и устранение несоответствий продукта требованиям.

Вы хотите понять, почему конкретный товар не отображается в результатах поиска Google.

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

"Почему мой товар с идентификатором предложения 'offer123' отклонен?"

Поведение агента при использовании MCP:

1. Агент вызывает функции list_products или get_product_by_name , чтобы определить статус товара.
2. Сервер MCP возвращает статус товара, включая список issues (например, «Неправильный формат цены» или «Отсутствует стоимость доставки»).
3. Агент анализирует проблемы и объясняет вам их первопричину, предлагая способы их решения (например, обновление информации о ценах).

Сценарий 2: Проверьте условия согласия на автоматические улучшения.

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

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

«Включены ли у меня автоматические улучшения доставки?»

Поведение агента при использовании MCP:

1. Агент вызывает get_automatic_improvements для получения настроек на уровне учетной записи.
2. Сервер MCP возвращает конфигурацию, отображающую статус улучшений в отношении изображений, товаров и доставки.
3. Агент подтверждает, что улучшения в доставке активированы, или объясняет, как их включить, если они отключены.

Сценарий 3: Создание отчетов о производительности и получение аналитических данных.

Вы хотите быстро проверить свои последние показатели, не переходя в пользовательский интерфейс Merchant Center.

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

«Покажите мне 5 товаров, показавших лучшие результаты по количеству кликов за прошлую неделю».

Поведение агента при использовании MCP:

1. Агент формирует запрос на языке запросов Merchant Center Query Language (MCQL), нацеленный на таблицу product_performance_view , сортируя по clicks DESC и ограничивая количество кликов до 5 .
2. Агент вызывает функцию report_search с сформированным запросом.
3. Сервер MCP выполняет запрос к базе данных отчетов в режиме реального времени и возвращает строки.
4. Агент форматирует результаты в удобную таблицу Markdown.

Сценарий 4: Создание и получение источников данных

Вы хотите добавить новый источник данных для загрузки обновлений продукта.

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

«Создайте дополнительный источник данных с именем 'обновления цен' для моего торгового счета».

Поведение агента при использовании MCP:

1. Агент вызывает create_data_source с указанными настройками для регистрации нового потока данных.
2. Сервер MCP создает источник данных и возвращает его уникальное имя ресурса.
3. Агент вызывает fetch_data_source для запуска загрузки и обработки соответствующего файла.
4. Агент вызывает get_file_upload для отслеживания хода загрузки и подтверждения успешной обработки файлов.

Инструменты и описания MCP

Сервис доступа к Merchant API MCP предоставляет вашему агенту следующие инструменты: