Rozpocznij migrację

Ta strona zawiera wskazówki dotyczące planowania migracji interfejsu API oraz opis wymaganych czynności.

Planowanie migracji

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

   Poznaj nowe metody i zasoby wymagane w przypadku Merchant API.

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

   Aby ułatwić migrację, zapoznaj się z tymi materiałami:

   • Omówienie migracji z Content API: zawiera szczegółowe informacje o najważniejszych zmianach, o których należy pamiętać w przypadku Merchant API.
   • Przewodniki po migracji dotyczące poszczególnych interfejsów API: zapoznaj się z przewodnikami po migracji dotyczącymi poszczególnych interfejsów API, które są Ci potrzebne, ponieważ zawierają one ważne informacje, takie jak mapowania nowych pól. Przykład znajdziesz w artykule Migracja zarządzania produktami.
   • Dokumentacja Merchant API zawiera szczegółowe informacje o zasobach i metodach Merchant API.
   • Krótki przewodnik 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ć.

   Jeśli początkowo nie możesz przenieść całej implementacji Content API, ustal priorytety dla tych interfejsów API na podstawie ich ważności i złożoności.

   • Konta
   • Produkty
   • Źródła danych
   • Raporty
   Uwaga: w zależności od typu integracji możesz podejść do tego indywidualnie. Na przykład funkcja taka jak stany magazynowe może mieć wyższy priorytet.

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 możesz śledzić na stronie Przegląd.

   Uwaga: jeśli musisz przejść na nowy projekt w chmurze Google Cloud lub zarządzać kilkoma projektami podczas migracji, zapoznaj się z artykułem Zarządzanie projektami Google Cloud i przechodzenie na nie.

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ń w przypadku 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.

   Przewodniki zawierają fragmenty przykładowego kodu. Na przykład zapoznaj się z artykułem 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.

Zaplanuj wdrożenie

Zalecamy to podejście:

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

Wdrażanie migracji

1. Pracuj nad kodowaniem przy użyciu 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.