Ta strona została przetłumaczona przez Cloud Translation API.

Naprawianie błędów

Interfejs Google Drive API zwraca 2 poziomy informacji o błędach:

kody błędów HTTP i komunikaty w nagłówku.
Obiekt JSON w ciele odpowiedzi z dodatkowymi szczegółami, które mogą pomóc w określeniu sposobu postępowania z błędem.

Aplikacje Dysku Google powinny przechwytywać i obsługiwać wszystkie błędy, które mogą wystąpić podczas korzystania z interfejsu REST API. Ten przewodnik zawiera instrukcje na temat rozwiązywania poszczególnych błędów interfejsu Drive API.

Podsumowanie kodów stanu HTTP

Kod błędu	Opis
`200 - OK`	Żądanie zostało zrealizowane (to standardowa odpowiedź na pomyślne żądania HTTP).
`400 - Bad Request`	Nie możemy zrealizować prośby z powodu błędu klienta w prośbie.
`401 - Unauthorized`	Żądanie zawiera nieprawidłowe dane logowania.
`403 - Forbidden`	Żądanie zostało odebrane i zrozumiane, ale użytkownik nie ma uprawnień do jego wykonania.
`404 - Not Found`	Nie udało się znaleźć żądanej strony.
`429 - Too Many Requests`	Zbyt wiele żądań do interfejsu API.
`500, 502, 503, 504 - Server Errors`	Podczas przetwarzania żądania wystąpił nieoczekiwany błąd.

Błędy 400

Te błędy oznaczają, że żądanie było nieprawidłowe, często z powodu braku wymaganego parametru.

`badRequest`

Ten błąd może wystąpić z dowolnego z następujących problemów w kodzie:

Nie podano wymaganego pola lub parametru.
Podana wartość lub kombinacja podanych pól jest nieprawidłowa.
Próbujesz dodać do pliku na Dysku zduplikowany element nadrzędny.
Próbujesz dodać element nadrzędny, który utworzy cykl w grafu katalogu.

Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, sprawdź pole message i odpowiednio dostosuj kod.

`invalidSharingRequest`

Ten błąd występuje z kilku powodów. Aby określić przyczynę, sprawdź pole reason zwróconego obiektu JSON. Ten błąd występuje najczęściej z tych powodów:

Udostępnienie się udało, ale e-mail z powiadomieniem nie został dostarczony prawidłowo.
Ten użytkownik nie może zmienić listy kontroli dostępu (ACL).

Pole message wskazuje rzeczywisty błąd.

Udostępniono, ale e-mail z powiadomieniem nie został prawidłowo dostarczony

Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, poinformuj użytkownika (osobę udostępniającą), że nie udało się udostępnić, ponieważ nie można było wysłać e-maila z powiadomieniem na adres e-mail odbiorcy. Użytkownik powinien upewnić się, że ma właściwy adres e-mail i może odbierać e-maile.

Zmiana listy ACL nie jest dozwolona dla tego użytkownika

Ten przykładowy plik JSON reprezentuje ten błąd:

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

Aby naprawić ten błąd, sprawdź ustawienia udostępniania w domenie Google Workspace, do której należy plik. Ustawienia mogą uniemożliwiać udostępnianie poza domeną lub udostępnianie dysku współdzielonego może być zabronione.

Błędy 401

Te błędy oznaczają, że żądanie nie zawiera prawidłowego tokena dostępu.

`authError`

Ten błąd występuje, gdy token dostępu, którego używasz, wygasł lub jest nieprawidłowy. Ten błąd może być też spowodowany brakiem autoryzacji dla żądanych zakresów. Ten przykładowy plik JSON reprezentuje ten błąd:

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

Aby naprawić ten błąd, odśwież token dostępu za pomocą długotrwałego tokena odświeżania. Jeśli to nie zadziała, poprowadź użytkownika przez proces OAuth, jak opisano w sekcji Wybieranie zakresów interfejsu Google Drive API.

`fileNotDownloadable`

Ten błąd występuje, gdy próbujesz użyć metody revisions.get z parametrem adresu URL alt=media w dokumencie Google Workspace. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, spróbuj wykonać jedną z tych czynności:

Jeśli chcesz wyświetlić metadane konkretnej wersji, np. typ pliku, usuń parametr URL alt=media.
Aby wyeksportować zawartość bajtów dokumentu Google Workspace, użyj metody files.export. Więcej informacji znajdziesz w artykule Eksportowanie treści dokumentu Google Workspace.

Błędy 403

Te błędy oznaczają, że został przekroczony limit użycia lub użytkownik nie ma odpowiednich uprawnień. Aby określić przyczynę, sprawdź pole reason zwróconego obiektu JSON.

Informacje o limitach interfejsu Drive API znajdziesz w artykule Limity wykorzystania. Informacje o limitach dotyczących folderów Dysku znajdziesz w artykule Limity dotyczące plików i folderów.

`activeItemCreationLimitExceeded`

Po przekroczeniu limitu liczby elementów utworzonych na koncie występuje błąd activeItemCreationLimitExceeded. Każdy użytkownik może mieć na koncie maksymalnie 500 milionów elementów. Więcej informacji znajdziesz w sekcji Limit elementów użytkownika.

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

Aby naprawić ten błąd:

Poinformuj użytkownika, że Dysk nie pozwala tworzyć kont z ponad 500 milionami elementów.
Jeśli użytkownik musi utworzyć elementy na tym samym koncie, poproś go o trwałe usunięcie niektórych obiektów. W przeciwnym razie mogą użyć innego konta, które już spełnia te wymagania.

`appNotAuthorizedToFile`

Ten błąd występuje, gdy aplikacja nie jest wymieniona w liście ACL pliku. Ten błąd uniemożliwia użytkownikowi otwarcie pliku w aplikacji. Poniżej znajduje się przykładowy plik JSON przedstawiający ten błąd:

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

Aby naprawić ten błąd, wykonaj jedną z tych czynności:

Otwórz selektor Dysku Google i poproś użytkownika o otwarcie pliku.
Poproś użytkownika, aby otworzył plik za pomocą menu kontekstowego Otwórz za pomocą w interfejsie aplikacji na Dysku.
Użyj metody files.get, aby sprawdzić pole isAppAuthorized w zasobie files, aby potwierdzić, że Twoja aplikacja utworzyła lub otworzyła plik.

`cannotModifyInheritedTeamDrivePermission`

Ten błąd występuje, gdy użytkownik próbuje zmienić dziedziczone uprawnienia elementu na dysku współdzielonym. Odziedziczonych uprawnień nie można usunąć z elementu na dysku współdzielonym. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, użytkownik musi dostosować uprawnienia bezpośredniego lub pośredniego nadrzędnego elementu, z którego zostały odziedziczone. Więcej informacji znajdziesz w artykule na temat rozpowszechniania uprawnień. Możesz też pobrać zasób permissions.permissionDetails, aby sprawdzić, czy uprawnienia tego elementu dysku współdzielonego zostały odziedziczone czy zastosowane bezpośrednio.

`dailyLimitExceeded`

Ten błąd występuje, gdy w projekcie został osiągnięty limit interfejsu API. Ten przykładowy kod JSON przedstawia ten błąd:

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

Ten błąd pojawia się, gdy właściciel aplikacji ustawił limit kwoty, aby ograniczyć wykorzystanie określonego zasobu. Aby naprawić ten błąd, usuń wszystkie limity wykorzystania dotyczące limitu „Zapytań dziennie”.

`domainPolicy`

Ten błąd występuje, gdy zasady dotyczące domeny użytkownika nie zezwalają na dostęp do Dysku przez Twoją aplikację. Poniżej znajduje się przykładowy kod JSON przedstawiający ten błąd:

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

Aby naprawić ten błąd:

Poinformuj użytkownika, że domena nie zezwala aplikacji na dostęp do plików na Dysku.
Poproś użytkownika, aby skontaktował się z administratorem domeny i poprosił o dostęp do aplikacji.

`fileOwnerNotMemberOfTeamDrive`

Ten błąd występuje, gdy próbujesz przenieść plik na dysk współdzielony, a właściciel pliku nie jest użytkownikiem. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd:

Dodaj użytkownika do dysku współdzielonego za pomocą role=owner. Więcej informacji znajdziesz w artykule Udostępnianie plików, folderów i dysków.
Dodaj plik do dysku współdzielonego. Więcej informacji znajdziesz w artykule Tworzenie i wypełnianie folderów.

`fileWriterTeamDriveMoveInDisabled`

Ten błąd występuje, gdy administrator domeny nie zezwala użytkownikom z rolą role=writer na przenoszenie elementów na dysk współdzielony. Użytkownik próbujący przenieść elementy ma mniej uprawnień niż dozwolone na docelowym dysku współdzielonym. Oto przykładowy plik JSON reprezentujący ten błąd:

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

Aby naprawić ten błąd, użyj tego samego konta administratora na dysku współdzielonym źródłowym i docelowym.

`insufficientFilePermissions`

Ten błąd występuje, gdy użytkownik nie ma uprawnień do zapisu pliku, a aplikacja próbuje go zmodyfikować. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby rozwiązać ten problem, poproś użytkownika o skontaktowanie się z właścicielem pliku i poproszenie o dostęp do edycji. Poziomy dostępu użytkowników możesz też sprawdzić w metadanych pobranych przez metodę files.get i wyświetlić interfejs tylko do odczytu, gdy brakuje uprawnień.

`myDriveHierarchyDepthLimitExceeded`

Błąd myDriveHierarchyDepthLimitExceeded występuje po przekroczeniu limitu liczby poziomów zagnieżdżonych folderów. Mój Dysk użytkownika nie może zawierać więcej niż 100 poziomów zagnieżdżonych folderów. Więcej informacji znajdziesz w sekcji Limit głębokości folderów.

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

Aby naprawić ten błąd:

Poinformuj użytkownika, że Dysk nie pozwala umieszczać folderów na więcej niż 100 poziomach zagnieżdżenia.
Jeśli użytkownik musi utworzyć kolejny folder zagnieżdżony, poproś go o przeorganizowanie docelowego folderu nadrzędnego tak, aby miał mniej niż 100 poziomów, lub użyj innego folderu nadrzędnego, który już spełnia to wymaganie.

`numChildrenInNonRootLimitExceeded`

Ten błąd występuje, gdy przekroczono limit liczby elementów podrzędnych folderu (folderów, plików i skrótów). W folderze może znajdować się maksymalnie 500 tysięcy folderów, plików i skrótów. Elementy umieszczone w podfolderach nie wliczają się do limitu 500 000 elementów. Więcej informacji o limitach dotyczących folderów na Dysku znajdziesz w artykule Ograniczenia dotyczące folderów na Dysku Google.

Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, spróbuj wykonać jedną z tych czynności:

Poinformuj użytkownika,że Dysk nie pozwala na tworzenie folderów z ponad 500 tys. elementów.
Jeśli użytkownik musi dodać więcej elementów do pełnego folderu, poproś go o zreorganizowanie folderu tak, aby zawierał mniej niż 500 tys. elementów, lub o użycie podobnego folderu, który zawiera już mniej elementów.

`rateLimitExceeded`

Ten błąd występuje, gdy osiągnięto limit szybkości projektu. Limit zależy od typu żądania. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, wykonaj jedną z tych czynności:

Zwiększ limit na użytkownika w projekcie Google Cloud. Aby dowiedzieć się więcej, poproś o zwiększenie limitu.
Zbiorcze żądania umożliwiają łączenie wielu wywołań interfejsu API w jedno żądanie HTTP.
Aby ponownie wysłać żądanie, użyj wzrastającego czasu do ponowienia.

`sharingRateLimitExceeded`

Ten błąd występuje, gdy użytkownik osiągnie limit udostępniania i często jest powiązany z limitem adresów e-mail. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd:

Nie wysyłaj e-maili, gdy udostępniasz dużą liczbę plików.
Jeśli jeden użytkownik wysyła wiele żądań w imieniu wielu użytkowników konta Google Workspace, rozważ użycie konta usługi z delegacją na całą domenę za pomocą parametru quotaUser.

`storageQuotaExceeded`

Ten błąd występuje, gdy użytkownik osiągnie limit miejsca na dane. Poniższa próbka JSON obrazuje ten błąd:

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

Aby naprawić ten błąd:

Sprawdź limity miejsca na koncie Dysku. Więcej informacji znajdziesz w artykule Limity miejsca na dane i przesyłania w Google Workspace.
zarządzać plikami na Dysku Google,
Kup więcej miejsca na dane w Google

`teamDriveFileLimitExceeded`

Ten błąd występuje, gdy użytkownik próbuje przekroczyć ścisły limit elementów na dysku współdzielonym. Każdy folder na dysku współdzielonym użytkownika może zawierać maksymalnie 500 tysięcy elementów, w tym plików, folderów i skrótów. Ten limit zależy od liczby elementów, a nie od wykorzystania miejsca na dane. Więcej informacji znajdziesz w artykule Ograniczenia związane z dyskami współdzielonymi na Dysku Google.

Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, zmniejsz liczbę elementów na dysku współdzielonym. Dyski współdzielone, na których jest za dużo plików, mogą powodować problemy z porządkowaniem i znajdowaniem treści.

`teamDriveHierarchyTooDeep`

Błąd teamDriveHierarchyTooDeep występuje, gdy przekroczony zostanie limit liczby poziomów folderów zagnieżdżonych na dysku współdzielonym. Dysk współdzielony użytkownika nie może zawierać więcej niż 100 poziomów zagnieżdżonych folderów. Więcej informacji znajdziesz w artykule Limit głębokości folderów.

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

Aby naprawić ten błąd:

Poinformuj użytkownika, że dyski współdzielone nie pozwalają na umieszczanie folderów na więcej niż 100 poziomach zagnieżdżenia.
Jeśli użytkownik musi utworzyć kolejny folder zagnieżdżony, poproś go o przeorganizowanie docelowego folderu nadrzędnego tak, aby miał mniej niż 100 poziomów, lub użyj innego folderu nadrzędnego, który już spełnia to wymaganie.

`teamDriveMembershipRequired`

Ten błąd występuje, gdy użytkownik próbuje uzyskać dostęp do dysku współdzielonego, do którego nie należy. Ten przykładowy plik JSON reprezentuje ten błąd:

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

Aby naprawić ten błąd, wykonaj jedną z tych czynności:

Poproś menedżera dysku współdzielonego o dodanie Cię z odpowiednimi uprawnieniami do wykonania danej czynności.
Aby dowiedzieć się, kto może uzyskać dostęp do dysków współdzielonych i nimi zarządzać, zapoznaj się z rolami i uprawnieniami na Dysku. Dodatkowe informacje o poziomach dostępu znajdziesz w artykule Tworzenie dysku współdzielonego.

`teamDrivesFolderMoveInNotSupported`

Ten błąd występuje, gdy użytkownik próbuje przenieść folder z Mojego dysku na dysk współdzielony. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, spróbuj wykonać jedną z tych czynności:

Przenieś poszczególne elementy z folderu na dysk współdzielony za pomocą interfejsu Drive API. Ustaw parametr supportsAllDrives=true, aby wskazać obsługę zarówno Mojego dysku, jak i dysków współdzielonych.
Jeśli musisz przenieść folder na dysk współdzielony, użyj interfejsu Dysku. Więcej informacji znajdziesz w artykule Przenoszenie folderów na dyski współdzielone jako administrator.

`teamDrivesParentLimit`

Ten błąd występuje, gdy użytkownik próbuje dodać więcej niż jednego rodzica do elementu na dysku współdzielonym. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, dodaj wiele linków do pliku za pomocą skrótów na Dysku. Skrót może mieć tylko jeden element nadrzędny, ale plik skrótu można skopiować do dodatkowych lokalizacji. Więcej informacji znajdziesz w artykule Tworzenie skrótu do pliku na Dysku.

`UrlLeaseLimitExceeded`

Ten błąd występuje, gdy próbujesz zapisać dane gry z Google Play w aplikacji. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, przed utworzeniem kolejnych zrzutów dysku dokończ lub anuluj przesyłanie zrzutu dysku.

`userRateLimitExceeded`

Ten błąd występuje, gdy osiągnięto limit na użytkownika. Może to być limit z konsoli Google Cloud lub z backendu Dysku. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, spróbuj wykonać jedną z tych czynności:

Zwiększ limit na użytkownika w projekcie Google Cloud. Aby dowiedzieć się więcej, poproś o zwiększenie limitu.
Jeśli jeden użytkownik wysyła wiele żądań w imieniu wielu użytkowników konta Google Workspace, rozważ użycie konta usługi z delegacją na całą domenę za pomocą parametru quotaUser.
Aby ponownie wysłać żądanie, użyj wzrastającego czasu do ponowienia.

Informacje o limitach interfejsu Drive API znajdziesz w artykule Limity wykorzystania.

Błędy 404

Te błędy oznaczają, że żądany zasób jest niedostępny lub nie istnieje.

`notFound`

Ten błąd występuje, gdy użytkownik nie ma uprawnień do odczytu pliku lub plik nie istnieje. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd:

Jeśli plik znajduje się na dysku współdzielonym, a Ty używasz metody files.get, sprawdź, czy parametr zapytania supportsAllDrives ma wartość true.
Poinformuj użytkownika, że nie ma on uprawnień do odczytu pliku lub że plik nie istnieje.
Poproś użytkownika, aby skontaktował się z właścicielem pliku i poprosił o dostęp do pliku.

Błędy 429

Te błędy oznaczają, że zbyt wiele żądań zostało zbyt szybko wysłanych do interfejsu API.

`rateLimitExceeded`

Ten błąd występuje, gdy użytkownik wysłał zbyt wiele żądań w danym przedziale czasu. Ten przykładowy kod JSON przedstawia ten błąd:

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

Aby naprawić ten błąd, użyj wykładniczego ponowienia w celu ponowienia próby wysłania żądania.

Błędy 500, 502, 503 i 504

Te błędy występują, gdy podczas przetwarzania żądania wystąpi nieoczekiwany błąd serwera. Błędy te mogą powodować różne problemy, na przykład pokrywanie się czasu żądania z innym żądaniem lub żądanie nieobsługiwanego działania. Na przykład może to być próba aktualizacji uprawnień do jednej strony w Witrynach Google zamiast do całej witryny.

Oto lista błędów 5xx:

500 Błąd backendu
502 Nieprawidłowa brama
503 Usługa niedostępna
504 Przekroczenie limitu czasu bramy

Aby naprawić ten błąd, użyj sprawdzania z wykładniczym zmniejszaniem częstotliwości, aby ponownie przesłać żądanie.

Naprawianie błędów

Podsumowanie kodów stanu HTTP

Błędy 400

badRequest

invalidSharingRequest

Udostępniono, ale e-mail z powiadomieniem nie został prawidłowo dostarczony

Zmiana listy ACL nie jest dozwolona dla tego użytkownika

Błędy 401

authError

fileNotDownloadable

Błędy 403

activeItemCreationLimitExceeded

appNotAuthorizedToFile

cannotModifyInheritedTeamDrivePermission

dailyLimitExceeded

domainPolicy

fileOwnerNotMemberOfTeamDrive

fileWriterTeamDriveMoveInDisabled

insufficientFilePermissions

myDriveHierarchyDepthLimitExceeded

numChildrenInNonRootLimitExceeded

rateLimitExceeded

sharingRateLimitExceeded

storageQuotaExceeded

teamDriveFileLimitExceeded

teamDriveHierarchyTooDeep

teamDriveMembershipRequired

teamDrivesFolderMoveInNotSupported

teamDrivesParentLimit

UrlLeaseLimitExceeded

userRateLimitExceeded

Błędy 404

notFound

Błędy 429

rateLimitExceeded

Błędy 500, 502, 503 i 504

Powiązane artykuły

`badRequest`

`invalidSharingRequest`

`authError`

`fileNotDownloadable`

`activeItemCreationLimitExceeded`

`appNotAuthorizedToFile`

`cannotModifyInheritedTeamDrivePermission`

`dailyLimitExceeded`

`domainPolicy`

`fileOwnerNotMemberOfTeamDrive`

`fileWriterTeamDriveMoveInDisabled`

`insufficientFilePermissions`

`myDriveHierarchyDepthLimitExceeded`

`numChildrenInNonRootLimitExceeded`

`rateLimitExceeded`

`sharingRateLimitExceeded`

`storageQuotaExceeded`

`teamDriveFileLimitExceeded`

`teamDriveHierarchyTooDeep`

`teamDriveMembershipRequired`

`teamDrivesFolderMoveInNotSupported`

`teamDrivesParentLimit`

`UrlLeaseLimitExceeded`

`userRateLimitExceeded`

`notFound`

`rateLimitExceeded`