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 przegląd procesu wdrażania i wstępnych wymagań dotyczących uruchomienia. Podczas planowania integracji możesz się posiłkować tą stroną.
- Konfiguracja – konfigurowanie konta i planowanie procesu rozwoju.
- Rozwój – tworzenie i testowanie pliku danych.
- 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 związanych z danymi menu statycznych. Jeśli masz aktywną integrację przekierowania OwG 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 konto w Portalu partnera i otwórz stronę konfiguracji Dropboxa: Konfiguracja > Pliki danych. Do integracji pliku danych z menu dostępne są 2 pole wyboru: Ogólne i Sprzedawcy. Sprawdź, czy w obu skrzynkach referencyjnych skonfigurowano klucz publiczny SSH. Więcej informacji o konfigurowaniu kluczy SSH znajdziesz na tej stronie.
Ogólny obszar przechwytywania może przyjmować różne pliki danych, które mogą być zgodne z różnymi schematami 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 upewnij się, że 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 muszą być tworzone i przesyłane do docelowego folderu Dropbox codziennie. Przetwarzanie plików danych przesłanych w piaskownicy powinno rozpocząć się w ciągu godziny od ich przesłania. Pliki danych o produktach są przetwarzane raz dziennie o godzinie 12:00 czasu pacyficznego – do przetworzenia jest wybierany tylko najnowszy przesłany plik danych. 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łowe 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 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.