Rozpocznij migrację

Na tej stronie znajdziesz wskazówki dotyczące planowania migracji interfejsu API oraz opis wymaganych kroków.

Planowanie migracji

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

   Poznaj nowe metody i zasoby wymagane w przypadku interfejsu Merchant API.

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

   Zapoznaj się z tymi materiałami, które pomogą Ci w migracji:

   • Omówienie migracji z Content API: zawiera szczegółowe informacje o najważniejszych zmianach, o których należy pamiętać w przypadku interfejsu Merchant API.
   • Przewodniki po migracji dotyczące konkretnych podrzędnych interfejsów API: zapoznaj się z przewodnikami po migracji dotyczącymi konkretnych podrzędnych interfejsów API, ponieważ zawierają one ważne informacje, takie jak nowe mapowania pól. Przykład znajdziesz w sekcji Migracja zarządzania produktami.
   • Dokumentacja Merchant API zawiera szczegółowe informacje o zasobach i metodach Merchant API.
   • Z przewodnika Szybki start dowiesz się, jak szybko zacząć korzystać z interfejsu Merchant API, aby utworzyć konto i przesłać przykładowy produkt.
   • Przewodniki po funkcjach: jeśli chcesz wdrożyć nową funkcję lub potrzebujesz dodatkowych wyjaśnień, możesz zapoznać się z przewodnikami po funkcjach dostępnymi w panelu nawigacyjnym.

3. Określ podrzędne 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ć.

   Jeśli nie możesz od razu przenieść całej implementacji Content API, nadaj priorytet tym podrzędnym interfejsom API na podstawie ich ważności i złożoności.

   • Konta
   • Usługi
   • Źródła danych
   • Raporty
   Uwaga: możesz to zrobić indywidualnie dla każdego przypadku, w zależności od typu integracji. Na przykład funkcja taka jak Zasoby reklamowe może mieć wyższy priorytet.

Kroki migracji

1. Zarejestruj się jako deweloper Aby korzystać z interfejsu Merchant API, musisz utworzyć połączenie między projektem Google Cloud a podstawowym 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ć na stronie Przegląd.

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

2. Przetestuj różne metody, aby zwiększyć skuteczność. Do przeprowadzania podstawowych testów zalecamy korzystanie z 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. Wykorzystaj nasze przykładowe kody i biblioteki klienta.

   Aby skrócić czas implementacji i korzystać z zalet gRPC, używaj bibliotek klienta i przykładowego kodu.

   Przewodniki zawierają przykładowe fragmenty kodu. Zobacz na przykład Dodawanie produktu.

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

   Przeprowadź testy ścieżki użytkownika we wszystkich podrzędnych interfejsach API i funkcjach, które planujesz przenieść, aby:

   • Zasoby i wywołania po migracji zwracają prawidłowe wyniki.
   • Współczynnik błędów pozostaje niski.

Zaplanuj wdrożenie

Zalecamy następujące podejście:

• Wdrażaj po jednym podrzędnym interfejsie API lub metodzie naraz.
• Wdrażaj zmiany tylko w niewielkim segmencie działalności naraz.
• Stale monitoruj, czy nie występują problemy.

Przeprowadzanie migracji

1. Pracuj nad kodowaniem przy użyciu nowych zasobów i punktów końcowych.

   Po wstępnych testach i opracowaniu planu wdrażania zintegruj interfejs Merchant API ze swoimi przepływami pracy.

2. Monitorowanie.

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