Merchant API MCP Access Service (Alpha)

Korzystaj z usługi Merchant API Model Context Protocol (MCP) Access Service, aby uzyskać autoryzowany dostęp do danych i statystyk Merchant Center i tworzyć nowe rozwiązania agentowe oraz zautomatyzowane przepływy pracy.

Przegląd

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

W szczególności umożliwia autoryzowany dostęp do danych Merchant Center oraz raportów i statystyk generowanych przez Google, aby wykonywać operacje tylko do odczytu i ograniczone operacje zapisu w takich przypadkach jak:

• Diagnozowanie i rozwiązywanie problemów z odrzuconymi produktami
• Generowanie raportów skuteczności i statystyk
• Sprawdzanie akceptacji automatycznych ulepszeń
• Tworzenie i pobieranie źródeł danych

Bezpieczeństwo i kontrola dostępu

Usługa dostępu do MCP w Merchant API została zaprojektowana z myślą o bezpieczeństwie:

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

Istotne kwestie

Usługa dostępu do MCP w Merchant API jest w wersji alfa. Jej zakres i możliwości zostaną rozszerzone i mogą ulec zmianie.

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

Zmiany i wersje

Zmiany mogą nastąpić bez wcześniejszego powiadomienia i zostaną opublikowane w informacjach o wersji.

Bezpieczne testowanie

Zanim użyjesz tych narzędzi w środowisku produkcyjnym, zalecamy przetestowanie ich na koncie testowym lub koncie nieaktywnym.

Wspólny limit

Usługa dostępu do MCP w Merchant API korzysta z tej samej puli limitów co standardowe wywołania interfejsu API Merchant API. Uruchomione agenty mogą szybko wyczerpać limit, zwłaszcza w przypadku pobierania danych ze źródła. Zdecydowanie zalecamy używanie konta testowego, aby uniknąć przerw w działaniu usługi produkcyjnej.

Filtrowanie narzędzi i bezpieczeństwo

W przyszłości dodamy nowe funkcje, zwłaszcza działania związane z zapisywaniem. Zdecydowanie zalecamy skonfigurowanie klienta tak, aby korzystał z wbudowanego filtrowania narzędzi, zamiast udostępniać cały zestaw narzędzi.

Podsumowanie dostępnych funkcji

Możesz używać usługi Merchant API MCP Access Service do wykonywania tych działań w sposób agentowy:

• Pobieranie szczegółowych informacji o stanie i raportów dotyczących konkretnych produktów przy użyciu dokładnych nazw zasobów.
• Wyświetlanie i wyszukiwanie wielu usług.
• Sprawdzaj wskaźniki skuteczności, stany produktów i statystyki dotyczące popularnych produktów, statystyki dotyczące cen, widoczność na tle konkurencji i analitykę 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 listy, tworzenie, pobieranie i sprawdzanie stanu przesyłania źródeł danych.
• Wyświetlanie listy zagregowanych przyczyn odrzucenia produktów w asortymencie.
• Sprawdź ustawienia automatycznego poprawiania produktów, zdjęć i dostawy.
• Sprawdź aktywne regiony, niespełnione wymagania i stan uczestnictwa w konkretnych programach Merchant Center.

Pierwsze kroki

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

Konfiguracja klienta

Konfiguracje:

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

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}"

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}" \
  -H "MCP-Protocol-Version: {MCP_PROTOCOL_VERSION}" \
  -H "Mcp-Method: tools/list" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion":
          "{MCP_PROTOCOL_VERSION}"
      }
    }
  }'

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}" \
  -H "MCP-Protocol-Version: {MCP_PROTOCOL_VERSION}" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: list_data_sources" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      },
      "_meta": {
        "io.modelcontextprotocol/protocolVersion":
          "{MCP_PROTOCOL_VERSION}"
      }
    }
  }'

Przykładowe scenariusze użycia

Aby dowiedzieć się, jak korzystać z usługi Merchant API MCP Access Service do tworzenia rozwiązań agentowych i zautomatyzowanych przepływów pracy, zapoznaj się z tymi scenariuszami:

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.

Prompt użytkownika:

„Dlaczego mój produkt o identyfikatorze oferty „oferta123” 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 główną przyczynę, sugerując rozwiązanie problemu (np. przez zaktualizowanie informacji o cenie).

Scenariusz 2. Sprawdź akceptację automatycznych ulepszeń

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

Prompt 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. Pracownik obsługi klienta potwierdza, że ulepszenia dostawy są aktywne, lub wyjaśnia, jak je włączyć, jeśli są wyłączone.

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

Chcesz szybko sprawdzić ostatnie wyniki bez konieczności poruszania się po interfejsie Merchant Center.

Prompt użytkownika:

„Pokaż mi 5 najskuteczniejszych produktów pod względem liczby kliknięć w zeszłym tygodniu”.

Zachowanie agenta w przypadku MCP:

1. Agent tworzy zapytanie w języku Merchant Center Query Language (MCQL) kierowane na tabelę product_performance_view, porządkują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 bazie danych raportowania na żywo i zwraca wiersze.
4. Agent sformatuje wyniki w czytelną tabelę Markdown.

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

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

Prompt użytkownika:

„Utwórz dodatkowe źródło danych o nazwie „aktualizacje-cen” dla mojego konta 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 uruchomić pobieranie i przetwarzanie powiązanego pliku.
4. Agent wywołuje metodę get_file_upload, aby monitorować postęp przesyłania i potwierdzić, że produkty zostały przetworzone.

Narzędzia MCP i opisy

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