Limit

Limit interfejsu Display & Video 360 API ogranicza szybkość, z jaką projekt może wysyłać żądania do interfejsu API.

Aby lepiej wykorzystywać limit interfejsu Display & Video 360 API, postępuj zgodnie z tymi sprawdzonymi metodami.

Wysyłanie żądań do wielu reklamodawców jednocześnie

Limit interfejsu Display & Video 360 API jest ustawiany dla każdego projektu i reklamodawcy. Limity projektu ograniczają liczbę żądań wysyłanych przez projekt. Limit reklamodawcy ogranicza liczbę żądań wysyłanych przez projekt do reklamodawcy.

Aby wykorzystać cały limit projektu, wysyłaj żądania dotyczące reklamodawców w tym samym czasie.

Używanie parametrów zapytania list

Użyj parametrów zapytania metody list, aby uwzględnić tylko potrzebne zasoby. Mniejsza liczba zasobów wymaga mniejszej liczby żądań do wyświetlenia listy.

list metody oferują 3 kluczowe parametry:

  • pageSize określa liczbę zasobów, które mogą być zwracane przez żądanie. Domyślny rozmiar strony zależy od metody. Ustaw tę wartość na najwyższą, aby wyświetlać więcej zasobów w każdym żądaniu.
  • filter ogranicza listę zasobów według podanych kryteriów. Ustaw tę wartość, aby wyświetlić tylko podzbiór zasobów. Więcej informacji znajdziesz w sekcji Filtrowanie żądań dotyczących list.
  • orderBy porządkuje wymienione zasoby według podanej właściwości. Ustaw tę wartość, aby pobrać górną lub dolną granicę listy zasobów przy mniejszej liczbie żądań.

Korzystanie z funkcji zbiorczych i funkcji obejmujących wszystkie zasoby

Funkcje zbiorcze i obejmujące całe zasoby wykonują złożone zadania. Pojedyncze żądanie wysłane do tych metod może zastąpić wiele żądań wysłanych do innych metod.

Więcej informacji o tych metodach znajdziesz w artykule Żądania zbiorcze.

Identyfikatory pamięci podręcznej

Wiele działań w interfejsie Display & Video 360 API wymaga identyfikatorów pobranych za pomocą tego interfejsu. Mogą to być na przykład identyfikatory opcji kierowania i identyfikatory odbiorców Google. Przechowuj identyfikatory sklepów lokalnie, aby nie trzeba było ich ciągle pobierać.

Używanie identyfikatorów zasobów, które zostały wycofane lub usunięte, może powodować błędy. Aby potwierdzić ich stan, należy co tydzień pobierać identyfikatory z pamięci podręcznej.

Używanie wzrastającego czasu do ponowienia

Wzrastający czas do ponowienia to strategia obsługi błędów. Ponawia żądania przez coraz dłuższy czas.

Podczas sondowania długotrwałego działania, takiego jak pobieranie pliku SDF, strategia wzrastającego czasu do ponowienia może zmniejszyć liczbę wysyłanych żądań.

W naszych przykładach kodu pobierania plików SDF używamy wzrastającego czasu do ponowienia z naszymi bibliotekami klienta. Oto przykład przepływu z wzrastającym czasem do ponowienia:

  • Pobierz obiekt Operation za pomocą żądania get.
    • Jeśli done nie jest prawdą, zadanie jest nadal wykonywane.
    • Odczekaj 5 sekund plus losową liczbę sekund, a potem spróbuj ponownie.
  • Pobierz operację.
    • Jeśli done nie jest prawdą, zadanie jest nadal wykonywane.
    • Odczekaj 10 sekund plus losową liczbę sekund, a potem spróbuj jeszcze raz.
  • Pobierz operację.
    • Jeśli done nie jest prawdą, zadanie jest nadal wykonywane.
    • Zaczekaj 20 sekund plus losową liczbę sekund, a potem spróbuj jeszcze raz.
  • Pobierz operację.
    • Jeśli done nie jest prawdą, zadanie jest nadal wykonywane.
    • Zaczekaj 40 sekund plus losową liczbę sekund, a potem spróbuj jeszcze raz.
  • Pobierz operację.
    • Jeśli done nie jest prawdą, zadanie jest nadal wykonywane.
    • Odczekaj 80 sekund plus losową liczbę sekund, a potem spróbuj jeszcze raz.
  • Kontynuuj ten wzorzec, dopóki warunek done nie zostanie spełniony lub nie upłynie maksymalny czas.