Ograniczenia

Na tej stronie znajdziesz listę różnych limitów związanych z interfejsem AdSense Management API. Mają one zastosowanie oprócz wszelkich limitów związanych z usługą (np. liczby kanałów na konto), które obowiązują ogólnie w AdSense.

Limity na poziomie interfejsu API

Wszystkie żądania wysyłane do interfejsu AdSense Management API są wliczane do ogólnych limitów liczby żądań, niezależnie od typu żądania.

Bieżące wykorzystanie każdego z tych limitów możesz sprawdzić na stronie Limity w konsoli interfejsów API Google. Możesz też skonfigurować alerty dotyczące wykorzystania lub dodatkowe monitorowanie. Więcej informacji znajdziesz w ogólnej dokumentacji z omówieniem limitów Google Cloud.

Przekroczenie tych limitów spowoduje odrzucenie żądania z błędem HTTP 429 – zbyt wiele żądań. Komunikat o błędzie będzie zawierać szczegółowe informacje o tym, który limit został przekroczony.

Opis Wartość Notatki
Zapytania na minutę w przypadku pojedynczego użytkownika i projektu 100 nie dotyczy
Zapytania na minutę dla wszystkich użytkowników korzystających z jednego projektu 500 nie dotyczy
Zapytania dziennie 10 000 Dzienne limity są resetowane około północy czasu pacyficznego.

Limity rozmiarów raportu

Maksymalny rozmiar raportów generowanych przez interfejs AdSense Management API zależy od formatu wyjściowego:

  • Raporty JSON (np.wygenerowane za pomocą metody accounts.reports.generate) mogą zawierać maksymalnie 100 tys.wierszy. Większe raporty zostaną obcięte, ale odpowiedź zawiera pole totalMatchedRows zawierające rozmiar pełnego raportu, dzięki któremu można sprawdzić, czy doszło do obcięcia.
  • Raporty CSV (np. wygenerowane metodą accounts.reports.generateCsv) mogą zawierać maksymalnie 1 000 000 wierszy. Większe raporty będą obcinane.

Limit wierszy raportu

Aby zapobiegać niewłaściwemu korzystaniu, interfejs AdSense Management API stosuje też limity do łącznej ilości danych do raportu, które mogą być pobierane w ciągu dnia i w krótszym okresie. Przekroczenie tych limitów spowoduje, że żądanie zostanie odrzucone i wyświetli się błąd HTTP 429 – zbyt wiele żądań – oraz pojawi się komunikat „Przekroczono limit wierszy raportu”.

Inne limity żądań

Różne parametry żądania określają ilość danych, które należy zwrócić w odpowiedzi na żądanie (np. page_size w przypadku żądań, które umożliwiają podział na strony, a parametr limit w przypadku żądań generowania raportów). Jeśli te parametry nie są określone, wartością domyślną jest zawsze maksymalna dozwolona wartość. Jeśli podasz wyższą wartość, żądanie zostanie odrzucone z powodu błędu HTTP 400 Bad Request.