Merchant API MCP Access Service (Alpha)

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

Przegląd

Usługa Merchant API MCP Access Service zapewnia standardowe, 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 Merchant Center.

Umożliwia on autoryzowany dostęp do danych Merchant Center oraz raportów i statystyk generowanych przez Google w celu wykonywania operacji odczytu i ograniczonego zapisu, aby rozwiązywać problemy w takich przypadkach użycia jak:

• Diagnozowanie i rozwiązywanie problemów z odrzuconymi produktami
• generować raporty skuteczności i statystyki,
• Sprawdzanie zgody na automatyczne ulepszenia
• Tworzenie i pobieranie źródeł danych

Bezpieczeństwo i kontrola dostępu

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

• Uwierzytelnianie: wykonywanie narzędzia podlega standardowemu uwierzytelnianiu w interfejsie Merchant API, które wymaga danych logowania OAuth 2.0 lub 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 agentów, ale wykonywanie narzędzi jest ograniczone do konkretnych danych logowania 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) jako zabezpieczenie.

Istotne kwestie

Usługa dostępu do MCP w Merchant API jest wersją 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ą 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 eksperymentów na koncie testowym lub nieaktywnym koncie.

Limit wspólny

Usługa dostępu MCP interfejsu Merchant API korzysta z tego samego puli limitów co standardowe wywołania interfejsu Merchant API. Uruchomione agenty mogą szybko wyczerpać limit, zwłaszcza w przypadku pobierania danych ze ź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 związane z zapisywaniem. Zdecydowanie zalecamy wyraźne skonfigurowanie klienta pod kątem filtrowania wbudowanych narzędzi zamiast udostępniania całego zestawu narzędzi.

Podsumowanie dostępnych funkcji

Za pomocą usługi Merchant API MCP Access Service możesz wykonywać te czynności 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 listy i wyszukiwanie wielu produktów.
• Zapytania dotyczące danych o skuteczności, stanów produktów i statystyk popularnych produktów, statystyk cen, widoczności na tle konkurencji i statystyk programu partnerskiego Zakupów w YouTube.
• Identyfikuj problemy 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świetlaj zbiorcze powody odrzucenia produktów w całym asortymencie.
• Sprawdź ustawienia automatycznego poprawiania w przypadku produktów, zdjęć i dostawy.
• Sprawdź aktywne regiony, niespełnione wymagania i stan uczestnictwa w poszczególnych programach Merchant Center.

Pierwsze kroki

Aby połączyć IDE, asystenta kodowania lub agenta z usługą dostępu do MCP Merchant API, zaktualizuj ustawienia klienta MCP. Na przykład zaktualizuj plik mcp.json dla Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code lub niestandardowego frameworka agenta.

Konfiguracja usługi dostępu do MCP interfejsu Merchant API w wersji lokalnej wymaga konta usługi. W przypadku tego wykonania lokalnego bez interfejsu użytkownika nie jest obsługiwany protokół OAuth użytkownika standardowego. Musisz utworzyć konto usługi, pobrać plik JSON z kluczem prywatnym i podać ścieżkę do niego wraz z konkretnym identyfikatorem Merchant Center jako argumenty.

Szczegółowe instrukcje tworzenia i pobierania konta usługi znajdziesz w przewodniku po kontach usługi.

Konfiguracja klienta

Konfiguracje:

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

Przykładowe scenariusze użycia

Aby zilustrować, 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.

Prompt użytkownika:

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

Zachowanie pracownika obsługi klienta w przypadku MCP:

1. Agent wywołuje funkcję list_products lub get_product_by_name, aby sprawdzić 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ę, a także sugeruje, jak je rozwiązać (np. aktualizując informacje o cenie).

Scenariusz 2. Sprawdź zgodę na automatyczne poprawki

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

Prompt użytkownika:

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

Zachowanie pracownika obsługi klienta w przypadku MCP:

1. Agent wywołuje funkcję get_automatic_improvements, aby pobrać ustawienia na poziomie konta.
2. Serwer MCP zwraca konfigurację pokazującą stan ulepszeń obrazu, produktu 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 skuteczności i statystyk

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

Prompt użytkownika:

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

Zachowanie pracownika obsługi klienta w przypadku MCP:

1. Agent tworzy zapytanie w języku zapytań Merchant Center (MCQL), które jest kierowane na tabelę product_performance_view, sortowane według clicks DESC i ograniczone do 5.
2. Agent wywołuje funkcję report_search z utworzonym zapytaniem.
3. Serwer MCP wykonuje zapytanie w bieżącej bazie danych raportowania i zwraca wiersze.
4. Agent formatuje wyniki w postaci czytelnej tabeli 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 „price-updates” na moim koncie sprzedawcy”.

Zachowanie pracownika obsługi klienta 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ć, że elementy zostały przetworzone.

Narzędzia MCP i ich opisy

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