Z tego artykułu dowiesz się, jak włączyć interfejs API menu na swoim koncie i zintegrować się z nim. Poniżej znajdziesz szczegółowy opis procesu wdrażania i wstępnych wymagań. Podczas planowania integracji możesz się posiłkować tą stroną.
- Konfiguracja – konfigurowanie konta i planowanie procesu rozwoju.
- Rozwój – tworzenie i testowanie pliku danych.
- Launch (Uruchomienie) – ocena danych przed uruchomieniem.
Konfiguracja
Na tym etapie ważne jest, aby sprawdzić, czy Twoje konto w Portalu partnera jest w pełni skonfigurowane i gotowe do przyjmowania plików danych istotnych dla danych menu statycznych. Jeśli masz aktywną integrację przekierowania lub RwG, do której dodajesz metadane menu, Twoje dotychczasowe konto zostanie ponownie użyte do tej integracji. W przypadku integracji OwG Direct na tej platformie lub braku integracji zostaje utworzone nowe konto, a szczegóły dostępu są udostępniane e-mailem.
Otwórz swoje konto w Portalu partnera i otwórz stronę konfiguracji plików danych: Konfiguracja > Pliki danych. Do integracji pliku danych z danymi menu są dostępne 2 serwery SFTP: Generic i Merchants. Sprawdź, czy oba serwery SFTP mają skonfigurowany klucz publiczny SSH. Więcej informacji o konfigurowaniu kluczy SSH znajdziesz na tej stronie.
Typowy serwer SFTP może obsługiwać różne pliki danych, które mogą stosować różne schematy danych. Typ pliku danych google.food_menu akceptujący uporządkowane dane menu jest domyślnie włączony na koncie na początku procesu rejestracji. Jeśli podczas próby przesłania pliku danych pojawi się ten komunikat o błędzie:
„Nie udało się przetworzyć pliku danych. Podczas analizowania pliku danych wystąpił problem wewnętrzny. Usługa „google.food_menu” nie jest włączona. Napraw problem i spróbuj ponownie”. Aby włączyć ten typ pliku danych, skontaktuj się z odpowiednią osobą kontaktową w Google.
Na koniec otwórz stronę Konfiguracja > Dane kontaktowe i sprawdź, czy wszystkie Twoje dane kontaktowe są aktualne.
Programowanie
Etap rozwoju obejmuje główną część procesu wdrażania, czyli generowanie i testowanie plików danych. Pliki danych należy tworzyć i przesyłać na docelowy serwer SFTP codziennie. Przesłanie plików danych powinno zostać rozpoczęte w ciągu godziny od ich przesłania. Podczas generowania plików danych zapoznaj się z specyfikacją i przykładami. Chociaż specyfikacja jest przedstawiona w formacie protobuf, zalecamy przesyłanie plików danych w formacie JSON, ponieważ ułatwia to rozwiązywanie problemów. Z tego powodu próbki plików danych są również dostępne w formacie JSON.
Plik z danymi można szybko przetestować, korzystając z internetowego weryfikatora plików danych, który sprawdza, czy plik jest zgodny ze specyfikacją. Narzędzie pokazuje, czy plik jest zgodny ze schematem danych, a jeśli nie, wyświetla listę błędów. Aby przetestować cały plik danych, który składa się z kilku plików, prześlij go w środowisku piaskownicy, a po zakończeniu przetwarzania sprawdź wyniki w Portalu Partnera. Podczas przetwarzania pliku danych stosowane są dodatkowe reguły walidacji, które sprawdzają logikę biznesową i jakość danych.
Uruchom
Etap wdrażania można rozpocząć po zakończeniu wszystkich prac związanych z integracją i gdy plik danych produkcyjny zawiera prawidłowy asortyment menu restauracji.
Wymagania wstępne uruchomienia
Aby można było rozpocząć integrację, muszą zostać spełnione te warunki:
- Pliki danych są przetwarzane w środowisku produkcyjnym bez błędów.
- Plik danych produkcyjnych zawiera pełny asortyment objęty tą integracją na początku jej trwania.
- Większość danych o sprzedawcy jest zgodna z lokalizacjami w Mapach Google.
- Pliki danych produkcyjnych przeszły ocenę jakości danych.
- Integracja jest zgodna ze wszystkimi zasadami i wymaganiami dotyczącymi menu.
Ocena danych
Gdy przetwarzanie plików danych produkcyjnych przebiegnie bez błędów, może zostać przeprowadzony wewnętrzny proces oceny jakości danych menu. Celem tego procesu jest znalezienie niespójności w jakości danych, takich jak treści niezwiązane z jedzeniem w opisach potraw, niezgodność nazw potraw, ceny itp. W przypadku takich znalezisk opinia zostanie przekazana zespołowi programistów.