Fehlerantworten

Wenn eine API-Anfrage erfolgreich ist, gibt die API einen Statuscode 200 OK zusammen mit den angeforderten Daten im Antworttext zurück. Wenn ein Fehler auftritt, gibt die API einen der von Google APIs definierten kanonischen Fehlercodes zurück, der einem HTTP-Statuscode zugeordnet ist, sowie einen Antworttext mit Fehlerinformationen. Wenn ein Fehler auftritt, sehen Sie sich die Felder message und status im JSON-Antworttext an, um spezifische Details zur Fehlerbehebung zu erhalten.

Fehlerformat

Wenn bei einer Anfrage ein Fehler auftritt, gibt die API einen entsprechenden HTTP-Statuscode und einen JSON-Antworttext zurück. Die Fehlerantwort enthält ein error-Objekt mit der folgenden Struktur:

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

Das error-Objekt enthält die folgenden Felder:

Feld	Beschreibung
code	Der HTTP-Statuscode, z. B. 400, 401, 403, 429 oder 500.
Nachricht	Eine kurze Beschreibung des Fehlers.
status	Der kanonische Fehlercode, z. B. INVALID_ARGUMENT, UNAUTHENTICATED, PERMISSION_DENIED, RESOURCE_EXHAUSTED oder INTERNAL.

Häufige Fehler

In der folgenden Tabelle sind häufige Fehler aufgeführt, die von der API zurückgegeben werden.

HTTP-Statuscode	Kanonischer Code	Grund	Beschreibung
400	INVALID_ARGUMENT	Ungültige Anfrage	Die Anfrage ist falsch formatiert. Dies kann durch fehlende oder ungültige Parameter verursacht werden, z. B. durch einen falschen Zeitraum oder einen fehlerhaft formatierten Filter.
401	UNAUTHENTICATED	Ungültige Anmeldedaten	Die Anfrage enthält keine gültigen Authentifizierungsdaten für die Zielressource. Dies kann passieren, wenn das OAuth 2.0-Zugriffstoken fehlt, ungültig oder abgelaufen ist. Folgen Sie der Anleitung unter Mit OAuth 2.0 authentifizieren, um ein gültiges Token zu erhalten.
403	PERMISSION_DENIED	Unzureichende Berechtigungen	Der authentifizierte Nutzer hat keinen Zugriff auf die angeforderte Google Analytics-Property.
429	RESOURCE_EXHAUSTED	Kontingent überschritten	Die Anfrage wurde abgelehnt, weil die API-Kontingentlimits erreicht wurden. Weitere Informationen finden Sie unter Limits und Kontingente für die Data API. Möglicherweise überschreiten Sie die Limits pro Projekt oder pro Property.
500	INTERNAL	Interner Serverfehler	Ein unerwarteter Serverfehler ist aufgetreten. Das ist in der Regel nur vorübergehend. Es wird empfohlen, die Anfrage mit exponentiellem Backoff zu wiederholen. Um eine Überschreitung der Kontingente für Serverfehler zu vermeiden, ist es wichtig, einen exponentiellen Backoff mit Wiederholungslimits zu implementieren.
503	UNAVAILABLE	Dienst nicht verfügbar	Dieser Dienst ist vorübergehend nicht verfügbar. Das ist in der Regel nur vorübergehend. Es wird empfohlen, die Anfrage mit exponentiellem Backoff zu wiederholen. Um eine Überschreitung der Kontingente für Serverfehler zu vermeiden, ist es wichtig, exponentiellen Backoff mit Wiederholungslimits zu implementieren.