Ab April 2024 wird beim Anfordern eines Berichts der Fehler „Nicht unterstützte ApiVersion“ zurückgegeben. Weitere Informationen
Außerdem empfehlen wir Ihnen dringend, alle vorhandenen Search Ads 360-Implementierungen zur neuen API zu migrieren. Weitere Informationen finden Sie unter Erste Schritte und im Migrationsleitfaden zur neuen Search Ads 360 Reporting API.
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Dieses Dokument enthält einige der Fehlercodes und -meldungen, die von Google APIs ausgegeben werden. Die hier aufgeführten Fehler fallen in die globale oder Standard-Domain für Google APIs. Bei vielen APIs werden auch eigene Domains definiert, die API-spezifische Fehler ermitteln, die nicht in die globale Domain gehören. Bei diesen Fehlern ist der Wert der Property domain in der JSON-Antwort ein API-spezifischer Wert wie youtube.parameter.
Die Fehler auf dieser Seite sind nach ihrem in RFC 7231 definierten HTTP-Statuscode aufgeführt.
Anhand der folgenden JSON-Beispielantwort kannst du sehen, wie ein globaler Fehler gemeldet wird:
Diese und alle zukünftigen Anfragen für denselben Vorgang müssen an die im Location-Header dieser Antwort angegebene URL gesendet werden und nicht an die URL, an die diese Anfrage gesendet wurde.
SEE_OTHER (303)
Fehlercode
Beschreibung
seeOther
Deine Anfrage wurde erfolgreich verarbeitet. Eine Antwort erhältst du, wenn du eine GET-Anfrage an die im Location-Header angegebene URL sendest.
mediaDownloadRedirect
Deine Anfrage wurde erfolgreich verarbeitet. Eine Antwort erhältst du, wenn du eine GET-Anfrage an die im Location-Header angegebene URL sendest.
NOT_MODIFIED (304)
Fehlercode
Beschreibung
notModified
Die für einen „If-None-Match“-Header festgelegte Bedingung wurde nicht erfüllt. Diese Antwort gibt an, dass das angeforderte Dokument nicht verändert wurde und dass eine im Cache vorhandene Antwortvorlage abgerufen werden soll. Prüfe den Wert des If-None-Match-HTTP-Anfrage-Headers.
TEMPORARY_REDIRECT (307)
Fehlercode
Beschreibung
temporaryRedirect
Damit deine Anfrage verarbeitet wird, sende sie an die im Location-Header dieser Antwort angegebene URL.
BAD_REQUEST (400)
Fehlercode
Beschreibung
badRequest
Die API-Anfrage ist ungültig oder hat nicht das richtige Format. Daher hat der API-Server die Anfrage nicht verstanden.
badBinaryDomainRequest
Die binäre Domainanfrage ist ungültig.
badContent
Der Inhaltstyp der Anfragedaten oder eines Teils einer mehrteiligen Anfrage wird nicht unterstützt.
badLockedDomainRequest
Die Anfrage nach einer gesperrten Domain ist ungültig.
corsRequestWithXOrigin
Die CORS-Anfrage enthält einen XD3 X-Origin-Header, was auf eine fehlerhafte CORS-Anfrage hindeutet.
endpointConstraintMismatch
Die Anfrage ist fehlgeschlagen, weil sie nicht zur angegebenen API passt. Prüfe, ob der Wert des URL-Pfads korrekt ist.
invalid
Die Anfrage ist fehlgeschlagen, weil sie einen ungültigen Wert enthält. Dabei kann es sich um einen Parameter-, Header- oder Attributwert handeln.
invalidAltValue
Der Parameterwert alt gibt ein unbekanntes Ausgabeformat an.
invalidHeader
Die Anfrage ist fehlgeschlagen, weil sie einen ungültigen Header enthält.
invalidParameter
Die Anfrage ist fehlgeschlagen, weil sie einen ungültigen Parameter oder Parameterwert enthält. In der API-Dokumentation kannst du nachlesen, welche Parameter für deine Anfrage gültig sind.
invalidQuery
Die Anfrage ist ungültig. Du kannst in der API-Dokumentation nachlesen, welche Parameter für die Anfrage unterstützt werden, und kontrollieren, ob die Anfrage eine ungültige Kombination von Parametern oder einen ungültigen Parameterwert enthält. Prüfe den Wert des Anfrageparameters q.
keyExpired
Der API-Schlüssel in der Anfrage ist abgelaufen. Daher kann der API-Server das Kontingentlimit der Anwendung, die die Anfrage gesendet hat, nicht prüfen. In der Google Developers Console findest du weitere Informationen und kannst einen neuen Schlüssel anfordern.
keyInvalid
Der API-Schlüssel in der Anfrage ist ungültig. Daher kann der API-Server das Kontingentlimit der Anwendung, die die Anfrage gesendet hat, nicht prüfen. In der Google Developers Console findest du deinen API-Schlüssel oder kannst einen anfordern.
lockedDomainCreationFailure
Das OAuth-Token wurde im Abfragestring empfangen, was diese API jedoch nur für die Antwortformate JSON oder XML zulässt. Du kannst stattdessen versuchen, das OAuth-Token im Autorisierungs-Header zu senden.
notDownload
An /download/*-URL-Pfade dürfen nur Mediendownload-Anfragen gesendet werden. Sende die Anfrage noch einmal an den Pfad, aber ohne das Präfix /download.
notUpload
Die Anfrage ist fehlgeschlagen, da es sich nicht um eine Uploadanfrage handelt. An /upload/*-URIs dürfen nur Uploadanfragen gesendet werden. Sende die Anfrage noch einmal an den Pfad, aber ohne das Präfix /upload.
parseError
Der API-Server kann den Anfragetext nicht parsen.
required
In der API-Anfrage fehlen erforderliche Informationen. Dies kann ein Parameter oder ein Ressourcenattribut sein.
tooManyParts
Die mehrteilige Anfrage ist fehlgeschlagen, weil sie zu viele Teile enthält.
unknownApi
Die in der Anfrage aufgerufene API ist nicht bekannt.
unsupportedMediaProtocol
Der Client verwendet ein nicht unterstütztes Medienprotokoll.
unsupportedOutputFormat
Der Parameterwert alt gibt ein Ausgabeformat an, das zusammen mit diesem Dienst nicht unterstützt wird. Prüfe den Wert des Anfrageparameters alt.
wrongUrlForUpload
Die Anfrage ist eine Uploadanfrage, aber sie ist fehlgeschlagen, weil sie nicht an den richtigen URI gesendet wurde. Uploadanfragen müssen an URIs mit dem Präfix /upload/* gesendet werden. Sende die Anfrage noch einmal an den Pfad, aber mit dem Präfix /upload.
UNAUTHORIZED (401)
Fehlercode
Beschreibung
unauthorized
Der Nutzer ist zu dieser Anfrage nicht berechtigt.
authError
Die für die Anfrage angegebenen Autorisierungsanmeldedaten sind ungültig. Prüfe den Wert des Authorization-HTTP-Headers der Anfrage.
expired
Sitzung abgelaufen. Prüfe den Wert des Authorization-HTTP-Headers der Anfrage.
lockedDomainExpired
Die Anfrage ist fehlgeschlagen, weil eine zuvor gültige gesperrte Domain abgelaufen ist.
required
Der Nutzer muss angemeldet sein, um die API-Anfrage senden zu können. Prüfe den Wert des Authorization-HTTP-Headers der Anfrage.
PAYMENT_REQUIRED (402)
Fehlercode
Beschreibung
dailyLimitExceeded402
Ein vom Entwickler festgelegtes Tagesbudgetlimit wurde erreicht.
quotaExceeded402
Der angefragte Vorgang benötigt mehr Ressourcen, als das Kontingent vorsieht. Es ist eine Zahlung erforderlich, um den Vorgang abzuschließen.
user402
Der angefragte Vorgang erfordert eine Zahlung durch den authentifizierten Nutzer.
FORBIDDEN (403)
Fehlercode
Beschreibung
forbidden
Der angefragte Vorgang ist verboten und kann daher nicht abgeschlossen werden.
accessNotConfigured
Ihr Projekt ist nicht für den Zugriff auf diese API konfiguriert. Aktiviere in der Google Developers Console die API für dein Projekt.
Das mit den Autorisierungsanmeldedaten der Anfrage verknüpfte Nutzerkonto wurde gelöscht. Prüfe den Wert des Authorization-HTTP-Headers der Anfrage.
accountDisabled
Das mit den Autorisierungsanmeldedaten der Anfrage verknüpfte Nutzerkonto wurde deaktiviert. Prüfe den Wert des Authorization-HTTP-Headers der Anfrage.
accountUnverified
Die E-Mail-Adresse des Nutzers, von dem die Anfrage stammt, wurde nicht überprüft. Prüfe den Wert des Authorization-HTTP-Headers der Anfrage.
concurrentLimitExceeded
Die Anfrage ist fehlgeschlagen, weil ein Limit für die gleichzeitige Verwendung erreicht wurde.
dailyLimitExceeded
Ein Tageslimit des Kontingents für die API wurde erreicht.
dailyLimitExceeded
Das Tageslimit des Kontingents wurde erreicht und das Projekt wurde aufgrund von Missbrauch gesperrt. Rufe das Compliance-Support-Formular für Google APIs auf, um das Problem zu beheben.
dailyLimitExceededUnreg
Die Anfrage ist fehlgeschlagen, weil ein Tageslimit für die nicht authentifizierte Verwendung der API erreicht wurde. Für eine weitere Nutzung der API ist eine Anmeldung über die Google Developers Console erforderlich.
downloadServiceForbidden
Die API unterstützt keinen Downloaddienst.
insufficientAudience
Die Anfrage kann für diese Zielgruppe nicht abgeschlossen werden.
insufficientAuthorizedParty
Die Anfrage kann für diese Anwendung nicht abgeschlossen werden.
insufficientPermissions
Der authentifizierte Nutzer hat nicht die notwendigen Berechtigungen, um diese Anfrage auszuführen.
limitExceeded
Die Anfrage kann aufgrund von Zugriffs- oder Ratenbegrenzungen nicht abgeschlossen werden.
lockedDomainForbidden
Diese API unterstützt keine gesperrten Domains.
quotaExceeded
Der angefragte Vorgang benötigt mehr Ressourcen, als das Kontingent vorsieht.
rateLimitExceeded
Innerhalb einer bestimmten Zeitspanne wurden zu viele Anfragen gesendet.
rateLimitExceededUnreg
Eine Ratenbegrenzung wurde überschritten. Du musst deine Anwendung registrieren, um die API weiter aufzurufen. Verwende zum Anmelden die Google Developers Console.
responseTooLarge
Die angefragte Ressource kann aufgrund ihrer Größe nicht zurückgegeben werden.
servingLimitExceeded
Die für die API angegebene Gesamtratenbegrenzung wurde bereits erreicht.
sslRequired
Für diesen Vorgang ist SSL erforderlich.
unknownAuth
Der API-Server erkennt das für die Anfrage verwendete Autorisierungsschema nicht. Prüfe den Wert des Authorization-HTTP-Headers der Anfrage.
userRateLimitExceeded
Die Anfrage ist fehlgeschlagen, weil eine Ratenbegrenzung pro Nutzer erreicht wurde.
userRateLimitExceededUnreg
Die Anfrage ist fehlgeschlagen, weil eine Ratenbegrenzung pro Nutzer erreicht wurde und der Cliententwickler in der Anfrage nicht angegeben war. Verwende die Google Developers Console (https://console.developers.google.com), um ein Projekt für deine Anwendung zu erstellen.
variableTermExpiredDailyExceeded
Die Anfrage ist fehlgeschlagen, weil ein variables Laufzeitkontingent abgelaufen ist und ein Tageslimit erreicht wurde.
variableTermLimitExceeded
Die Anfrage ist fehlgeschlagen, weil ein variables Laufzeitkontingentlimit erreicht wurde.
NOT_FOUND (404)
Fehlercode
Beschreibung
notFound
Der angefragte Vorgang ist fehlgeschlagen, weil eine mit der Anfrage verbundene Ressource nicht gefunden wurde.
notFound
Eine mit der Anfrage verbundene Ressource wurde nicht gefunden. Falls du diese API in den letzten zwei Wochen nicht genutzt hast, stellst du die Anwendung App Engine noch einmal bereit und versuchst dann, die API aufzurufen.
unsupportedProtocol
Das in der Anfrage verwendete Protokoll wird nicht unterstützt.
METHOD_NOT_ALLOWED (405)
Fehlercode
Beschreibung
httpMethodNotAllowed
Die mit der Anfrage verknüpfte HTTP-Methode wird nicht unterstützt.
CONFLICT (409)
Fehlercode
Beschreibung
conflict
Die API-Anfrage kann nicht abgeschlossen werden, da es sonst zu einem Konflikt zwischen dem angefragten Vorgang und einem vorhandenen Element käme. So würde beispielsweise eine Anfrage, bei der versucht wird, ein Element zu duplizieren, zu einem Konflikt führen. Duplikate werden aber in der Regel mit spezifischen Fehlercodes gekennzeichnet.
duplicate
Der angefragte Vorgang ist fehlgeschlagen, da versucht wurde, eine bereits vorhandene Ressource zu erstellen.
GONE (410)
Fehlercode
Beschreibung
deleted
Die Anfrage ist fehlgeschlagen, weil die damit verbundene Ressource gelöscht wurde.
PRECONDITION_FAILED (412)
Fehlercode
Beschreibung
conditionNotMet
Die im If-Match- oder If-None-Match-HTTP-Header der Anfrage festgelegte Bedingung wurde nicht erfüllt. Genauere Informationen findest du im Abschnitt ETag der HTTP-Spezifikation. Prüfe den Wert des If-Match-HTTP-Anfrage-Headers.
REQUEST_ENTITY_TOO_LARGE (413)
Fehlercode
Beschreibung
backendRequestTooLarge
Die Anfrage ist zu groß.
batchSizeTooLarge
Die Batchanfrage enthält zu viele Elemente.
uploadTooLarge
Die Anfrage ist fehlgeschlagen, weil die in der Anfrage gesendeten Daten zu groß sind.
REQUESTED_RANGE_NOT_SATISFIABLE (416)
Fehlercode
Beschreibung
requestedRangeNotSatisfiable
Durch die Anfrage wird ein Bereich angegeben, der nicht erfüllt werden kann.
EXPECTATION_FAILED (417)
Fehlercode
Beschreibung
expectationFailed
Eine Erwartung des Clients kann vom Server nicht erfüllt werden.
PRECONDITION_REQUIRED (428)
Fehlercode
Beschreibung
preconditionRequired
Die Anfrage erfordert eine Voraussetzung, die nicht gegeben ist. Damit die Anfrage ausgeführt werden kann, musst du entweder einen If-Match- oder einen If-None-Match-Header angeben.
TOO_MANY_REQUESTS (429)
Fehlercode
Beschreibung
rateLimitExceeded
Innerhalb einer bestimmten Zeitspanne wurden zu viele Anfragen gesendet.
INTERNAL_SERVER_ERROR (500)
Fehlercode
Beschreibung
internalError
Die Anfrage ist aufgrund eines internen Fehlers fehlgeschlagen.
NOT_IMPLEMENTED (501)
Fehlercode
Beschreibung
notImplemented
Der angefragte Vorgang wurde nicht implementiert.
unsupportedMethod
Die Anfrage ist fehlgeschlagen, weil eine unbekannte Methode oder ein unbekannter Vorgang ausgeführt werden sollte.
SERVICE_UNAVAILABLE (503)
Fehlercode
Beschreibung
backendError
Ein Backend-Fehler ist aufgetreten.
backendNotConnected
Die Anfrage war aufgrund eines Verbindungsfehlers nicht erfolgreich.