Fehlerantworten

Wenn eine API-Anfrage erfolgreich ist, gibt die API den 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, prüfen Sie die Felder message und status im JSON-Antworttext auf spezifische Details, die bei der Fehlerbehebung helfen können.

Fehlerformat

Wenn eine Anfrage zu einem Fehler führt, 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.
message 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. ein falscher Zeitraum oder ein falsch formatierter 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 der Data API. Möglicherweise überschreiten Sie die Limits pro Projekt oder pro Property.
500 INTERNAL Interner Serverfehler Ein unerwarteter Serverfehler ist aufgetreten. Dies ist in der Regel ein vorübergehendes Problem. Es wird empfohlen, die Anfrage mit exponentiellem Backoff zu wiederholen. Um die Kontingente für Serverfehler nicht zu überschreiten, ist es wichtig, exponentiellen Backoff mit Wiederholungslimits zu implementieren.
503 UNAVAILABLE Dienst nicht verfügbar Dieser Dienst ist vorübergehend nicht verfügbar. Dies ist in der Regel ein vorübergehendes Problem. Es wird empfohlen, die Anfrage mit exponentiellem Backoff zu wiederholen. Um die Kontingente für Serverfehler nicht zu überschreiten, ist es wichtig, exponentiellen Backoff mit Wiederholungslimits zu implementieren.