Diese Seite wurde von der Cloud Translation API übersetzt.

Fehlermeldungen

In diesem Dokument werden einige der Fehlercodes und -meldungen beschrieben, die von Google APIs zurückgegeben 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.

Die folgende JSON-Beispielantwort zeigt, wie ein globaler Fehler gemeldet wird:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "invalidParameter",
    "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]",
    "locationType": "parameter",
    "location": "chart"
   }
  ],
  "code": 400,
  "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]"
 }
}

Fehler

MOVED_PERMANENTLY (301)

Fehlercode	Beschreibung
`movedPermanently`	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`	Ihre Anfrage wurde erfolgreich verarbeitet. Eine Antwort erhältst du, wenn du eine `GET`-Anfrage an die im `Location`-Header angegebene URL sendest.
`mediaDownloadRedirect`	Ihre 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 geändert wurde und dass eine im Cache gespeicherte Antwort abgerufen werden soll. Prüfe den Wert des `If-None-Match`-HTTP-Headers der Anfrage.

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 Anfrage für eine binäre Domain ist ungültig.
`badContent`	Der Inhaltstyp der Anfragedaten oder eines Teils einer mehrteiligen Anfrage wird nicht unterstützt.
`badLockedDomainRequest`	Die Anfrage für eine gesperrte 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üfen Sie, ob der Wert des URL-Pfads korrekt ist.
`invalid`	Die Anfrage ist fehlgeschlagen, weil sie einen ungültigen Wert enthält. Der Wert kann ein Parameterwert, ein Header-Wert oder ein Property-Wert sein.
`invalidAltValue`	Der Parameterwert für `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. Lesen Sie in der API-Dokumentation nach, welche Parameter für Ihre Anfrage gültig sind.
`invalidQuery`	Die Anfrage ist ungültig. Sieh in der API-Dokumentation nach, welche Parameter für die Anfrage unterstützt werden und 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 finden Sie Ihren API-Schlüssel oder können einen anfordern.
`lockedDomainCreationFailure`	Das OAuth-Token wurde im Abfragestring empfangen, was diese API jedoch nur für die Antwortformate JSON oder XML zulässt. Versuchen Sie, falls möglich, stattdessen 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. Die erforderlichen Informationen können ein Parameter oder ein Ressourcenattribut sein.
`tooManyParts`	Die mehrteilige Anfrage ist fehlgeschlagen, weil sie zu viele Teile enthält.
`unknownApi`	Die von der Anfrage aufgerufene API wird nicht erkannt.
`unsupportedMediaProtocol`	Der Client verwendet ein nicht unterstütztes Medienprotokoll.
`unsupportedOutputFormat`	Der Parameterwert für `alt` gibt ein Ausgabeformat an, das für diesen 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 angeforderte Vorgang benötigt mehr Ressourcen, als das Kontingent zulässt. 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 angeforderte Vorgang ist unzulässig und kann 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.
`accessNotConfigured`	Das Projekt wurde aufgrund von Missbrauch gesperrt. Weitere Informationen findest du unter http://support.google.com/code/go/developer_compliance.
`accessNotConfigured`	Das Projekt wurde zum Löschen markiert.
`accountDeleted`	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, der die Anfrage stellt, wurde nicht bestätigt. 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. Nutzen Sie das Compliance-Support-Formular für Google-APIs, um das Problem zu beheben.
`dailyLimitExceededUnreg`	Die Anfrage ist fehlgeschlagen, weil ein Tageslimit für die nicht authentifizierte Verwendung der API erreicht wurde. Wenn Sie die API weiterhin verwenden möchten, müssen Sie sich über die Google Developers Console registrieren.
`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 erforderlichen 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 angeforderte Vorgang benötigt mehr Ressourcen, als das Kontingent zulässt.
`rateLimitExceeded`	Innerhalb eines bestimmten Zeitraums wurden zu viele Anfragen gesendet.
`rateLimitExceededUnreg`	Eine Ratenbegrenzung wurde überschritten. Sie müssen Ihre Anwendung registrieren, um die API weiter aufrufen zu können. Bitte melden Sie sich über die Google Developers Console an.
`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 die Ratenbegrenzung pro Nutzer erreicht wurde.
`userRateLimitExceededUnreg`	Die Anfrage ist fehlgeschlagen, weil die Ratenbegrenzung pro Nutzer erreicht wurde und der Cliententwickler in der Anfrage nicht angegeben war. Erstellen Sie in der Google Developers Console (https://console.developers.google.com) ein Projekt für Ihre Anwendung.
`variableTermExpiredDailyExceeded`	Die Anfrage ist fehlgeschlagen, weil ein Kontingent für variable Laufzeiten abgelaufen ist und ein Tageslimit erreicht wurde.
`variableTermLimitExceeded`	Die Anfrage ist fehlgeschlagen, weil ein Kontingentlimit für variable Laufzeiten erreicht wurde.

NOT_FOUND (404)

Fehlercode	Beschreibung
`notFound`	Der angefragte Vorgang ist fehlgeschlagen, weil eine mit der Anfrage verknüpfte Ressource nicht gefunden wurde.
`notFound`	Eine mit der Anfrage verbundene Ressource wurde nicht gefunden. Falls Sie diese API in den letzten zwei Wochen nicht genutzt haben, stellen Sie die App Engine-Anwendung noch einmal bereit und versuchen Sie es noch einmal.
`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-Headers der Anfrage.

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`	In der Anfrage ist ein Bereich angegeben, der nicht erfüllt werden kann.

EXPECTATION_FAILED (417)

Fehlercode	Beschreibung
`expectationFailed`	Eine Clienterwartung 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 eines bestimmten Zeitraums 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 angeforderte 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 Back-End-Fehler ist aufgetreten.
`backendNotConnected`	Die Anfrage ist aufgrund eines Verbindungsfehlers fehlgeschlagen.
`notReady`	Der API-Server ist für Anfragen nicht bereit.