Merchant API MCP Access Service (Alpha)

Aby uzyskać autoryzowany dostęp do danych i statystyk w Merchant Center, użyj usługi Merchant API Model Context Protocol (MCP) Access Service. Dzięki temu możesz tworzyć nowe rozwiązania agentowe i zautomatyzowane przepływy pracy.

Przegląd

Usługa Merchant API MCP Access Service zapewnia standardowe i bezpieczne połączenie dla dużych modeli językowych, agentów i asystentów kodowania, które umożliwia tworzenie i koordynowanie nowych rozwiązań agentowych oraz zautomatyzowanych przepływów pracy opartych na danych z Merchant Center.

Umożliwia ona autoryzowany dostęp do danych z Merchant Center oraz raportów i statystyk generowanych przez Google, co pozwala wykonywać operacje odczytu i ograniczone operacje zapisu w celu rozwiązywania problemów w takich przypadkach jak:

  • diagnozowanie i rozwiązywanie problemów z odrzuconymi produktami;
  • generowanie raportów i statystyk dotyczących skuteczności;
  • sprawdzanie zgody na automatyczne ulepszenia;
  • tworzenie i pobieranie źródeł danych.

Zabezpieczenia i kontrola dostępu

Usługa Merchant API MCP Access Service została zaprojektowana z myślą o bezpieczeństwie:

  • Uwierzytzenianie: wykonywanie narzędzi podlega standardowemu uwierzytelnianiu w Merchant API, które wymaga danych logowania OAuth 2.0 lub konta usługi. Zalecamy używanie danych logowania z jak najbardziej ograniczonymi uprawnieniami dostępu.
  • Bezpieczeństwo wykonywania: widoczność narzędzi nie jest ograniczona w przypadku wykrywania agentów, ale ich wykonywanie jest ograniczone do konkretnych danych logowania interfejsu API.
  • Zabezpieczenia: narzędzia są ograniczone do operacji tylko do odczytu i narzędzi do zapisu o niskim ryzyku (np. tworzenia źródła danych) jako zabezpieczenie.

Istotne kwestie

Usługa Merchant API MCP Access Service jest w wersji alfa. Jej zakres i możliwości będą rozszerzane i mogą ulec zmianie.

Zanim zaczniesz, zapoznaj się z tymi ograniczeniami i sprawdzonymi metodami:

Zmiany i wersje

Zmiany mogą być wprowadzane bez wcześniejszego powiadomienia i będą publikowane w informacjach o wersji.

Bezpieczne testowanie

Zanim zaczniesz korzystać z tych narzędzi w środowisku produkcyjnym, zalecamy przeprowadzenie testów na koncie testowym lub koncie nieprodukcyjnym.

Wspólny limit

Usługa Merchant API MCP Access Service korzysta z tego samego limitu co standardowe wywołania Merchant API. Działający agenci mogą szybko wyczerpać limit, zwłaszcza w przypadku pobierania źródeł danych. Zdecydowanie zalecamy używanie konta testowego, aby zapobiec przerwom w działaniu usługi produkcyjnej.

Filtrowanie narzędzi i bezpieczeństwo

W przyszłości dodamy nowe funkcje, zwłaszcza działania zapisu. Zdecydowanie zalecamy skonfigurowanie klienta do wbudowanego filtrowania narzędzi, a nie udostępniania całego zestawu narzędzi.

Podsumowanie dostępnych funkcji

Za pomocą usługi Merchant API MCP Access Service możesz wykonywać te działania w sposób agentowy:

  • Pobieranie szczegółowych informacji o stanie i raportowaniu w przypadku konkretnych produktów za pomocą dokładnych nazw zasobów.
  • Wyświetlanie i wyszukiwanie wielu produktów.
  • Wysyłanie zapytań o dane o skuteczności, stany produktów i statystyki dotyczące popularnych produktów, statystyki cen, widoczność na tle konkurencji oraz statystyki programu partnerskiego Zakupy na YouTube.
  • Identyfikowanie problemów na poziomie konta, które wpływają na widoczność produktów lub udział w programie.
  • Wyświetlanie, tworzenie, pobieranie i sprawdzanie stanu przesyłania źródeł danych.
  • Wyświetlanie zbiorczych przyczyn odrzucenia produktów w całym asortymencie.
  • Sprawdzanie ustawień automatycznych ulepszeń w przypadku produktów, zdjęć i dostawy.
  • Sprawdzanie aktywnych regionów, niespełnionych wymagań i stanu udziału w przypadku konkretnych programów Merchant Center.

Pierwsze kroki

Aby połączyć IDE, asystenta kodowania lub agenta z usługą Merchant API MCP Access Service, zaktualizuj ustawienia klienta MCP (np. mcp.json lub settings.json).

Konfiguracja klienta

Ustawienia konfiguracji:

Antigravity

Połącz się bezpośrednio z hostowanym zdalnym punktem końcowym MCP za pomocą tokena dostępu OAuth 2.0 (z zakresem https://www.googleapis.com/auth/content). Postępuj zgodnie z instrukcjami w dokumentacji Antigravity.

{
    "mcpServers": {
        "merchant-api-access": {
            "serverUrl": "https://merchantapi.googleapis.com/mcp",
            "headers": {
                "Authorization": "Bearer {ACCESS_TOKEN}",
                "x-goog-user-project": "{GOOGLE_CLOUD_PROJECT_ID}"
            }
        }
    }
}

Claude CLI

Dodaj hostowany zdalny punkt końcowy MCP bezpośrednio w Claude CLI za pomocą polecenia claude mcp add:

claude mcp add --transport http merchant-api https://merchantapi.googleapis.com/mcp --scope local \
  --header "Authorization: Bearer {ACCESS_TOKEN}" \
  --header "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}"

Postępuj zgodnie z instrukcjami w dokumentacji Claude MCP.

cURL

Wysyłaj standardowe żądania JSON-RPC 2.0 bezpośrednio do hostowanego punktu końcowego Merchant API MCP.

Wyświetlanie listy dostępnych narzędzi:

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Wykonywanie wywołania narzędzia (np. list_data_sources):

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      }
    }
  }'

Zastąp te elementy:

  • ACCOUNT_ID: identyfikator w Merchant Center;
  • ACCESS_TOKEN: token autoryzacji do wykonania wywołania interfejsu API;
  • GOOGLE_CLOUD_PROJECT_ID: identyfikator projektu Google Cloud powiązanego z kontem Merchant Center.

Przykładowe scenariusze użycia

Aby pokazać, jak możesz wykorzystać usługę Merchant API MCP Access Service do tworzenia rozwiązań agentowych i zautomatyzowanych przepływów pracy, rozważ te scenariusze:

Scenariusz 1. Diagnozowanie i rozwiązywanie problemów z odrzuconymi produktami

Chcesz dowiedzieć się, dlaczego konkretny produkt nie wyświetla się w wynikach wyszukiwania Google.

Zapytanie użytkownika:

„Dlaczego mój produkt z identyfikatorem oferty „offer123” został odrzucony?”

Zachowanie agenta w przypadku MCP:

  1. Agent wywołuje list_products lub get_product_by_name, aby znaleźć stan produktu.
  2. Serwer MCP zwraca stan produktu, w tym listę issues (np. „Nieprawidłowy format ceny” lub „Brak wartości dostawy”).
  3. Agent analizuje problemy i wyjaśnia ich przyczynę, sugerując sposób ich rozwiązania (np. zaktualizowanie informacji o cenie).

Scenariusz 2. Sprawdzanie zgody na automatyczne ulepszenia

Chcesz sprawdzić, czy automatyczne ulepszenia dostawy są aktywne.

Zapytanie użytkownika:

„Czy mam włączone automatyczne ulepszenia dostawy?”

Zachowanie agenta w przypadku MCP:

  1. Agent wywołuje get_automatic_improvements, aby pobrać ustawienia na poziomie konta.
  2. Serwer MCP zwraca konfigurację pokazującą stan ulepszeń zdjęć, produktów i dostawy.
  3. Agent potwierdza, że ulepszenia dostawy są aktywne, lub wyjaśnia, jak je włączyć, jeśli są wyłączone.

Scenariusz 3. Generowanie raportów i statystyk dotyczących skuteczności

Chcesz szybko sprawdzić ostatnie wyniki bez przechodzenia do interfejsu Merchant Center.

Zapytanie użytkownika:

„Pokaż mi 5 produktów, które w zeszłym tygodniu miały najwięcej kliknięć”.

Zachowanie agenta w przypadku MCP:

  1. Agent tworzy zapytanie w języku zapytań Merchant Center (MCQL) kierowane do tabeli product_performance_view, sortując według clicks DESC i ograniczając do 5.
  2. Agent wywołuje report_search z utworzonym zapytaniem.
  3. Serwer MCP wykonuje zapytanie w aktywnej bazie danych raportów i zwraca wiersze.
  4. Agent formatuje wyniki w przejrzystą tabelę Markdown.

Scenariusz 4. Tworzenie i pobieranie źródeł danych

Chcesz dodać nowe źródło danych, aby przesyłać aktualizacje produktów.

Zapytanie użytkownika:

„Utwórz dodatkowe źródło danych o nazwie „price-updates” na moim koncie sprzedawcy”.

Zachowanie agenta w przypadku MCP:

  1. Agent wywołuje create_data_source z określonymi ustawieniami, aby zarejestrować nowy plik danych.
  2. Serwer MCP tworzy źródło danych i zwraca jego unikalną nazwę zasobu.
  3. Agent wywołuje fetch_data_source, aby rozpocząć pobieranie i przetwarzanie powiązanego pliku.
  4. Agent wywołuje get_file_upload, aby monitorować postęp przesyłania i potwierdzić pomyślny stan przetwarzania produktów.

Narzędzia i opisy MCP

Usługa Merchant API MCP Access Service udostępnia agentowi te narzędzia:

Narzędzie MCP Opis
get_product_by_name Pobieranie informacji o produkcie dla danego sprzedawcy za pomocą dokładnej nazwy zasobu produktu. Zwraca szczegółowy stan produktu zawierający kontekst raportowania i potencjalne problemy na poziomie produktu.
list_products Wyświetlanie listy lub wyszukiwanie wielu produktów dla danego sprzedawcy. Zwraca szczegółowy stan produktu zawierający kontekst raportowania i potencjalne problemy na poziomie produktu w przypadku wielu produktów.
report_search Wysyłanie zapytań do tabel raportowania w celu pobierania danych o skuteczności produktów, stanów produktów, statystyk dotyczących cen i widoczności na tle konkurencji. Szczegółowe informacje znajdziesz w przewodniku po raportach.
list_data_sources Wyświetlanie listy dostępnych źródeł danych dla danego sprzedawcy.
get_data_source Pobieranie szczegółów konkretnego źródła danych.
create_data_source Tworzenie nowego źródła danych dla danego sprzedawcy.
fetch_data_source Pobieranie i przetwarzanie pliku powiązanego ze źródłem danych dla danego sprzedawcy.
get_file_upload Pobieranie stanu najnowszego przesłania pliku dla danego źródła danych.
list_accounts Wyświetlanie listy kont danego użytkownika.
list_account_issues Wyświetlanie listy problemów na poziomie konta dla danego sprzedawcy w celu zidentyfikowania problemów na poziomie konta.
list_programs Wyświetlanie listy programów dla danego sprzedawcy, w tym stanu udziału, aktywnych regionów i niespełnionych wymagań.
list_aggregate_product_statuses Wyświetlanie listy zbiorczych problemów na poziomie produktu w celu monitorowania ogólnego stanu danych o produktach.
get_automatic_improvements Pobieranie ustawień automatycznych ulepszeń, w tym aktualizacji produktów, ulepszeń zdjęć i ulepszeń dostawy.