Sprawdzone metody

Poniższe sprawdzone metody dotyczą kompleksowej integracji Reklam Usług Lokalnych z Centrum działań i można ich używać, aby uniknąć problemów z używalnością i wydajnością. Niska jakość danych może spowodować usunięcie zasobów reklamowych.

Pliki danych

  • Jeśli usługa nie ma określonej długości, w pliku danych o dostępności ustaw wartość duration_sec na jedną z tych opcji:
    • Liczba sekund, w których usługa może zostać wykonana w rozsądny sposób.

    • Średnia liczba sekund potrzebnych do wykonania usługi.

  • Upewnij się, że dane w polu Category w pliku danych sprzedawcy są szczegółowe. Na przykład restauracja może przesłać konkretny typ, np. kuchnię francuską lub japońską. Szczegółowe informacje o potencjalnych wartościach kategorii znajdziesz w artykule Typy miejsc.

  • W polu Terms pliku danych sprzedawcy ustaw warunki korzystania z usługi, aby pod przyciskiem Zarezerwuj wyświetlała się taka notatka:

    Kontynuując, akceptujesz Warunki korzystania z usługi <merchant>.
    W tym przypadku „Warunki korzystania z usługi” to link, który po kliknięciu wyświetla tekst ustawiony w polu tekstowym terms.

  • Kompresowanie plików danych za pomocą gzip

Serwer rezerwacji

Aby zoptymalizować integrację interfejsu Maps Booking API, wykonaj te czynności:

  • Zawsze używaj znaczników czasu UNIX w formacie UTC.
  • Wygeneruj unikalny identyfikator rezerwacji, gdy wywołana zostanie nowa rezerwacja w interfejsie CreateBooking API.

Aktualizacje w czasie rzeczywistym

Aby zapewnić użytkownikom jak najlepsze wrażenia podczas procesu rezerwacji:

  • W przypadku standardowej implementacji użyj interfejsu BookingNotifications API, aby zmienić czas rozpoczęcia, czas trwania i stan rezerwacji, na przykład anulowanie lub niestawienie się na spotkanie.
  • W przypadku każdej zmiany w rezerwacji w Centrum działań zawsze wysyłaj aktualizacje rezerwacji w czasie rzeczywistym z systemu za pomocą interfejsu BookingNotification API w czasie rzeczywistym, aby dane nie były nieaktualne po stronie Centrum działań. Możesz na przykład anulować, zmienić termin lub zaktualizować rezerwację w swoim systemie w Centrum działań.
  • W przypadku każdej aktualizacji rezerwacji z UpdateBookingRequest sprawdź, czy wartość UpdateBookingResponse zawiera identyfikator rezerwacji i czy wszystkie zaktualizowane pola odzwierciedlają nową wartość.
  • Jeśli wdrożone są wartości RTU zasobów reklamowych:
    • Aktualizuj dostępność tylko w partiach po 100–1000 miejsc na wywołanie interfejsu API.
    • Użyj pól *Restrict (np. startTimeRestrict), aby zawęzić zakres docelowy edycji, zmniejszyć rozmiar danych i uniknąć ponownego wysyłania zbyt dużej ilości niezmienionych danych.
    • Jeśli tworzysz kilka wątków, zastosuj wykładniczy odwrót, aby zapobiec błędom związanym z ograniczeniem przepustowości. Jeśli nie zastosujesz prawidłowo ujemnego wykładniczego, możesz otrzymać błąd RESOURCE_EXHAUSTED błędu limitu. Aby je rozwiązać, możesz ponownie użyć funkcji wykładniczego zmniejszania częstotliwości, ale jeśli okaże się, że Twój serwer często osiąga limity podczas wykonywania ReplaceServiceAvailability, skonfiguruj go tak, aby wykonywało się w partiach. To rozwiązanie zapobiega błędom związanym z limitem, ponieważ zmniejsza liczbę wywołań interfejsu API, które musi wykonać serwer.
  • Ustaw limity czasu odpowiedzi wywołania interfejsu API na mniej niż 1 sekundę. Upewnij się, że Twój serwer może obsłużyć 5 zapytań na sekundę (QPS) z opóźnieniem poniżej sekundy w co najmniej 95% czasu.