Sprawdzone metody

Te sprawdzone metody dotyczą kompleksowej integracji funkcji Zarezerwuj z Google oraz można ich używać, aby uniknąć problemów z użytecznością i wydajnością. Niska jakość danych może spowodować usunięcie zasobów reklamowych.

Pliki danych

  • Jeśli usługa nie ma ustalonej długości, ustaw duration_sec w pliku danych o dostępności na jedną z tych wartości:
    • Liczba sekund wymaganych do wykonania usługi w rozsądny sposób.

    • Średnia liczba sekund wymagana do ukończenia usługi.

  • Wpisz wartość w polu Category w pliku danych sprzedawcy. Na przykład restauracja może przesłać określony typ, taki jak francuski lub japoński. Więcej informacji o możliwych wartościach kategorii znajdziesz w sekcji Typy miejsc.

  • Ustaw warunki usługi dla sprzedawcy w polu Terms w pliku danych sprzedawcy, aby pod przyciskiem Zarezerwuj wyświetlała się taka informacja:

    Przechodząc dalej, wyrażasz zgodę na Warunki korzystania z usługi <merchant>.
    W tym przypadku „Warunki korzystania z usługi” to link, którego kliknięcie powoduje wyświetlenie tekstu ustawionego w polu tekstowym Warunki.

  • Skompresuj pliki danych za pomocą gzip

Serwer rezerwacji

Aby zoptymalizować integrację interfejsu API Map Google, wykonaj te czynności:

  • Zawsze używaj sygnatur czasowych UNIX w formacie UTC.
  • Wygeneruj unikalny identyfikator rezerwacji, gdy nastąpi wywołanie nowej rezerwacji w interfejsie CreateBooking API.

Powiadomienia w czasie rzeczywistym

Aby zapewnić użytkownikom jak najlepsze wrażenia podczas rezerwacji, wykonaj te czynności:

  • W przypadku standardowej implementacji skorzystaj z interfejsu BookingNotification API, aby zmienić czas rozpoczęcia, czas trwania i stan rezerwacji, takie jak anulowanie lub nieobecność.
  • Po każdej zmianie rezerwacji z Zarezerwuj z Google zawsze wysyłaj aktualizacje w czasie rzeczywistym z systemu za pomocą interfejsu BookingNotification API w czasie rzeczywistym, aby zapewnić, że dane nie będą nieaktualne po stronie Zarezerwuj z Google. Na stronie Zarezerwuj z Google możesz na przykład anulować, przełożyć lub zaktualizować rezerwację w systemie.
  • Przy każdej aktualizacji rezerwacji z UpdateBookingRequest sprawdź, czy wartość UpdateBookingResponse zawiera identyfikator rezerwacji i czy wszystkie zaktualizowane pola muszą odzwierciedlać nową wartość.
  • Jeśli wdrożysz RTU asortymentu
    • Aktualizuj dostępność tylko zbiorczo z 100–1000 przedziałów na wywołanie interfejsu API.
    • Użyj pól *Restrict (np. startTimeRestrict), aby zawęzić cel edycji, zmniejszyć rozmiar ładunku i uniknąć ponownego wysyłania zbyt wielu niezmienionych danych.
    • Jeśli uruchomisz kilka wątków, zaimplementuj wykładniczy czas do ponowienia, aby uniknąć błędów ograniczania. Jeśli nie zaimplementujesz wykładniczo wykładnicznego błędu, może wystąpić błąd RESOURCE_EXHAUSTEDlimitu. Możesz spróbować wykonać ponowienie wykładnicze z powodu przekroczenia limitu, ale jeśli okaże się, że serwer często osiąga limity, gdy uruchamiasz ReplaceServiceAvailability, skonfiguruj serwer tak, aby zbiorczo zastąpić dostępność. To rozwiązanie zapobiega błędom związanym z limitem, ponieważ ogranicza liczbę wywołań interfejsu API, które musi wykonać Twoja usługa.
  • Ustaw limit czasu odpowiedzi na wywołanie interfejsu API krótszy niż sekundę. Sprawdź, czy serwer może obsłużyć 5 zapytań na sekundę (QPS) z co najmniej 95-sekundowym opóźnieniem poniżej sekundy.