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. Dopasuj metody Content API for Shopping do metod 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 musisz 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, które znajdziesz 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 jej znaczenie i złożoność, nadaj priorytet tym interfejsom 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 w chmurze Google, którego używasz z Merchant API. Cały proces znajdziesz tutaj.

  2. Testuj różne metody , aby szybciej się wdrożyć. Do przeprowadzania podstawowych testów zalecamy korzystanie z Google Eksploratora interfejsów API.

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

    https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}
    
  3. Korzystaj z naszych przykładowych fragmentów kodu i bibliotek klienta.

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

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

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

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

    • przeniesione zasoby i wywołania miały prawidłowe wyniki odpowiedzi;
    • odsetek błędów pozostał 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.