Diese Seite wurde von der Cloud Translation API übersetzt.

Fehler beheben.

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

HTTP-Fehlercodes und Headermeldungen.
Ein JSON-Objekt im Antworttext mit zusätzlichen Details, die Ihnen helfen können, den Fehler zu beheben.

Google Drive-Apps sollten alle Fehler abfangen und verarbeiten, die bei der Verwendung der REST API auftreten können. In dieser Anleitung finden Sie Informationen dazu, wie Sie bestimmte Drive API-Fehler beheben können.

Zusammenfassung der 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 bearbeitet werden.
`401 - Unauthorized`	Die Anfrage enthält ungültige Anmeldedaten.
`403 - Forbidden`	Die Anfrage wurde empfangen und verstanden, aber der Nutzer ist nicht berechtigt, sie 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`	Beim Verarbeiten der Anfrage ist ein unerwarteter Fehler aufgetreten.

400-Fehler

Diese Fehler bedeuten, dass die Anfrage nicht akzeptabel war, oft aufgrund eines fehlenden erforderlichen Parameters.

`badRequest`

Dieser Fehler kann durch eines der folgenden Probleme in Ihrem Code verursacht werden:

Ein erforderliches Feld oder ein erforderlicher Parameter wurde nicht angegeben.
Der angegebene Wert oder eine Kombination der angegebenen Felder ist ungültig.
Sie haben versucht, einer Drive-Datei einen doppelten übergeordneten Ordner hinzuzufügen.
Sie haben versucht, ein übergeordnetes Element hinzuzufügen, das einen Zyklus im Verzeichnisgraphen erzeugen würde.

Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

{
  "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, prüfen Sie das Feld message und passen Sie Ihren Code entsprechend an.

`illegalKeepForeverModification`

Dieser Fehler tritt auf, wenn versucht wird, eine Blob-Datei-Revision, die als „Keep Forever“ (Unbefristet aufbewahren) gekennzeichnet ist, auf false festzulegen. Das folgende JSON-Beispiel zeigt diesen Fehler:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "illegalKeepForeverModification",
    "message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
   }
  ],
  "code": 400,
  "message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
 }
}

Um diesen Fehler zu beheben, löschen Sie eine Blob-Datei-Revision endgültig, um die Einstellung „Für immer behalten“ zu entfernen.

`invalidSharingRequest`

Dieser Fehler kann aus verschiedenen Gründen auftreten. Um die Ursache zu ermitteln, prüfen Sie das Feld reason der zurückgegebenen JSON. Dieser Fehler tritt am häufigsten aus folgenden Gründen auf:

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

Das Feld message gibt den tatsächlichen Fehler an.

Die Freigabe war erfolgreich, aber die Benachrichtigungs-E-Mail wurde nicht richtig zugestellt.

Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

{
  "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"
  }
}

Informiere den Nutzer (Freigebenden), dass die Freigabe nicht möglich war, weil die Benachrichtigungs-E‑Mail nicht an die Ziel-E‑Mail-Adresse gesendet werden konnte. Der Nutzer sollte prüfen, ob er die richtige E‑Mail-Adresse angegeben hat und ob er E‑Mails empfangen kann.

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

Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

{
  "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 verbieten möglicherweise die Freigabe außerhalb der Domain oder die Freigabe einer geteilten Ablage ist nicht zulässig.

401-Fehler

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

`authError`

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

{
  "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, leiten Sie den Nutzer durch den OAuth-Ablauf, wie unter Google Drive API-Bereiche auswählen beschrieben.

`fileNotDownloadable`

Dieser Fehler tritt auf, wenn Sie versuchen, die Methode revisions.get mit dem URL-Parameter alt=media für ein Google Workspace-Dokument zu verwenden. Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileNotDownloadable",
        "message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
      }
    ],
    "code": 403,
    "message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
  }
}

Versuchen Sie Folgendes, um diesen Fehler zu beheben:

Entfernen Sie den URL-Parameter alt=media, wenn Sie die Metadaten einer bestimmten Version aufrufen möchten, z. B. den MIME-Typ.
Verwenden Sie die files.export-Methode, um den Byte-Inhalt von Google Workspace-Dokumenten zu exportieren. Weitere Informationen finden Sie unter Inhalte aus Google Workspace-Dokumenten exportieren.

403-Fehler

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

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

`activeItemCreationLimitExceeded`

Der Fehler activeItemCreationLimitExceeded tritt auf, wenn das Limit für die Anzahl der pro Konto erstellten Elemente überschritten wurde. Jeder Nutzer kann bis zu 500 Millionen Elemente erstellen, die von einem Konto erstellt wurden. Weitere Informationen finden Sie unter Limit für Nutzer/Artikel.

{
 "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:

Informieren Sie den Nutzer, dass in Google Drive nicht mehr als 500 Millionen Elemente pro Konto erstellt werden können.
Wenn der Nutzer Elemente in diesem Konto erstellen muss, weisen Sie ihn an, einige Objekte endgültig zu löschen. Andernfalls können sie ein anderes Konto verwenden, das die Anforderung bereits erfüllt.

`appNotAuthorizedToFile`

Dieser Fehler tritt auf, wenn Ihre App nicht auf der ACL für die Datei steht. Dieser Fehler verhindert, dass der Nutzer die Datei mit Ihrer App öffnet. 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}."
  }
}

Versuchen Sie Folgendes, um diesen Fehler zu beheben:

Öffnen Sie die Google Drive-Auswahl und fordern Sie den Nutzer auf, 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.
Verwenden Sie die Methode files.get, um das Feld isAppAuthorized in der Ressource files zu prüfen und so zu bestätigen, dass Ihre App die Datei erstellt oder geöffnet hat.

`cannotModifyInheritedTeamDrivePermission`

Dieser Fehler tritt auf, wenn ein Nutzer versucht, die geerbten Berechtigungen eines Elements in einer geteilten Ablage zu ändern. Übernommene Berechtigungen können nicht aus einem Element in einer geteilten Ablage entfernt werden. Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

{
  "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."
  }
}

Um diesen Fehler zu beheben, muss ein Nutzer die Berechtigungen für das direkte oder indirekte übergeordnete Element anpassen, von dem sie übernommen wurden. Weitere Informationen finden Sie unter Funktionsweise von Berechtigungen. Sie können auch die permissions-Ressource 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 zeigt eine Darstellung dieses Fehlers:

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

Dieser Fehler tritt auf, wenn der Inhaber der Anwendung ein Kontingentlimit für die Nutzung einer bestimmten Ressource festgelegt hat. Um diesen Fehler zu beheben, entfernen Sie alle Nutzungslimits 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 über Ihre App nicht zulässt. Das folgende JSON-Beispiel zeigt 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:

Informieren Sie den Nutzer, dass Ihre App aufgrund der Domain nicht auf Dateien in Drive zugreifen darf.
Weisen Sie den Nutzer an, sich an den Domainadministrator zu wenden, um Zugriff für Ihre App zu beantragen.

`downloadRestrictedForRevision`

Dieser Fehler tritt auf, wenn der Nutzer eine Blob-Datei-Revision nicht herunterladen kann. Das folgende JSON-Beispiel ist eine Darstellung dieses Fehlers:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "download_restricted_for_revision",
        "message": "This revision cannot be downloaded by the authenticated user."
      }
    ],
    "code": 403,
    "message": "This revision cannot be downloaded by the authenticated user."
  }
}

Informieren Sie den Nutzer, dass Blob-Dateirevisionen nur heruntergeladen werden können, wenn sie als „Für immer behalten“ gekennzeichnet sind. Weitere Informationen finden Sie unter Revisionen angeben, die nicht automatisch gelöscht werden sollen.

`fileOwnerNotMemberOfTeamDrive`

Dieser Fehler tritt auf, wenn Sie versuchen, eine Datei in eine geteilte Ablage zu verschieben, der Dateieigentümer jedoch kein Mitglied ist. 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:

Fügen Sie das Mitglied der geteilten Ablage mit role=owner hinzu. Weitere Informationen finden Sie unter Dateien, Ordner und Ablagen freigeben.
Fügen Sie die Datei der geteilten Ablage hinzu. Weitere Informationen finden Sie unter Ordner erstellen und mit Inhalten fü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 in der Zielablage für geteilte Ablagen zulässig. Das folgende JSON-Beispiel ist eine Darstellung dieses Fehlers:

{
  "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 dasselbe Administratornutzerkonto sowohl für die Quell- als auch für die Zielablage.

`insufficientFilePermissions`

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

{
  "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}."
  }
}

Um diesen Fehler zu beheben, bitten Sie den Nutzer, sich an den Eigentümer der Datei zu wenden und Bearbeitungszugriff anzufordern. Sie können die Nutzerzugriffsebenen auch in den Metadaten prüfen, die mit der Methode files.get abgerufen werden, und eine schreibgeschützte Benutzeroberfläche anzeigen, wenn Berechtigungen fehlen.

`myDriveHierarchyDepthLimitExceeded`

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

{
 "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/workspace/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/workspace/drive/api/guides/handle-errors#nested-folder-levels."
 }
}

So beheben Sie diesen Fehler:

Informieren Sie den Nutzer, dass in Drive Ordner nicht mehr als 100 Ebenen tief platziert werden können.
Wenn der Nutzer einen weiteren verschachtelten Ordner erstellen muss, weisen Sie ihn an, den gewünschten übergeordneten Ordner so zu reorganisieren, dass er weniger als 100 Ebenen tief ist, oder einen anderen übergeordneten Ordner zu 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. Die Obergrenze für Ordner,Dateien und Verknüpfungen, die sich direkt in einem Ordner befinden, liegt bei 500.000 Elementen. Elemente, die in Unterordnern verschachtelt sind, werden nicht auf diese Beschränkung von 500.000 Elementen angerechnet. Weitere Informationen zu Ordnerbeschränkungen in Drive finden Sie unter Beschränkungen für Ordner in Google Drive.

Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

{
 "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."
 }
}

Versuchen Sie Folgendes, um diesen Fehler zu beheben:

Informieren Sie den Nutzer,dass in Drive Ordner mit mehr als 500.000 Elementen nicht zulässig sind.
Wenn der Nutzer dem vollständigen Ordner weitere Elemente hinzufügen muss, weisen Sie ihn an, den Ordner so zu reorganisieren, dass er weniger als 500.000 Elemente enthält, oder einen ähnlichen Ordner zu 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 stellt diesen Fehler dar:

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

Versuchen Sie Folgendes, um diesen Fehler zu beheben:

Erhöhen Sie das Kontingent pro Nutzer im Google Cloud-Projekt. Weitere Informationen finden Sie unter Kontingenterhöhung anfordern.
Batchanfragen, um mehrere API-Aufrufe in einer HTTP-Anfrage zu bündeln.
Verwenden Sie den exponentiellen Backoff, um die Anfrage zu wiederholen.

`sharingRateLimitExceeded`

Dieser Fehler tritt auf, wenn der Nutzer ein Freigabelimit erreicht hat. Er ist häufig mit einem E‑Mail-Limit verknüpft. Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

{
 "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:

Senden Sie keine E‑Mails, wenn Sie viele Dateien freigeben.
Wenn ein Nutzer zahlreiche Anfragen im Namen vieler Nutzer eines Google Workspace-Kontos stellt, sollten Sie ein Dienstkonto mit domainweiter Delegierung mit dem quotaUser-Parameter in Betracht ziehen.

`storageQuotaExceeded`

Dieser Fehler tritt auf, wenn der Nutzer sein Speicherlimit erreicht. Das folgende JSON-Beispiel zeigt 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:

Prüfen Sie die Speicherplatzlimits für Ihr Drive-Konto. Weitere Informationen finden Sie unter Speicher- und Uploadlimits für Google Workspace.
Speicherplatz in Google Drive, Gmail und Google Fotos verwalten
Mehr Google-Speicherplatz kaufen

`teamDriveFileLimitExceeded`

Dieser Fehler tritt auf, wenn ein Nutzer versucht, das strenge Elementlimit auf einem freigegebenen Laufwerk zu überschreiten. Pro Ordner in der geteilten Ablage eines Nutzers sind 500.000 Elemente zulässig, darunter Dateien, Ordner und Verknüpfungen. Diese Beschränkung basiert auf der Anzahl der Elemente, nicht auf der Speichernutzung. Weitere Informationen

Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

{
  "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 diesen Fehler zu beheben, müssen Sie die Anzahl der Elemente in der geteilten Ablage reduzieren. Geteilte Ablagen mit zu vielen Dateien sind möglicherweise schwer zu organisieren und zu durchsuchen.

`teamDriveHierarchyTooDeep`

Ein teamDriveHierarchyTooDeep-Fehler tritt auf, wenn das Limit für die Anzahl der verschachtelten Ordnerstufen in geteilten Ablagen überschritten wurde. Die geteilte Ablage eines Nutzers darf nicht mehr als 100 Ebenen verschachtelter Ordner enthalten. Weitere Informationen finden Sie unter Grenze für die Ordnerstruktur.

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "teamDriveHierarchyTooDeep",
    "message": "The shared drive hierarchy depth will exceed the limit."
   }
  ],
  "code": 403,
  "message": "The shared drive hierarchy depth will exceed the limit."
 }
}

So beheben Sie diesen Fehler:

Informieren Sie den Nutzer, dass Ordner in geteilten Ablagen nicht mehr als 100 Ebenen tief verschachtelt sein dürfen.
Wenn der Nutzer einen weiteren verschachtelten Ordner erstellen muss, weisen Sie ihn an, den gewünschten übergeordneten Ordner so zu reorganisieren, dass er weniger als 100 Ebenen tief ist, oder einen anderen übergeordneten Ordner zu verwenden, der die Anforderung bereits erfüllt.

`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 eine Darstellung dieses Fehlers:

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

Versuchen Sie Folgendes, um diesen Fehler zu beheben:

Bitten Sie den Administrator der geteilten Ablage, Sie mit den entsprechenden Berechtigungen für die Aktion hinzuzufügen, die Sie ausführen müssen.
Rollen und Berechtigungen in Google Drive Weitere Informationen zu Zugriffsebenen finden Sie auch 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 stellt diesen Fehler dar:

{
  "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."
  }
}

Versuchen Sie Folgendes, um diesen Fehler zu beheben:

Verschieben Sie die einzelnen Elemente aus dem Ordner mithilfe der Drive API in eine geteilte Ablage. Legen Sie den Parameter supportsAllDrives=true fest, um die Unterstützung von „Meine Ablage“ und geteilten Ablagen anzugeben.
Wenn Sie den Ordner in eine geteilte Ablage verschieben müssen, verwenden Sie die Drive-Benutzeroberfläche. Weitere Informationen finden Sie im Hilfeartikel Drive-Ordner in geteilte Ablagen verschieben (Administratoren).

`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 eine Darstellung dieses Fehlers:

{
  "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 Drive-Verknüpfungen verwenden, um einer Datei mehrere Links hinzuzufügen. Eine Verknüpfung kann zwar nur ein übergeordnetes Element haben, die Verknüpfungsdatei kann aber an die zusätzlichen Speicherorte kopiert werden. Weitere Informationen finden Sie unter Verknüpfung zu einer Drive-Datei erstellen.

`UrlLeaseLimitExceeded`

Dieser Fehler tritt auf, wenn Sie versuchen, Google Play-Spieldaten über Ihre Anwendung zu speichern. Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

{
 "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."
 }
}

Um diesen Fehler zu beheben, müssen Sie alle Uploads für einen Snapshot abschließen oder abbrechen, bevor Sie weitere erstellen.

`userRateLimitExceeded`

Dieser Fehler tritt auf, wenn das Limit pro Nutzer erreicht wurde. Dies kann ein Limit der Google Cloud Console oder ein Limit des Drive-Backends sein. Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

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

Versuchen Sie Folgendes, um diesen Fehler zu beheben:

Erhöhen Sie das Kontingent pro Nutzer im Google Cloud-Projekt. Weitere Informationen finden Sie unter Kontingenterhöhung anfordern.
Wenn ein Nutzer zahlreiche Anfragen im Namen vieler Nutzer eines Google Workspace-Kontos stellt, sollten Sie ein Dienstkonto mit domainweiter Delegierung mit dem quotaUser-Parameter in Betracht ziehen.
Verwenden Sie den exponentiellen Backoff, um die Anfrage zu wiederholen.

Informationen zu Drive API-Limits finden Sie unter Nutzungslimits.

404-Fehler

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

`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 eine Darstellung dieses Fehlers:

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

So beheben Sie diesen Fehler:

Wenn sich die Datei in einer geteilten Ablage befindet und Sie die Methode files.get verwenden, muss der Abfrageparameter supportsAllDrives auf true gesetzt sein.
Informieren Sie den Nutzer, dass er keinen Lesezugriff auf die Datei hat oder dass die Datei nicht vorhanden ist.
Bitten Sie den Nutzer, sich an den Eigentümer der Datei zu wenden und die Berechtigung für die Datei anzufordern.

429-Fehler

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

`rateLimitExceeded`

Dieser Fehler tritt auf, wenn der Nutzer innerhalb eines bestimmten Zeitraums zu viele Anfragen gesendet hat. Das folgende JSON-Beispiel zeigt eine Darstellung dieses Fehlers:

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

Verwenden Sie exponentiellen Backoff, um die Anfrage noch einmal zu senden.

Fehler 500, 502, 503, 504

Diese Fehler treten auf, wenn beim Verarbeiten der Anfrage ein unerwarteter Serverfehler auftritt. Diese Fehler können durch verschiedene Probleme verursacht werden, z. B. wenn sich der Zeitpunkt einer Anfrage mit dem einer anderen Anfrage überschneidet oder wenn eine Anfrage für eine nicht unterstützte Aktion gestellt wird, z. B. wenn versucht wird, Berechtigungen für eine einzelne Seite in Google Sites anstelle der gesamten 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 exponentiellen Backoff, um die Anfrage noch einmal zu senden.

Fehler beheben. Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Zusammenfassung der HTTP-Statuscodes

400-Fehler

badRequest

illegalKeepForeverModification

invalidSharingRequest

Die Freigabe war erfolgreich, aber die Benachrichtigungs-E-Mail wurde nicht richtig zugestellt.

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

401-Fehler

authError

fileNotDownloadable

403-Fehler

activeItemCreationLimitExceeded

appNotAuthorizedToFile

cannotModifyInheritedTeamDrivePermission

dailyLimitExceeded

domainPolicy

downloadRestrictedForRevision

fileOwnerNotMemberOfTeamDrive

fileWriterTeamDriveMoveInDisabled

insufficientFilePermissions

myDriveHierarchyDepthLimitExceeded

numChildrenInNonRootLimitExceeded

rateLimitExceeded

sharingRateLimitExceeded

storageQuotaExceeded

teamDriveFileLimitExceeded

teamDriveHierarchyTooDeep

teamDriveMembershipRequired

teamDrivesFolderMoveInNotSupported

teamDrivesParentLimit

UrlLeaseLimitExceeded

userRateLimitExceeded

404-Fehler

notFound

429-Fehler

rateLimitExceeded

Fehler 500, 502, 503, 504

Weitere Informationen

Fehler beheben.

`badRequest`

`illegalKeepForeverModification`

`invalidSharingRequest`

`authError`

`fileNotDownloadable`

`activeItemCreationLimitExceeded`

`appNotAuthorizedToFile`

`cannotModifyInheritedTeamDrivePermission`

`dailyLimitExceeded`

`domainPolicy`

`downloadRestrictedForRevision`

`fileOwnerNotMemberOfTeamDrive`

`fileWriterTeamDriveMoveInDisabled`

`insufficientFilePermissions`

`myDriveHierarchyDepthLimitExceeded`

`numChildrenInNonRootLimitExceeded`

`rateLimitExceeded`

`sharingRateLimitExceeded`

`storageQuotaExceeded`

`teamDriveFileLimitExceeded`

`teamDriveHierarchyTooDeep`

`teamDriveMembershipRequired`

`teamDrivesFolderMoveInNotSupported`

`teamDrivesParentLimit`

`UrlLeaseLimitExceeded`

`userRateLimitExceeded`

`notFound`

`rateLimitExceeded`