Rozpocznij migrację

Na tej stronie znajdziesz wskazówki dotyczące planowania migracji interfejsu API.

Następnie omówimy kroki, które musisz wykonać, aby przeprowadzić migrację.

Planowanie migracji

  1. Zmapuj metody Content API for Shopping na metody Merchant API.

    Warto dobrze poznać nowe metody i zasoby, których będziesz potrzebować w Merchant API.

  2. Poznaj najważniejsze zmiany, które mają wpływ na migrację.

    Zalecamy zapoznanie się z tymi materiałami i zapamiętanie ich, ponieważ będą przydatne podczas migracji:

    • Omówienie migracji z Content API: zawiera szczegółowe informacje o najważniejszych zmianach, o których należy pamiętać w Merchant API.
    • Przewodniki po migracji poszczególnych interfejsów API: zapoznaj się z przewodnikami po migracji poszczególnych interfejsów API, których potrzebujesz, ponieważ zawierają one ważne informacje, takie jak nowe mapowania pól. Przykład znajdziesz w artykule Migracja zarządzania produktami.
    • Dokumentacja Merchant API zawiera szczegółowe informacje o zasobach i metodach Merchant API.
    • Przewodnik Szybki start pokazuje, jak szybko zacząć korzystać z Merchant API, aby utworzyć konto i przesłać przykładowy produkt.
    • Przewodniki dotyczące poszczególnych funkcji: aby uzyskać więcej informacji lub wyjaśnień dotyczących wdrażania nowych funkcji, możesz zapoznać się z przewodnikami dotyczącymi funkcji dostępnymi w menu nawigacyjnym.
  3. Określ interfejsy API, które chcesz przenieść i wdrożyć.

    Określ 2 rzeczy:

    • funkcje Merchant API, które chcesz przenieść,
    • nowe funkcje, które chcesz wdrożyć.

    Gdy to zrobisz, możesz określić nakład pracy i listę priorytetów interfejsów API, nad którymi chcesz pracować.

    Zalecamy przeniesienie wszystkich lub jak największej liczby funkcji. Jeśli początkowo nie możesz przenieść całej implementacji Content API ze względu na znaczenie i złożoność, ustal priorytety dla tych interfejsów API:

Kroki migracji

  1. Zarejestruj się jako programista Aby korzystać z Merchant API, musisz utworzyć połączenie między projektem Google Cloud a głównym kontem Merchant Center. Ta jednorazowa rejestracja jest wymagana w przypadku każdego projektu Google Cloud, którego używasz z Merchant API. Cały proces znajdziesz tutaj.

  2. Przetestuj różne metody , aby ułatwić sobie rozpoczęcie pracy. Do przeprowadzania podstawowych testów zalecamy korzystanie z Google Eksploratora interfejsów API.

    Format adresów URL żądań do Merchant API jest następujący:

    https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}
    
  3. Wykorzystaj nasze przykłady kodu i biblioteki klienta.

    Aby skrócić czas wdrożenia i korzystać z gRPC, użyj bibliotek klienta i przykładów kodu.

    W naszych przewodnikach umieszczamy też fragmenty przykładowego kodu. Na przykład zobacz Dodawanie produktu.

  4. Przetestuj proste ścieżki użytkownika.

    Przeprowadź testy ścieżek użytkownika we wszystkich interfejsach API i funkcjach, które chcesz przenieść, aby osiągnąć te cele:

    • Przeniesione zasoby i wywołania mają prawidłowe wyniki odpowiedzi.
    • Współczynnik błędów pozostaje niski.

Planowanie wdrożenia

Zalecamy następujące podejście:

  • Wdrażaj po jednym interfejsie API lub metodzie.
  • Wdrażaj tylko w niewielkim segmencie firmy.
  • Cały czas monitoruj problemy.

Wdrażanie migracji

  1. Pracuj nad kodowaniem, korzystając z nowych zasobów i punktów końcowych.

    Po wstępnych testach i opracowaniu planu wdrożenia zintegruj Merchant API z przepływami pracy.

  2. Monitoruj.

    Przygotuj się na rozwiązywanie potencjalnych problemów.