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 helfen können, wie mit dem Fehler umgegangen werden soll.

Google Drive-Apps sollten alle auftretenden Fehler erkennen und verarbeiten können. wenn Sie die REST API verwenden. Dieser Leitfaden enthält eine Anleitung zur Behebung bestimmte Drive API-Fehler.

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 einer fehlenden erforderlicher Parameter.

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.

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 die reason des zurückgegebenen JSON-Objekts. 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 email@domain.com.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

Um diesen Fehler zu beheben, teilen Sie dem Nutzer (Freigebenden) mit, dass die Freigabe nicht möglich war, weil Die Benachrichtigungs-E-Mail konnte nicht an die Ziel-E-Mail-Adresse gesendet werden. Die sollten Sie sicherstellen, dass sie die richtige E-Mail-Adresse haben und E-Mails empfangen.

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

Klicken Sie das Kästchen neben Freigabeberechtigungen an, um diesen Fehler zu beheben Einstellungen der Google Workspace-Domain, zu der die Datei gehört. Die Einstellungen können ist die Freigabe außerhalb der Domain oder die Freigabe einer geteilten Ablage nicht zulässig. nicht erlaubt sind.

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 ist oder ungültig. Dieser Fehler kann auch durch fehlende Autorisierung für den die angeforderten Bereiche. 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.

403-Fehler

Diese Fehler bedeuten, dass ein Nutzungslimit überschritten wurde oder der Nutzer die richtigen Berechtigungen haben. Um die Ursache zu ermitteln, werten Sie das Feld reason von den zurückgegebenen JSON-Code.

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

activeItemCreationLimitExceeded

Der Fehler activeItemCreationLimitExceeded tritt auf, wenn die maximale Anzahl der pro Konto erstellten Artikel wurde überschritten. Jeder Nutzer kann bis zu 500 über ein Konto erstellt. Weitere Informationen finden Sie unter User-item Limit fest.

{
 "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 Konten erstellt werden können über 500 Millionen Elemente.

  2. Wenn der Nutzer Elemente in diesem Konto erstellen muss, weise ihn an, Objekte endgültig löschen. Andernfalls können sie ein anderes Konto verwenden. die die Anforderung bereits erfüllt.

appNotAuthorizedToFile

Dieser Fehler tritt auf, wenn Ihre Anwendung nicht in der ACL der Datei enthalten ist. Dieser Fehler verhindert, dass der Nutzer die Datei mit Ihrer App öffnet. Im folgenden JSON-Beispiel ist eine Darstellung dieses Fehlers:

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

  • Google Drive-Auswahl öffnen und fordern den Nutzer auf, die Datei zu öffnen.
  • Bitten Sie den Nutzer, die Datei über das Kontextmenü Öffnen mit in Google Drive zu öffnen. UI Ihrer App.
  • Verwenden Sie die Methode files.get, um prüfen Sie das Feld isAppAuthorized auf der files, um zu prüfen, ob Ihr die App die Datei erstellt oder geöffnet hat.

cannotModifyInheritedTeamDrivePermission

Dieser Fehler tritt auf, wenn ein Nutzer versucht, die übernommenen Berechtigungen eines Element innerhalb einer geteilten Ablage. Übernommene Berechtigungen können für ein Element nicht entfernt werden in einer geteilten Ablage. 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, müssen Nutzer die Berechtigungen für den direkten oder indirekten Zugriff übergeordnetes Element, von dem sie übernommen wurden. Weitere Informationen finden Sie unter Berechtigung Verbreitung von Malware. Sie können rufen Sie auch permissions.permissionDetails Ressource, um zu sehen, ob die Berechtigungen für dieses Element in der geteilten Ablage übernommen werden oder direkt angewendet werden.

dailyLimitExceeded

Dieser Fehler tritt auf, wenn das API-Limit für Ihr Projekt erreicht wurde. Die folgenden Das JSON-Beispiel stellt diesen Fehler dar:

{
  "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, Nutzung einer bestimmten Ressource. Um diesen Fehler zu beheben, entfernen Sie alle Nutzungsbeschränkungen für die "Abfragen pro Tag" Kontingent.

domainPolicy

Dieser Fehler tritt auf, wenn die Richtlinie für die Domain des Nutzers den Zugriff auf folgende Elemente nicht zulässt: Ihre App als Grundlage verwenden. Das folgende JSON-Beispiel stellt 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 die Domain Ihrer App keinen Zugriff auf Dateien in Drive
  2. Bitten Sie den Nutzer, sich an den Domainadministrator zu wenden, um Zugriff für für Ihre App.

fileOwnerNotMemberOfTeamDrive

Dieser Fehler tritt auf, wenn Sie versuchen, eine Datei in eine geteilte Ablage zu verschieben Dateieigentümer ist kein Mitglied. Das folgende JSON-Beispiel stellt eine 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 der geteilten Ablage mit role=owner hinzu. Weitere Informationen Weitere Informationen finden Sie im Hilfeartikel Dateien, Ordner und Ablagen freigeben.

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

fileWriterTeamDriveMoveInDisabled

Dieser Fehler tritt auf, wenn ein Domainadministrator Nutzer mit role=writer, um Elemente in eine geteilte Ablage zu verschieben. Der Nutzer, der versucht, Elemente haben weniger Berechtigungen als für die geteilte Zielablage zulässig. Die 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 Quelle dasselbe Administratornutzerkonto, um diesen Fehler zu beheben. und geteilte Zielablagen.

insufficientFilePermissions

Dieser Fehler tritt auf, wenn der Nutzer keinen Schreibzugriff auf eine Datei hat und Ihr App versucht, die Datei zu modifizieren. Das folgende JSON-Beispiel ist ein 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}."
  }
}

Um diesen Fehler zu beheben, bitten Sie den Nutzer, sich an den Eigentümer der Datei zu wenden Bearbeitungszugriff. Sie können die Zugriffsebenen der Nutzer auch in den abgerufenen Metadaten prüfen: Methode files.get und rufen Sie ein wenn Berechtigungen fehlen.

myDriveHierarchyDepthLimitExceeded

Der Fehler myDriveHierarchyDepthLimitExceeded tritt auf, wenn das Limit für die Anzahl der Ebenen verschachtelter Ordner wurde überschritten. Der Name des Nutzers Drive darf nicht mehr als 100 Ebenen verschachtelter Ordner enthalten. Für Weitere Informationen finden Sie unter Ordnertiefe Limit fest.

{
 "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 nicht mehr erlaubt als bis zu 100 Level.
  2. Wenn der Nutzer einen weiteren verschachtelten Ordner erstellen muss, weisen Sie ihn an, den Ordner neu zu organisieren sollte der übergeordnete Ordner weniger als 100 Ebenen haben, oder verwenden Sie übergeordneten Ordner erstellt wird, der die Anforderung bereits erfüllt.

numChildrenInNonRootLimitExceeded

Dieser Fehler tritt auf, wenn das Limit für die Anzahl der untergeordneten Ordner, Dateien und Verknüpfungen) überschritten wurden. Es gilt ein Limit von 500.000 Elementen für Ordner, Dateien und Verknüpfungen direkt in einem Ordner. In Unterordnern verschachtelte Elemente nicht auf das Limit von 500.000 Artikeln 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:

  • Informieren Sie den Nutzer, dass in Drive Ordner mit mehr als 500.000 Elemente.
  • Wenn der Nutzer dem gesamten Ordner weitere Elemente hinzufügen muss, bitte ihn, Folgendes zu tun: den Ordner neu organisieren, sodass er weniger als 500.000 Elemente enthält, oder einen ähnlichen Ordner, 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 ist ein Darstellung dieses Fehlers:

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

sharingRateLimitExceeded

Dieser Fehler tritt auf, wenn der Nutzer eine Freigabebeschränkung erreicht hat und häufig verknüpft wird, mit einem E-Mail-Limit. Das folgende JSON-Beispiel stellt eine 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. Bei der Freigabe großer Mengen von Dateien keine E-Mails senden.
  2. Wenn ein Nutzer mehrere Anfragen im Namen vieler Nutzer eines Google Workspace-Konto – ein Dienstkonto mit domainweitem Zugriff Delegierung mit quotaUser -Parameter.

storageQuotaExceeded

Dieser Fehler tritt auf, wenn der Nutzer sein Speicherlimit erreicht hat. Die folgenden Das JSON-Beispiel stellt diesen Fehler dar:

{
 "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 Weitere Informationen zum Google Workspace-Speicherplatz .

  2. Dateien in Google Drive verwalten Speicherplatz.

  3. Mehr Google kaufen Speicherplatz.

teamDriveFileLimitExceeded

Dieser Fehler tritt auf, wenn ein Nutzer versucht, die strenge Artikelbeschränkung für eine geteilte Ablage. Jeder Ordner in der geteilten Ablage eines Nutzers ist auf 500.000 Elemente beschränkt. einschließlich Dateien, Ordnern und Verknüpfungen. Diese Beschränkung basiert auf der Anzahl der Elemente, nicht auf 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 den Fehler zu beheben. Geteilte Ablagen mit zu vielen Dateien zu organisieren und zu durchsuchen.

teamDriveHierarchyTooDeep

Der Fehler teamDriveHierarchyTooDeep tritt auf, wenn das Limit für die Anzahl der Die Ebenen für verschachtelte Ordner der geteilten Ablage wurden überschritten. Die geteilte Ablage eines Nutzers kann 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 darüber, dass in geteilten Ablagen keine Ordner mehr als bis zu 100 Level.
  2. Wenn der Nutzer einen weiteren verschachtelten Ordner erstellen muss, weisen Sie ihn an, den Ordner neu zu organisieren sollte der übergeordnete Ordner weniger als 100 Ebenen haben, oder verwenden Sie übergeordneten Ordner erstellt wird, der die Anforderung bereits erfüllt.

teamDriveMembershipRequired

Dieser Fehler tritt auf, wenn ein Nutzer versucht, auf eine geteilte Ablage zuzugreifen, in der er sich befindet. 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 zusammen mit den entsprechenden Berechtigungen für die auszuführende Aktion.

  2. Überprüfen Sie die Rollen und Berechtigungen, um zu erfahren, wer auf die Elemente zugreifen und diese verwalten kann geteilten Ablagen. Weitere Informationen zu Zugriffsebenen unter Erstellen eines freigegebenen Google Drive.

teamDrivesFolderMoveInNotSupported

Dieser Fehler tritt auf, wenn ein Nutzer versucht, einen Ordner aus „Meine“ Drive in eine geteilte Ablage. Das folgende JSON-Beispiel ist ein 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."
  }
}

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

  • Verschieben Sie die einzelnen Elemente aus dem Ordner in eine geteilte Ablage mithilfe der Drive API Legen Sie den Parameter supportsAllDrives=true fest, um das Ereignis „Meine Ablage“ und geteilte Ablagen unterstützt.

  • Wenn Sie den Ordner in eine geteilte Ablage verschieben müssen, verwenden Sie die Benutzeroberfläche von Google Drive Weitere Informationen finden Sie unter Ordner in freigegebene Ordner verschieben Google Drive als Administrator.

teamDrivesParentLimit

Dieser Fehler tritt auf, wenn ein Nutzer versucht, einem Element in in einer geteilten Ablage. 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."
  }
}

Um diesen Fehler zu beheben, können Sie mithilfe von Google Drive-Verknüpfungen mehrere Links zu einem -Datei. Eine Verknüpfung kann zwar nur ein übergeordnetes Element haben, eine Verknüpfungsdatei kann jedoch in die zusätzlichen Speicherorte kopiert. Weitere Informationen finden Sie unter Erstellen eines Verknüpfung zu einer Drive-Datei.

UrlLeaseLimitExceeded

Dieser Fehler tritt auf, wenn Sie versuchen, Google Play-Spieldaten über Ihr . 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 einen Snapshot erstellen mehr.

userRateLimitExceeded

Dieser Fehler tritt auf, wenn das Limit pro Nutzer erreicht wurde. Dies könnte ein aus der Google Cloud Console oder ein Limit aus Drive Back-End. 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:

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 existiert nicht. 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 das files.get-Methode verwenden, achten Sie darauf, dass der Der Abfrageparameter supportsAllDrives ist auf true festgelegt.
  2. Informieren Sie den Nutzer, dass er keinen Lesezugriff auf die Datei oder die Datei hat. existiert nicht.
  3. Bitten Sie den Nutzer, sich an den Eigentümer der Datei zu wenden und die Berechtigung für den -Datei.

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 für einen bestimmten Zeitraum. 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
  }
}

Um diesen Fehler zu beheben, verwenden Sie exponentiell Backoff, um die Anfrage zu wiederholen.

Fehler 500, 502, 503 und 504

Diese Fehler treten auf, wenn bei der Verarbeitung der Verschiedene Probleme können zu diesen Fehlern führen, einschließlich der zeitlichen Abfolge einer Anfrage die sich mit einer anderen Anfrage überschneiden, oder einer Anfrage für eine nicht unterstützte Aktion wie die Berechtigungen für eine einzelne Seite in Google Sites zu aktualisieren, für die gesamte Website.

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

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

Um diesen Fehler zu beheben, verwenden Sie exponentiell Backoff, um die Anfrage zu wiederholen.