Merchant API MCP Access Service (Alpha)

Aby uzyskać autoryzowany dostęp do danych i statystyk w Merchant Center, użyj usługi dostępu do protokołu Model Context Protocol (MCP) Merchant API. Dzięki temu możesz tworzyć nowe wrażenia związane z agentami i zautomatyzowane przepływy pracy.

Przegląd

Usługa dostępu do protokołu MCP Merchant API zapewnia standardowy i bezpieczny pomost dla dużych modeli językowych, agentów i asystentów kodowania, który umożliwia tworzenie i koordynowanie nowych wrażeń związanych z agentami oraz zautomatyzowanych przepływów pracy opartych na danych z Merchant Center.

Umożliwia ona autoryzowany dostęp do danych z Merchant Center oraz do generowanych przez Google raportów i statystyk, 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 skuteczności;
• sprawdzanie zgody na automatyczne ulepszenia;
• tworzenie i pobieranie źródeł danych.

Zabezpieczenia i kontrola dostępu

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

• Uwierzytelnianie: wykonywanie narzędzi podlega standardowemu uwierzytelnianiu w Merchant API, które wymaga danych uwierzytelniających OAuth 2.0 lub konta usługi. Zalecamy używanie danych uwierzytelniających 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 uwierzytelniających 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).

Istotne kwestie

Usługa dostępu do protokołu MCP Merchant API jest wersją 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 dostępu do protokołu MCP Merchant API 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 i bezpieczeństwo narzędzi

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

Podsumowanie dostępnych funkcji

Za pomocą usługi dostępu do protokołu MCP Merchant API możesz wykonywać te działania w sposób agentowy:

• Pobieranie szczegółowego stanu i kontekstu raportowania 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ń dotyczących 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ą dostępu do protokołu MCP Merchant API, zaktualizuj ustawienia klienta MCP. Na przykład zaktualizuj plik mcp.json w Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code lub w niestandardowej platformie agenta.

Konfiguracja lokalnej usługi dostępu do protokołu MCP Merchant API wymaga konta usługi. W przypadku tego bezgłowego wykonywania lokalnego OAuth użytkownika nie jest obsługiwany. Musisz utworzyć konto usługi, pobrać plik JSON z jego kluczem prywatnym i podać ścieżkę do niego oraz identyfikator w Merchant Center jako argumenty.

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

Konfiguracja klienta

Ustawienia konfiguracji:

{
    "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ę dostępu do protokołu MCP Merchant API do tworzenia wrażeń związanych z agentami 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?”

Działanie agenta z protokołem MCP:

1. Agent wywołuje funkcję 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?”

Działanie agenta z protokołem MCP:

1. Agent wywołuje funkcję 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 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ęć”.

Działanie agenta z protokołem MCP:

1. Agent tworzy zapytanie w języku zapytań Merchant Center (MCQL) kierowane na tabelę product_performance_view, sortując według clicks DESC i ograniczając do 5.
2. Agent wywołuje funkcję report_search z utworzonym zapytaniem.
3. Serwer MCP wykonuje zapytanie w aktywnej bazie danych raportów i zwraca wiersze.
4. Agent formatuje 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.

Zapytanie użytkownika:

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

Działanie agenta z protokołem MCP:

1. Agent wywołuje funkcję 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 funkcję fetch_data_source, aby rozpocząć pobieranie i przetwarzanie powiązanego pliku.
4. Agent wywołuje funkcję get_file_upload, aby monitorować postęp przesyłania i potwierdzić pomyślny stan przetwarzania produktów.

Narzędzia MCP i ich opisy

Usługa dostępu do protokołu MCP Merchant API udostępnia agentowi te narzędzia: