Odpowiedzi na błędy

Gdy żądanie do interfejsu API zostanie zrealizowane, interfejs API zwraca kod stanu 200 OK wraz z żądanymi danymi w treści odpowiedzi. Jeśli wystąpi błąd, interfejs API zwróci jeden z kanonicznych kodów błędów zdefiniowanych przez interfejsy API Google, który jest powiązany z kodem stanu HTTP, oraz treść odpowiedzi zawierającą informacje o błędzie. W przypadku wystąpienia błędu sprawdź pola message i status w treści odpowiedzi JSON, aby uzyskać szczegółowe informacje pomocne w debugowaniu.

Format błędu

Jeśli żądanie spowoduje błąd, interfejs API zwróci odpowiedni kod stanu HTTP i treść odpowiedzi w formacie JSON. Odpowiedź o błędzie zawiera obiekt error o tej strukturze:

{
  "error": {
    "code": 403,
    "message": "User does not have sufficient permissions for this property.",
    "status": "PERMISSION_DENIED"
  }
}

Obiekt error zawiera te pola:

Pole Opis
kod Kod stanu HTTP, np. 400, 401, 403, 429 lub 500.
wiadomość Krótki opis błędu.
stan Kanoniczny kod błędu, np. INVALID_ARGUMENT, UNAUTHENTICATED, PERMISSION_DENIED, RESOURCE_EXHAUSTED lub INTERNAL.

Typowe błędy

W tabeli poniżej znajdziesz listę typowych błędów zwracanych przez interfejs API.

Kod stanu HTTP Kod kanoniczny Przyczyna Opis
400 INVALID_ARGUMENT Nieprawidłowe żądanie Żądanie jest błędnie sformatowane. Może to być spowodowane brakującymi lub nieprawidłowymi parametrami, takimi jak nieprawidłowy zakres dat lub źle sformatowany filtr.
401 UNAUTHENTICATED Nieprawidłowe dane logowania Żądanie nie ma prawidłowych danych uwierzytelniających dla zasobu docelowego. Może się tak zdarzyć, jeśli brakuje tokena dostępu OAuth 2.0, jest on nieprawidłowy lub wygasł. Aby uzyskać prawidłowy token, postępuj zgodnie z instrukcjami w sekcji Uwierzytelnianie za pomocą protokołu OAuth 2.0.
403 PERMISSION_DENIED Niewystarczające uprawnienia Uwierzytelniony użytkownik nie ma dostępu do żądanej usługi w Google Analytics.
429 RESOURCE_EXHAUSTED Przekroczono limit miejsca Żądanie zostało odrzucone, ponieważ osiągnięto limity interfejsu API. Więcej informacji znajdziesz w artykule Limity i limity interfejsu Data API. Możesz przekraczać limity na projekt lub usługę.
500 INTERNAL Wewnętrzny błąd serwera Wystąpił nieoczekiwany błąd serwera. Zwykle jest to problem tymczasowy. Zalecamy ponowienie żądania ze wzrastającym czasem do ponowienia. Aby uniknąć przekroczenia limitów błędów serwera, ważne jest wdrożenie strategii wzrastającego czasu do ponowienia z limitami ponownych prób.
503 UNAVAILABLE Usługa jest niedostępna Usługa jest tymczasowo niedostępna. Zwykle jest to problem tymczasowy. Zalecamy ponowienie żądania ze wzrastającym czasem do ponowienia. Aby uniknąć przekroczenia limitów błędów serwera, ważne jest wdrożenie strategii wzrastającego czasu do ponowienia z limitami ponownych prób.