Fehler beheben.

Die Google Drive API gibt zwei Fehlerebenen zurück:

  • HTTP-Fehlercodes und Header-Meldungen
  • Ein JSON-Objekt im Antworttext mit zusätzlichen Details, die Ihnen bei der Behebung des Fehlers helfen können.

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

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 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 zulässig 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 ein übergeordnetes Element hinzuzufügen, das bereits vorhanden ist.
  • Sie haben versucht, ein übergeordnetes Element hinzuzufügen, das einen Zirkel im Verzeichnisgraphen erzeugen würde.

Das folgende JSON-Beispiel ist 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."
  }
}

Prüfe das Feld message und passe den Code entsprechend an, um diesen Fehler zu beheben.

invalidSharingRequest

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

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

Das Feld message gibt den tatsächlichen Fehler an.

Freigabe war erfolgreich, aber die Benachrichtigungs-E-Mail wurde nicht korrekt zugestellt

Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

{
  "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, informiere den Nutzer (die Person, die die Freigabe vorgenommen hat), 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 hat und ob diese E-Mails empfangen kann.

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

Das folgende JSON-Beispiel ist 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. Möglicherweise verhindern die Einstellungen 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 ist 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 das nicht funktioniert, leite den Nutzer durch den OAuth-Vorgang, 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 in einem Google Workspace-Dokument zu verwenden. Das folgende JSON-Beispiel stellt diesen Fehler dar:

{
  "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 Google Workspace-Dokumenteninhalte 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-Datei.

Informationen zu den Limits der Drive API finden Sie unter Nutzungslimits. Informationen zu den Beschränkungen für Drive-Ordner finden Sie unter Datei- und Ordnerlimits.

activeItemCreationLimitExceeded

Ein activeItemCreationLimitExceeded-Fehler tritt auf, wenn die zulässige Anzahl der pro Konto erstellten Artikel überschritten wurde. Jeder Nutzer kann bis zu 500 Millionen Artikel über ein Konto 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 den Nutzer darüber, dass Drive das Erstellen von mehr als 500 Millionen Elementen durch Konten verhindert.

  2. Wenn der Nutzer Elemente in diesem Konto erstellen muss, bitte ihn, einige Objekte dauerhaft zu löschen. Andernfalls kann ein anderes Konto verwendet werden, das bereits die Anforderung erfüllt.

appNotAuthorizedToFile

Dieser Fehler tritt auf, wenn Ihre App nicht in der ACL für die Datei enthalten ist. Dieser Fehler hindert den Nutzer daran, die Datei mit Ihrer Anwendung zu öffnen. Das folgende JSON-Beispiel stellt diesen Fehler dar:

{
  "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 bitten Sie den Nutzer, die Datei zu öffnen.
  • Bitten Sie den Nutzer, die Datei in der Drive-Benutzeroberfläche Ihrer App über das Kontextmenü Öffnen mit zu öffnen.
  • Verwenden Sie die Methode files.get, um das Feld isAppAuthorized der Ressource files zu prüfen, um zu sehen, ob Ihre App die Datei erstellt oder geöffnet hat.

cannotModifyInheritedTeamDrivePermission

Dieser Fehler tritt auf, wenn ein Nutzer versucht, die übernommenen Berechtigungen für ein Element in einer geteilten Ablage zu ändern. Übernommene Berechtigungen können nicht von einem Element in einer geteilten Ablage entfernt werden. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

{
  "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 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 tritt auf, 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 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 Drive über Ihre App nicht zulässt. Das folgende JSON-Beispiel ist eine Darstellung dieses Fehlers:

{
  "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 in der Domain nicht auf Dateien in Drive zugreifen darf.
  2. Bitten Sie den Nutzer, sich an den Domainadministrator zu wenden, um Zugriff auf Ihre Anwendung anzufordern.

fileOwnerNotMemberOfTeamDrive

Dieser Fehler tritt auf, wenn Sie versuchen, eine Datei in eine geteilte Ablage zu verschieben, der Eigentümer der Datei aber kein Mitglied ist. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

{
  "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 der geteilten Ablage mit role=owner 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 befü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 Ziel-geteilte Ablage 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."
  }
}

Verwenden Sie zum Beheben dieses Fehlers dasselbe Administratorkonto für die Quell- und Zielfreigabeordner.

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

{
  "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. Sie können auch die Zugriffsebenen von Nutzern in den Metadaten prüfen, die mit der Methode files.get abgerufen wurden, und eine schreibgeschützte Benutzeroberfläche anzeigen, wenn Berechtigungen fehlen.

myDriveHierarchyDepthLimitExceeded

Ein myDriveHierarchyDepthLimitExceeded-Fehler tritt auf, wenn die maximale Anzahl verschachtelter Ordnerebenen überschritten wurde. „Meine Ablage“ eines Nutzers darf nicht mehr als 100 Ebenen verschachtelter Ordner enthalten. Weitere Informationen finden Sie unter 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/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 den Nutzer darüber, dass in Google Drive keine Ordner mit mehr als 100 Ebenen möglich sind.
  2. Wenn der Nutzer einen weiteren verschachtelten Ordner erstellen muss, bitte ihn, den gewünschten übergeordneten Ordner so zu organisieren, dass er weniger als 100 Ebenen hat, oder einen anderen übergeordneten Ordner zu verwenden, der bereits die Anforderung erfüllt.

numChildrenInNonRootLimitExceeded

Dieser Fehler tritt auf, wenn die Obergrenze für die Anzahl der untergeordneten Elemente (Ordner, Dateien und Verknüpfungen) eines Ordners überschritten wurde. Für Ordner, Dateien und Verknüpfungen direkt in einem Ordner gilt ein Limit von 500.000 Elementen. Elemente, die in Unterordnern verschachtelt sind, werden auf die maximale Anzahl von 500.000 Elementen nicht angerechnet. Weitere Informationen zu den Beschränkungen für Google Drive-Ordner finden Sie unter Beschränkungen für Ordner in Google Drive.

Das folgende JSON-Beispiel ist 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 darüber,dass in Drive keine Ordner mit mehr als 500.000 Elementen zulässig sind.
  • Wenn der Nutzer dem vollen Ordner weitere Elemente hinzufügen muss, bitte ihn, den Ordner so zu organisieren, 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 die Ratenbegrenzung des Projekts erreicht wurde. Dieser Grenzwert variiert je nach Anfragetyp. Das folgende JSON-Beispiel ist eine Darstellung dieses Fehlers:

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

Versuchen Sie Folgendes, um diesen Fehler zu beheben:

sharingRateLimitExceeded

Dieser Fehler tritt auf, wenn der Nutzer ein Freigabelimit erreicht. Er ist oft mit einem E-Mail-Limit verknüpft. Das folgende JSON-Beispiel ist 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:

  1. Senden Sie keine E-Mails, wenn Sie viele Dateien freigeben.
  2. Wenn ein Nutzer im Namen vieler Nutzer eines Google Workspace-Kontos mehrere Anfragen stellt, sollten Sie ein Dienstkonto mit domainweiter Delegierung mithilfe des Parameters 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. Prüfen Sie die Speicherlimits Ihres Drive-Kontos. 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 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. 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.

Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

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

Reduzieren Sie die Anzahl der Elemente in der geteilten Ablage, um diesen Fehler zu beheben. Geteilte Ablagen mit zu vielen Dateien sind möglicherweise schwer zu organisieren und zu suchen.

teamDriveHierarchyTooDeep

Ein teamDriveHierarchyTooDeep-Fehler tritt auf, wenn die maximale Anzahl der verschachtelten Ordnerebenen in einer geteilten Ablage überschritten wurde. Die geteilte Ablage eines Nutzers darf nicht mehr als 100 Ordnerebenen enthalten. Weitere Informationen finden Sie unter Limit für die Ordnertiefe.

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

  1. Informieren Sie den Nutzer, dass in geteilten Ablagen keine Ordner mit mehr als 100 Ebenen erstellt werden können.
  2. Wenn der Nutzer einen weiteren verschachtelten Ordner erstellen muss, bitte ihn, den vorgesehenen übergeordneten Ordner so zu organisieren, dass er weniger als 100 Ebenen hat, oder einen anderen übergeordneten Ordner zu verwenden, der bereits die Anforderung erfüllt.

teamDriveMembershipRequired

Dieser Fehler tritt auf, wenn ein Nutzer versucht, auf eine geteilte Ablage zuzugreifen, in der er kein Mitglied ist. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

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

  1. Bitten Sie den Administrator der geteilten Ablage, Ihnen die entsprechenden Berechtigungen für die Aktion zu erteilen, die Sie ausführen müssen.

  2. Unter Rollen und Berechtigungen in Google Drive erfahren Sie, wer auf geteilte Ablagen zugreifen und diese verwalten kann. Weitere Informationen zu Zugriffsebenen finden Sie unter Gemeinsames Laufwerk 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 ist eine Darstellung dieses Fehlers:

{
  "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 mithilfe der Drive API aus dem Ordner in eine geteilte Ablage. Legen Sie den Parameter supportsAllDrives=true so 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 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 einen übergeordneten Ordner hinzuzufügen. Das folgende JSON-Beispiel ist 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, fügen Sie einer Datei über Drive-Verknüpfungen mehrere Links hinzu. Eine Verknüpfung kann zwar nur ein übergeordnetes Element haben, aber eine Verknüpfungsdatei kann an die zusätzlichen Speicherorte kopiert werden. Weitere Informationen finden Sie unter Verknüpfung für Drive-Datei erstellen.

UrlLeaseLimitExceeded

Dieser Fehler tritt auf, wenn Sie versuchen, Google Play-Spieldaten über Ihre Anwendung zu speichern. Das folgende JSON-Beispiel ist 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, schließen Sie alle Uploads für einen Snapshot ab oder brechen Sie sie ab, bevor Sie weitere erstellen.

userRateLimitExceeded

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

{
 "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 diesen Fehler zu beheben:

Informationen zu den Limits der Drive API 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. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

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

So beheben Sie diesen Fehler:

  1. Wenn sich die Datei in einer geteilten Ablage befindet und Sie die Methode files.get verwenden, muss der Abfrageparameter supportsAllDrives auf true festgelegt sein.
  2. Teilen Sie dem Nutzer mit, dass er keinen Lesezugriff auf die Datei hat oder die Datei nicht existiert.
  3. 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 ist eine Darstellung dieses Fehlers:

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

Verwenden Sie den exponentiellen Backoff, um die Anfrage zu wiederholen und diesen Fehler zu beheben.

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

Diese Fehler treten auf, wenn bei der Verarbeitung der Anfrage ein unerwarteter Serverfehler auftritt. Diese Fehler können verschiedene Ursachen haben, z. B. dass sich der Zeitpunkt einer Anfrage mit dem einer anderen überschneidet oder dass eine Anfrage eine nicht unterstützte Aktion enthält, z. B. der Versuch, 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 den exponentiellen Backoff, um die Anfrage zu wiederholen und diesen Fehler zu beheben.