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, die Ihnen bei der Behebung des Fehlers helfen können.

Google Drive-Anwendungen sollten alle Fehler abfangen und verarbeiten, die bei der Verwendung der REST API auftreten können. In diesem Leitfaden erfahren Sie, wie Sie bestimmte Fehler 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 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	Bei der Verarbeitung 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 Pflichtfeld oder ein erforderlicher Parameter wurde nicht angegeben.
• Der angegebene Wert oder eine Kombination aus angegebenen Feldern ist ungültig.
• Sie haben versucht, einer Drive-Datei ein übergeordnetes Element doppelt hinzuzufügen.
• Sie haben versucht, ein übergeordnetes Element hinzuzufügen, das einen Zyklus im Verzeichnisdiagramm erstellen würde.

Hinweis :Diese Liste ist nicht vollständig. Andere Fälle können einen 400-Fehler verursachen.

Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

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

Überprüfen Sie das Feld message und passen Sie den Code entsprechend an, um diesen Fehler zu beheben.

invalidSharingRequest

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

• Freigabe 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.

Freigabe erfolgreich, aber die Benachrichtigungs-E-Mail wurde nicht richtig 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 [e-mail].\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

Um diesen Fehler zu beheben, teilen Sie dem Nutzer (Freigebenden) mit, dass die Freigabe nicht möglich war, da die Benachrichtigungs-E-Mail nicht an die Ziel-E-Mail-Adresse gesendet werden konnte. Der Nutzer muss dafür sorgen, dass er die richtige E-Mail-Adresse hat und E-Mails empfangen kann.

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

Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

{
  "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 von Ihnen verwendete Zugriffstoken abgelaufen oder ungültig ist. Dieser Fehler kann auch durch fehlende Autorisierung für die angeforderten Bereiche verursacht werden. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

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

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

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 des zurückgegebenen JSON aus.

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

activeItemCreationLimitExceeded

Der Fehler activeItemCreationLimitExceeded tritt auf, wenn die Anzahl der pro Konto erstellten Elemente ü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 in Drive keine mehr als 500 Millionen Elemente erstellt werden können.

2. Wenn der Nutzer Elemente in diesem Konto 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 der 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}."
  }
}

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

• Öffnen Sie die Google Drive-Auswahl und fordern Sie den Nutzer auf, die Datei zu öffnen.
• Bitten Sie den Nutzer, die Datei in der Drive-Benutzeroberfläche Ihrer App über das Kontextmenü Öffnen mit zu öffnen.
• Prüfen Sie mit der Methode files.get das Feld isAppAuthorized für die Ressource files, um zu prüfen, ob Ihre Anwendung 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 für ein 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 prüfen, 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. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

{
  "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. Entfernen Sie alle Nutzungsobergrenzen für das Kontingent "Abfragen pro Tag", um diesen Fehler zu beheben.

domainPolicy

Dieser Fehler tritt auf, wenn die Richtlinie für die Domain des Nutzers über Ihre Anwendung keinen Zugriff auf Google Drive zulässt. Das folgende JSON-Beispiel stellt diesen Fehler dar:

{
  "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 der Dateieigentümer kein Mitglied ist und versucht, eine Datei in eine geteilte Ablage zu verschieben. 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 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 die Elemente verschieben möchte, hat weniger Berechtigungen als für die geteilte Zielablage zulässig. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

{
  "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 für die geteilte Quell- und Zielablage dasselbe Administratornutzerkonto, um diesen Fehler zu beheben.

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 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 auch die Nutzerzugriffsebenen in den Metadaten prüfen, die mit der Methode files.get abgerufen wurden, und eine schreibgeschützte UI anzeigen, wenn Berechtigungen fehlen.

myDriveHierarchyDepthLimitExceeded

Der Fehler myDriveHierarchyDepthLimitExceeded 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 die Ordnertiefe.

{
 "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 Drive das Platzieren von Ordnern mit mehr als 100 Ebenen verhindert.
2. Wenn der Nutzer einen weiteren verschachtelten Ordner erstellen muss, weisen Sie ihn an, den vorgesehenen übergeordneten Ordner so neu anzuordnen, dass er weniger als 100 Ebenen hat, 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. Für Ordner, Dateien und Verknüpfungen direkt in einem Ordner gilt ein Limit von 500.000 Elementen. 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.

Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

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

• Teilen Sie dem Nutzer mit,dass in Drive keine Ordner mit mehr als 500.000 Elementen vorhanden sind.
• Wenn der Nutzer dem vollständigen 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 zu verwenden, der bereits weniger Elemente enthält.

rateLimitExceeded

Dieser Fehler tritt auf, wenn die Ratenbegrenzung 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"
 }
}

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

• Das Kontingent pro Nutzer im Google Cloud-Projekt erhöhen. Weitere Informationen erhalten Sie, wenn Sie eine Kontingenterhöhung anfordern.
• Batchanfragen, um weniger API-Aufrufe auszuführen.
• Verwenden Sie den exponentiellen Backoff, um die Anfrage zu wiederholen.

sharingRateLimitExceeded

Dieser Fehler tritt auf, wenn der Nutzer ein Freigabelimit erreicht und oft mit einem E-Mail-Limit verknüpft ist. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

{
 "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. Bei der Freigabe großer Mengen von Dateien keine E-Mails senden.
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. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

{
 "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 Speicherplatzbegrenzung Ihres Drive-Kontos. Weitere Informationen finden Sie unter Speicher- und Uploadlimits in Google Workspace.

2. Dateien im Google Drive-Speicherplatz verwalten

3. Mehr Google-Speicherplatz kaufen

teamDriveFileLimitExceeded

Dieser Fehler tritt auf, wenn ein Nutzer versucht, die strenge Elementbeschränkung für eine geteilte Ablage zu überschreiten. Für jeden Ordner in der geteilten Ablage eines Nutzers gilt ein Limit von 500.000 Elementen, einschließlich Dateien, Ordnern und Verknüpfungen. Dieses Limit basiert auf der Anzahl der Elemente, nicht auf der Speichernutzung. Weitere Informationen finden Sie unter 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 den Fehler zu beheben. Geteilte Ablagen mit zu vielen Dateien können schwierig zu organisieren und zu suchen sein.

teamDriveHierarchyTooDeep

Der Fehler teamDriveHierarchyTooDeep tritt auf, wenn das Limit für die Anzahl der Ebenen von verschachtelten Ordnern in geteilten Ablagen überschritten wurde. Die geteilte Ablage eines Nutzers darf nicht mehr als 100 Ebenen verschachtelter Ordner 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 platziert werden können.
2. Wenn der Nutzer einen weiteren verschachtelten Ordner erstellen muss, weisen Sie ihn an, den vorgesehenen übergeordneten Ordner so neu anzuordnen, dass er weniger als 100 Ebenen hat, 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. 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."
  }
}

Führen Sie einen der folgenden Schritte aus, um diesen 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. 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 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."
  }
}

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

• Verschieben Sie die einzelnen Elemente mit 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 ein übergeordnetes Element hinzuzufügen. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

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

Sie können diesen Fehler beheben, indem Sie einer Datei mithilfe von Drive-Verknüpfungen mehrere Links hinzufügen. Eine Verknüpfung kann zwar nur ein übergeordnetes Element haben, aber eine Verknüpfungsdatei kann in 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 App zu speichern. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

{
 "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 oder brechen Sie alle Uploads für einen Snapshot 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. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

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

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

Hinweis: Fordern Sie nur dann ein zusätzliches Kontingent an, wenn Ihre Anwendung das Limit der Drive API aus Kulanzgründen oder das Limit pro Nutzer überschreitet. Wenn Sie die Beschränkung pro Nutzer überschreiten, versuchen Sie, Ihren Anwendungscode mithilfe von Batchanfragen zu optimieren, um weniger API-Aufrufe auszuführen.

• 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.

• Verwenden Sie den exponentiellen Backoff, um die Anfrage zu wiederholen.

Informationen zu den Drive API-Limits finden Sie hier.

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 existiert. 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 zu viele Anfragen in einem bestimmten Zeitraum gesendet hat. Im folgenden JSON-Beispiel wird dieser Fehler dargestellt:

{
  "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 zu wiederholen.

Fehler 500, 502, 503 und 504

Diese Fehler treten auf, wenn bei der Verarbeitung der Anfrage ein unerwarteter Serverfehler auftritt. Verschiedene Probleme können zu diesen Fehlern führen, z. B. das Timing einer Anfrage überschneidet sich mit einer anderen Anfrage oder eine Anfrage für eine nicht unterstützte Aktion, z. B. der Versuch, die Berechtigungen für eine einzelne Seite in Google Sites statt 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 zu wiederholen.

Weitere Informationen

• Performance optimieren
• Fehlerbehebung bei Authentifizierungs- und Autorisierungsproblemen