Odpowiedzi na błędy

Gdy żądanie do interfejsu API zakończy się powodzeniem, interfejs API zwraca kod stanu 200 OK wraz z żądanymi danymi w treści odpowiedzi. Jeśli wystąpi błąd, interfejs API zwraca jeden z kanonicznych kodów błędów zdefiniowanych przez interfejsy API Google, przypisany do kodu 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, które pomogą w debugowaniu.

Format błędu

Jeśli żądanie spowoduje błąd, interfejs API zwróci odpowiedni kod stanu HTTP i treść odpowiedzi 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 typowe błędy zwracane 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, np. nieprawidłowym zakresem dat lub błędnie sformatowanym filtrem.
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ą 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 sekcji 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, aby wdrożyć wzrastający czas do ponowienia z limitami ponownych prób.
503 UNAVAILABLE Usługa jest niedostępna Usługa jest czasowo 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, aby wdrożyć wzrastający czas do ponowienia z limitami ponownych prób.