Rozpocznij migrację

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

Następnie przedstawimy Ci kroki, które musisz wykonać, aby przeprowadzić migrację.

Planowanie migracji

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

    Dzięki temu łatwiej zrozumiesz nowe metody i zasoby, których potrzebujesz w przypadku interfejsu API sprzedawcy.

  2. Poznaj najważniejsze zmiany, które dotyczą Twojej migracji.

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

    • Omówienie migracji z Content API: szczegółowe informacje o najważniejszych zmianach, które należy uwzględnić w interfejsie Merchant API.
    • Przewodniki migracji dotyczące poszczególnych interfejsów API: zapoznaj się z przewodnikami migracji dotyczącymi poszczególnych interfejsów API, których potrzebujesz. Zawierają one ważne informacje, takie jak nowe mapowania pól. Przykład znajdziesz w artykule Przenoszenie zarządzania produktami.
    • Dokumentacja Merchant API zawiera szczegółowe informacje o zasobach i metodach Merchant API.
    • W przewodniku Krótkie wprowadzenie znajdziesz informacje o tym, jak szybko zacząć korzystać z interfejsu Merchant API, aby utworzyć konto i przesłać przykładowy produkt.
    • Przewodniki dotyczące poszczególnych funkcji: w przypadku wdrażania nowych funkcji lub uzyskania dodatkowych informacji możesz zapoznać się z przewodnikami dotyczącymi funkcji dostępnymi w menu.

  3. Określ interfejsy API, które chcesz przenieść i wdrożyć.

    Określ 2 rzeczy:

    • Funkcje interfejsu Merchant API, które musisz przenieść
    • nowe funkcje, które chcesz wdrożyć;

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

    Zalecamy przeniesienie wszystkich danych lub jak największej ich części. Jeśli początkowo nie możesz przeprowadzić migracji całej implementacji Content API ze względu na jej znaczenie i złożoność, nadaj priorytet tym interfejsom API:

Etapy migracji

  1. Zarejestruj się jako deweloper 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 interfejsem Merchant API. Cały proces możesz śledzić tutaj.

  2. Testuj różne metody, aby zwiększyć skuteczność. Do przeprowadzania podstawowych testów zalecamy używanie Eksploratora interfejsów API Google.

    Format adresów URL żądań do interfejsu Merchant API to

    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 skorzystać z gRPC, użyj bibliotek klienta i przykładowych kodów.

    W naszych przewodnikach umieszczamy też przykładowe fragmenty kodu. Więcej informacji znajdziesz na przykład w artykule Dodawanie produktu.

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

    Przeprowadź testy ścieżki użytkownika na wszystkich interfejsach API i funkcjach, które planujesz 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 wykonanie tych czynności:

  • Implementuj po jednym interfejsie API lub metodzie.
  • Wdrażaj je stopniowo, w małych segmentach firmy.
  • Cały czas sprawdzaj, czy nie występują problemy.

Przeprowadzanie migracji

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

    Po wstępnym przetestowaniu i opracowaniu planu wdrożenia zintegruj interfejs Merchant API z przepływami pracy.

  2. Monitoruj

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