Fehler beheben.

Die Google Drive API gibt zwei Ebenen mit Fehlerinformationen zurück:

  • HTTP-Fehlercodes und Header-Meldungen.
  • Ein JSON-Objekt im Antworttext mit zusätzlichen Details, anhand derer Sie ermitteln können, wie der Fehler behoben werden soll.

Google Drive-Anwendungen sollten alle Fehler erfassen und verarbeiten, die bei der Verwendung der REST API auftreten können. In diesem Leitfaden erfahren Sie, wie Sie bestimmte Fehler in der Drive API beheben können.

Zusammenfassung des HTTP-Statuscodes

Fehlercode Beschreibung
200 - OK Die Anfrage ist erfolgreich. Dies ist die Standardantwort für erfolgreiche HTTP-Anfragen.
400 - Bad Request Die Anfrage kann aufgrund eines Clientfehlers in der Anfrage nicht ausgeführt werden.
401 - Unauthorized Die Anfrage enthält ungültige Anmeldedaten.
403 - Forbidden Die Anfrage wurde empfangen und verstanden, aber der Nutzer ist nicht berechtigt, die Anfrage auszuführen.
404 - Not Found Die angeforderte Seite wurde nicht gefunden.
429 - Too Many Requests Zu viele Anfragen an die API.
500, 502, 503, 504 - Server Errors Während der Verarbeitung der Anfrage tritt ein unerwarteter Fehler auf.

400-Fehler

Diese Fehler bedeuten, dass die Anfrage inakzeptabel war, häufig aufgrund eines fehlenden erforderlichen Parameters.

badRequest

Dieser Fehler kann bei einem der folgenden Probleme in Ihrem Code auftreten:

  • Ein Pflichtfeld oder Parameter wurde nicht angegeben.
  • Der angegebene Wert oder eine Kombination aus vorgegebenen Feldern ist ungültig.
  • Sie haben versucht, einer Drive-Datei ein doppeltes übergeordnetes Element hinzuzufügen.
  • Sie haben versucht, ein übergeordnetes Element hinzuzufügen, das in der Verzeichnisgrafik einen Zyklus erstellen würde.

Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "global",
        "location": "orderBy",
        "locationType": "parameter",
        "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order.",
        "reason": "badRequest"
      }
    ],
    "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order."
  }
}

Um diesen Fehler zu beheben, überprüfen Sie das Feld message und passen Sie Ihren Code entsprechend an.

invalidSharingRequest

Für diesen Fehler gibt es mehrere Gründe. Um die Ursache zu ermitteln, werten Sie das Feld reason der zurückgegebenen JSON aus. Dieser Fehler tritt am häufigsten aus folgenden Gründen auf:

  • Das Teilen war erfolgreich, aber die Benachrichtigungs-E-Mail wurde nicht richtig zugestellt.
  • Die Änderung der ACL (Access Control List) ist für diesen Nutzer nicht zulässig.

Das Feld message gibt den tatsächlichen Fehler an.

Das Teilen war erfolgreich, aber die Benachrichtigungs-E-Mail wurde nicht richtig zugestellt

Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidSharingRequest",
        "message": "Bad Request. User message: \"Sorry, the items were successfully shared but emails could not be sent to email@domain.com.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

Um diesen Fehler zu beheben, teilen Sie dem Nutzer (freigebenden Nutzer) mit, dass er die Freigabe nicht durchführen konnte, da die Benachrichtigungs-E-Mail nicht an die Ziel-E-Mail-Adresse gesendet werden konnte. Der Nutzer sollte überprüfen, ob er die richtige E-Mail-Adresse hat und E-Mails empfangen kann.

Die ACL-Änderung ist für diesen Nutzer nicht zulässig

Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidSharingRequest",
        "message": "Bad Request. User message: \"ACL change not allowed.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

Prüfen Sie die Freigabeeinstellungen der Google Workspace-Domain, zu der die Datei gehört, um diesen Fehler zu beheben. Die Einstellungen untersagen möglicherweise die Freigabe außerhalb der Domain oder die Freigabe einer geteilten Ablage ist möglicherweise nicht zulässig.

401-Fehler

Diese Fehler bedeuten, dass die Anfrage kein gültiges Zugriffstoken enthält.

authError

Dieser Fehler tritt auf, wenn das von Ihnen verwendete Zugriffstoken entweder abgelaufen oder ungültig ist. Dieser Fehler kann auch durch fehlende Autorisierung für die angeforderten Bereiche verursacht werden. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "authError",
        "message": "Invalid Credentials",
        "locationType": "header",
        "location": "Authorization",
      }
    ],
    "code": 401,
    "message": "Invalid Credentials"
  }
}

Aktualisieren Sie das Zugriffstoken mit dem langlebigen Aktualisierungstoken, um diesen Fehler zu beheben. Wenn dies fehlschlägt, führe den Nutzer wie unter Google Drive-API-Bereiche auswählen beschrieben durch den OAuth-Ablauf.

403-Fehler

Diese Fehler bedeuten, dass ein Nutzungslimit überschritten wurde oder der Nutzer nicht die erforderlichen Berechtigungen hat. Um die Ursache zu ermitteln, werten Sie das Feld reason der zurückgegebenen JSON aus.

Informationen zu den Limits für die Drive API finden Sie unter Nutzungslimits. Weitere Informationen zu den Beschränkungen für Google Drive-Ordner finden Sie unter Beschränkungen für Dateien und Ordner.

activeItemCreationLimitExceeded

Ein activeItemCreationLimitExceeded-Fehler tritt auf, wenn das Limit für die Anzahl der pro Konto erstellten Elemente überschritten wurde. Jeder Nutzer kann über ein Konto bis zu 500 Millionen Elemente erstellen. Weitere Informationen finden Sie unter Limit für Nutzerelemente.

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "activeItemCreationLimitExceeded",
    "message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
   }
  ],
  "code": 403,
  "message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
 }
}

So beheben Sie diesen Fehler:

  1. Informieren Sie die Nutzer, dass in Drive die Erstellung von mehr als 500 Millionen Elementen verhindert wird.

  2. Wenn der Nutzer im selben Konto Elemente erstellen muss, weisen Sie ihn an, einige Objekte dauerhaft zu löschen. Andernfalls kann er ein anderes Konto verwenden, das die Anforderung bereits erfüllt.

appNotAuthorizedToFile

Dieser Fehler tritt auf, wenn Ihre Anwendung nicht in der ACL für die Datei aufgeführt ist. Dieser Fehler verhindert, dass der Nutzer die Datei mit Ihrer Anwendung öffnen kann. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "appNotAuthorizedToFile",
        "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
  }
}

Führen Sie einen der folgenden Schritte aus, um den Fehler zu beheben:

  • Öffnen Sie die Google Drive-Auswahl und bitten Sie den Nutzer, die Datei zu öffnen.
  • Weisen Sie den Nutzer an, die Datei über das Kontextmenü Öffnen mit in der Drive-Benutzeroberfläche Ihrer App zu öffnen.
  • Prüfen Sie mit der Methode files.get das Feld isAppAuthorized in der Ressource files, um festzustellen, ob die Datei von Ihrer Anwendung erstellt oder geöffnet wurde.

cannotModifyInheritedTeamDrivePermission

Dieser Fehler tritt auf, wenn ein Nutzer versucht, die übernommenen Berechtigungen eines Elements in einer geteilten Ablage zu ändern. Übernommene Berechtigungen können nicht von einem Element in einer geteilten Ablage entfernt werden. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "cannotModifyInheritedTeamDrivePermission",
        "message": "Cannot update or delete an inherited permission on a shared drive item."
      }
    ],
    "code": 403,
    "message": "Cannot update or delete an inherited permission on a shared drive item."
  }
}

Zum Beheben dieses Fehlers muss ein Nutzer die Berechtigungen für das direkte oder indirekte übergeordnete Element anpassen, von dem sie übernommen wurden. Weitere Informationen finden Sie unter Weitergabe von Berechtigungen. Sie können auch die Ressource permissions.permissionDetails abrufen, um zu sehen, ob die Berechtigungen für dieses Element in der geteilten Ablage übernommen oder direkt angewendet werden.

dailyLimitExceeded

Dieser Fehler tritt auf, wenn das API-Limit für Ihr Projekt erreicht wurde. Das folgende JSON-Beispiel ist eine Darstellung dieses Fehlers:

{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "dailyLimitExceeded",
        "message": "Daily Limit Exceeded"
      }
    ],
    "code": 403,
    "message": "Daily Limit Exceeded"
  }
}

Dieser Fehler wird angezeigt, wenn der Inhaber der Anwendung ein Kontingentlimit festgelegt hat, um die Nutzung einer bestimmten Ressource zu begrenzen. Um diesen Fehler zu beheben, entfernen Sie alle Nutzungsbeschränkungen für das Kontingent „Abfragen pro Tag“.

domainPolicy

Dieser Fehler tritt auf, wenn die Richtlinie für die Domain des Nutzers den Zugriff auf Google Drive durch Ihre Anwendung nicht zulässt. Das folgende JSON-Beispiel veranschaulicht diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "domainPolicy",
        "message": "The domain administrators have disabled Drive apps."
      }
    ],
    "code": 403,
    "message": "The domain administrators have disabled Drive apps."
  }
}

So beheben Sie diesen Fehler:

  1. Informieren Sie den Nutzer, dass Ihre Anwendung aufgrund der Domain nicht auf Dateien in Drive zugreifen kann.
  2. Weisen Sie den Nutzer an, sich an den Domainadministrator zu wenden, um Zugriff auf Ihre Anwendung anzufordern.

fileOwnerNotMemberOfTeamDrive

Dieser Fehler tritt auf, wenn der Dateieigentümer kein Mitglied ist und versucht, eine Datei in eine geteilte Ablage zu verschieben. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileOwnerNotMemberOfTeamDrive",
        "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
      }
    ],
    "code": 403,
    "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
  }
}

So beheben Sie diesen Fehler:

  1. Fügen Sie das Mitglied mit role=owner der geteilten Ablage hinzu. Weitere Informationen finden Sie unter Dateien, Ordner und Laufwerke freigeben.

  2. Fügen Sie die Datei der geteilten Ablage hinzu. Weitere Informationen finden Sie unter Ordner erstellen und ausfüllen.

fileWriterTeamDriveMoveInDisabled

Dieser Fehler tritt auf, wenn ein Domainadministrator Nutzern mit role=writer nicht erlaubt hat, Elemente in eine geteilte Ablage zu verschieben. Der Nutzer, der versucht, die Elemente zu verschieben, hat weniger Berechtigungen als für die geteilte Zielablage zulässig. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileWriterTeamDriveMoveInDisabled",
        "message": "The domain administrator has not allowed writers to move items into a shared drive."
      }
    ],
    "code": 403,
    "message": "The domain administrator has not allowed writers to move items into a shared drive."
  }
}

Um diesen Fehler zu beheben, verwenden Sie für die geteilte Quell- und Zielablage dasselbe Administratornutzerkonto.

insufficientFilePermissions

Dieser Fehler tritt auf, wenn der Nutzer keinen Schreibzugriff auf eine Datei hat und Ihre Anwendung versucht, die Datei zu ändern. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "insufficientFilePermissions",
        "message": "The user does not have sufficient permissions for file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user does not have sufficient permissions for file {fileId}."
  }
}

Bitten Sie den Nutzer, sich an den Eigentümer der Datei zu wenden und Bearbeitungszugriff anzufordern, um diesen Fehler zu beheben. Sie können auch die Zugriffsebenen von Nutzern in den Metadaten prüfen, die mit der Methode files.get abgerufen werden, und eine schreibgeschützte UI anzeigen, wenn Berechtigungen fehlen.

myDriveHierarchyDepthLimitExceeded

Ein myDriveHierarchyDepthLimitExceeded-Fehler tritt auf, wenn das Limit für die Anzahl verschachtelter Ordnerebenen überschritten wurde. „Meine Ablage“ eines Nutzers darf nicht mehr als 100 Ebenen verschachtelter Ordner enthalten. Weitere Informationen finden Sie unter Limit für Ordnertiefen.

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "myDriveHierarchyDepthLimitExceeded",
    "message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/drive/api/guides/handle-errors#nested-folder-levels."
   }
  ],
  "code": 403,
  "message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/drive/api/guides/handle-errors#nested-folder-levels."
 }
}

So beheben Sie diesen Fehler:

  1. Informieren Sie die Nutzer, dass in Drive keine Ordner über 100 Ebenen gespeichert werden können.
  2. Wenn der Nutzer einen weiteren verschachtelten Ordner erstellen muss, weisen Sie ihn an, den vorgesehenen übergeordneten Ordner so neu zu organisieren, dass er weniger als 100 Ebenen enthält, oder einen anderen übergeordneten Ordner verwenden, der die Anforderung bereits erfüllt.

numChildrenInNonRootLimitExceeded

Dieser Fehler tritt auf, wenn das Limit für die Anzahl der untergeordneten Elemente (Ordner, Dateien und Verknüpfungen) eines Ordners überschritten wurde. Ordner,Dateien und Verknüpfungen, die sich direkt in einem Ordner befinden, können auf 500.000 Elemente begrenzt sein. In Unterordnern verschachtelte Elemente werden nicht auf das Limit von 500.000 Elementen angerechnet. Weitere Informationen zu Beschränkungen für Drive-Ordner finden Sie unter Beschränkungen für Ordner in Google Drive.

Das folgende JSON-Beispiel zeigt diesen Fehler:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "numChildrenInNonRootLimitExceeded",
    "message": "The limit for this folder's number of children (files and folders) has been exceeded."
   }
  ],
  "code": 403,
  "message": "The limit for this folder's number of children (files and folders) has been exceeded."
 }
}

Führen Sie einen der folgenden Schritte aus, um den Fehler zu beheben:

  • Teilen Sie dem Nutzer mit,dass in Drive Ordner mit mehr als 500.000 Elementen verhindert werden.
  • Wenn der Nutzer dem gesamten Ordner weitere Elemente hinzufügen muss, weisen Sie ihn an, den Ordner so zu organisieren, dass er weniger als 500.000 Elemente enthält, oder einen ähnlichen Ordner verwenden, der bereits weniger Elemente enthält.

rateLimitExceeded

Dieser Fehler tritt auf, wenn das Ratenlimit des Projekts erreicht wurde. Dieses Limit variiert je nach Art der Anfrage. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "message": "Rate Limit Exceeded",
    "reason": "rateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}

Führen Sie einen der folgenden Schritte aus, um den Fehler zu beheben:

sharingRateLimitExceeded

Dieser Fehler tritt auf, wenn der Nutzer ein Freigabelimit erreicht und oft mit einem E-Mail-Limit verknüpft ist. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "Rate limit exceeded. User message: \"These item(s) could not be shared because a rate limit was exceeded: filename",
    "reason": "sharingRateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}

So beheben Sie diesen Fehler:

  1. Senden Sie keine E-Mails, wenn Sie große Mengen von Dateien freigeben.
  2. Wenn ein Nutzer mehrere Anfragen im Namen vieler Nutzer eines Google Workspace-Kontos stellt, sollten Sie ein Dienstkonto mit domainweiter Delegierung und den Parameter quotaUser in Betracht ziehen.

storageQuotaExceeded

Dieser Fehler tritt auf, wenn der Nutzer sein Speicherlimit erreicht hat. Das folgende JSON-Beispiel ist eine Darstellung dieses Fehlers:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "The user's Drive storage quota has been exceeded.",
    "reason": "storageQuotaExceeded",
   }
  ],
  "code": 403,
  "message": "The user's Drive storage quota has been exceeded."
 }
}

So beheben Sie diesen Fehler:

  1. Überprüfen Sie die Speicherlimits für Ihr Drive-Konto. Weitere Informationen finden Sie unter Speicher- und Uploadlimits für Google Workspace.

  2. Dateien im Google Drive-Speicherplatz verwalten

  3. Mehr Google-Speicherplatz kaufen

teamDriveFileLimitExceeded

Dieser Fehler tritt auf, wenn ein Nutzer versucht, das strenge Elementlimit auf einer geteilten Ablage zu überschreiten. Jeder Ordner in der geteilten Ablage eines Nutzers ist auf 400.000 Elemente beschränkt, einschließlich Dateien, Ordnern und Verknüpfungen. Dieses Limit basiert auf der Anzahl der Elemente, nicht auf der Speichernutzung. Weitere Informationen finden Sie im Hilfeartikel Beschränkungen für geteilte Ablagen in Google Drive.

Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveFileLimitExceeded",
        "message": "The file limit for this shared drive has been exceeded."
      }
    ],
    "code": 403,
    "message": "The file limit for this shared drive has been exceeded."
  }
}

Um den Fehler zu beheben, reduzieren Sie die Anzahl der Elemente in der geteilten Ablage. Geteilte Ablagen mit zu vielen Dateien sind möglicherweise schwer zu organisieren und zu durchsuchen.

teamDriveMembershipRequired

Dieser Fehler tritt auf, wenn ein Nutzer versucht, auf eine geteilte Ablage zuzugreifen, in der er kein Mitglied ist. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveMembershipRequired",
        "message": "The attempted action requires shared drive membership."
      }
    ],
    "code": 403,
    "message": "The attempted action requires shared drive membership."
  }
}

Führen Sie einen der folgenden Schritte aus, um den Fehler zu beheben:

  1. Bitten Sie den Administrator der geteilten Ablage, Sie mit den entsprechenden Berechtigungen für die auszuführende Aktion hinzuzufügen.

  2. Sehen Sie sich die Rollen und Berechtigungen in Drive an, um zu erfahren, wer auf geteilte Ablagen zugreifen und diese verwalten kann. Weitere Informationen zu Zugriffsebenen finden Sie unter Geteilte Ablage erstellen.

teamDrivesFolderMoveInNotSupported

Dieser Fehler tritt auf, wenn ein Nutzer versucht, einen Ordner aus „Meine Ablage“ in eine geteilte Ablage zu verschieben. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesFolderMoveInNotSupported",
        "message": "Moving folders into shared drives is not supported."
      }
    ],
    "code": 403,
    "message": "Moving folders into shared drives is not supported."
  }
}

Führen Sie einen der folgenden Schritte aus, um den Fehler zu beheben:

  • Verschieben Sie die einzelnen Elemente mithilfe der Drive API aus dem Ordner in eine geteilte Ablage. Legen Sie mit dem Parameter supportsAllDrives=true fest, dass sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt werden.

  • Wenn Sie den Ordner in eine geteilte Ablage verschieben müssen, verwenden Sie die Google Drive-UI. Weitere Informationen finden Sie unter Als Administrator Ordner in geteilte Ablagen verschieben.

teamDrivesParentLimit

Dieser Fehler tritt auf, wenn ein Nutzer versucht, einem Element in einer geteilten Ablage mehr als ein übergeordnetes Element hinzuzufügen. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesParentLimit",
        "message": "A shared drive item must have exactly one parent."
      }
    ],
    "code": 403,
    "message": "A shared drive item must have exactly one parent."
  }
}

Um diesen Fehler zu beheben, können Sie einer Datei mithilfe von Drive-Tastenkombinationen mehrere Links hinzufügen. Eine Verknüpfung kann nur ein übergeordnetes Element haben, eine Verknüpfungsdatei kann jedoch an die zusätzlichen Speicherorte kopiert werden. Weitere Informationen finden Sie unter Verknüpfung für eine Drive-Datei erstellen.

UrlLeaseLimitExceeded

Dieser Fehler tritt auf, wenn Sie versuchen, Google Play-Spieldaten über Ihre App zu speichern. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "UrlLeaseLimitExceeded",
    "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
   }
  ],
  "code": 403,
  "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
 }
}

Schließen Sie alle Uploads für einen Snapshot ab oder brechen Sie sie ab, bevor Sie weitere erstellen, um diesen Fehler zu beheben.

userRateLimitExceeded

Dieser Fehler tritt auf, wenn das Limit pro Nutzer erreicht wurde. Dies kann ein Limit aus der Google Cloud Console oder ein Limit des Drive-Back-Ends sein. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "userRateLimitExceeded",
    "message": "User Rate Limit Exceeded"
   }
  ],
  "code": 403,
  "message": "User Rate Limit Exceeded"
 }
}

Führen Sie einen der folgenden Schritte aus, um den Fehler zu beheben:

  • Erhöhen Sie das Kontingent pro Nutzer im Google Cloud-Projekt. Weitere Informationen erhalten Sie, wenn Sie eine Kontingenterhöhung anfordern.

Informationen zu den Limits für die Drive API finden Sie unter Nutzungslimits.

404-Fehler

Diese Fehler bedeuten, dass die angeforderte Ressource nicht zugänglich ist oder nicht vorhanden ist.

notFound

Dieser Fehler tritt auf, wenn der Nutzer keinen Lesezugriff auf eine Datei hat oder die Datei nicht vorhanden ist. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "notFound",
        "message": "File not found {fileId}"
      }
    ],
    "code": 404,
    "message": "File not found: {fileId}"
  }
}

So beheben Sie diesen Fehler:

  1. Informieren Sie den Nutzer, dass er keinen Lesezugriff auf die Datei hat oder die Datei nicht existiert.
  2. Bitten Sie den Nutzer, sich an den Eigentümer der Datei zu wenden und die Berechtigung für die Datei anzufordern.

Fehler vom Typ 429

Diese Fehler bedeuten, dass zu viele Anfragen zu schnell an die API gesendet wurden.

rateLimitExceeded

Dieser Fehler tritt auf, wenn der Nutzer in einem bestimmten Zeitraum zu viele Anfragen gesendet hat. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "rateLimitExceeded",
        "message": "Rate Limit Exceeded"
      }
    ],
    "code": 429,
    "message": "Rate Limit Exceeded"s
  }
}

Verwenden Sie zum Beheben dieses Fehlers den exponentiellen Backoff, um die Anfrage noch einmal zu senden.

500-, 502-, 503-, 504-Fehler

Diese Fehler treten auf, wenn bei der Verarbeitung der Anfrage ein unerwarteter Serverfehler auftritt. Diese Fehler können verschiedene Ursachen haben, beispielsweise, wenn sich der Zeitpunkt einer Anfrage mit einer anderen Anfrage überschneidet, oder eine Anfrage für eine nicht unterstützte Aktion, z. B. der Versuch, die Berechtigungen für eine einzelne Seite in Google Sites anstatt für die gesamte Website zu aktualisieren.

Im Folgenden finden Sie eine Liste von 5xx-Fehlern:

  • 500-Backend-Fehler
  • 502 Fehlerhaftes Gateway
  • 503 Dienst nicht verfügbar
  • 504 Gateway-Zeitüberschreitung

Verwenden Sie zum Beheben dieses Fehlers den exponentiellen Backoff, um die Anfrage noch einmal zu senden.