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

Naprawianie błędów

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

z kodami błędów HTTP i komunikatami nagłówka.
Obiekt JSON w treści odpowiedzi z dodatkowymi informacjami, które pomagają określić sposób obsługi błędu.

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

Podsumowanie kodu stanu HTTP

Kod błędu	Opis
`200 - OK`	Żądanie zostało zrealizowane (to standardowa odpowiedź na udane żądania HTTP).
`400 - Bad Request`	Nie można zrealizować żądania z powodu błędu klienta w żądaniu.
`401 - Unauthorized`	Żądanie zawiera nieprawidłowe dane logowania.
`403 - Forbidden`	Żądanie zostało odebrane i zrozumiane, ale użytkownik nie ma uprawnień, aby je wykonać.
`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 pojawia się nieoczekiwany błąd.

Błędy 400

Błędy te oznaczają, że żądanie było niedopuszczalne, 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ć zduplikowany element nadrzędny do pliku na Dysku.
Próbujesz dodać element nadrzędny, który utworzyłby cykl na wykresie katalogowym.

Ten przykładowy plik JSON reprezentuje 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 kodu JSON. Ten błąd występuje najczęściej, ponieważ:

Udostępniono treść, ale e-mail z powiadomieniem nie został prawidłowo dostarczony.
Zmiana listy kontroli dostępu (ACL) nie jest dozwolona dla tego użytkownika.

Pole message wskazuje rzeczywisty błąd.

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

Ten przykładowy plik JSON reprezentuje 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 (udostępniającego), że nie udało się udostępnić pliku, ponieważ na docelowy adres e-mail nie można wysłać e-maila z powiadomieniem. Użytkownik powinien upewnić się, że ma właściwy adres e-mail i może otrzymywać e-maile.

Zmiana listy kontroli dostępu (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 plików poza domenę lub udostępnianie dysku współdzielonego może być niedozwolone.

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. Przyczyną tego błędu może być też brak 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. W takim przypadku przekieruj użytkownika przez proces OAuth zgodnie z opisem w artykule Wybieranie zakresów interfejsów API Dysku Google.

Błędy 403

Te błędy oznaczają, że został przekroczony limit wykorzystania lub użytkownik nie ma odpowiednich uprawnień. Aby ustalić przyczynę, sprawdź pole reason zwróconego kodu 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. Na jednym koncie użytkownika może tworzyć 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 na tworzenie ponad 500 milionów elementów na kontach.
Jeśli użytkownik musi utworzyć elementy na tym samym koncie, poinstruuj go, aby trwale usunął niektóre obiekty. W przeciwnym razie mogą użyć innego konta, które już spełnia te wymagania.

`appNotAuthorizedToFile`

Ten błąd występuje, gdy aplikacji nie ma na liście kontroli dostępu (ACL) dla danego pliku. Ten błąd uniemożliwia użytkownikowi otwarcie pliku w Twojej aplikacji. Ten przykładowy plik JSON obrazuje 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, korzystając z menu kontekstowego Otwórz w w interfejsie Dysku Twojej aplikacji.
Użyj metody files.get, aby sprawdzić pole isAppAuthorized w zasobie files i upewnić się, że aplikacja utworzyła lub otworzyła plik.

`cannotModifyInheritedTeamDrivePermission`

Ten błąd występuje, gdy użytkownik próbuje zmienić odziedziczone uprawnienia do elementu na dysku współdzielonym. Odziedziczonych uprawnień nie można usunąć z elementu na dysku współdzielonym. Ten przykładowy plik JSON reprezentuje 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 do bezpośredniego lub pośredniego elementu nadrzędnego, z którego został odziedziczony. Więcej informacji znajdziesz w artykule na temat rozpowszechniania uprawnień. Możesz też pobrać zasób permissions.permissionDetails, aby sprawdzić, czy uprawnienia do tego elementu na dysku współdzielonym są dziedziczone czy stosowane bezpośrednio.

`dailyLimitExceeded`

Ten błąd występuje, gdy w projekcie został osiągnięty limit interfejsu API. Poniższa próbka JSON obrazuje 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 wykorzystania określonego zasobu. Aby naprawić ten błąd, usuń wszystkie limity wykorzystania z limitu „Zapytań dziennie”.

`domainPolicy`

Ten błąd występuje, gdy zasada w domenie użytkownika nie zezwala Twojej aplikacji na dostęp do Dysku. Przykładowy plik JSON ilustruje 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 poproś o dostęp do Twojej aplikacji.

`fileOwnerNotMemberOfTeamDrive`

Ten błąd występuje, gdy próbujesz przenieść plik na dysk współdzielony, gdy właściciel pliku nie jest użytkownikiem. Ten przykładowy plik JSON reprezentuje 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 w usłudze 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 korzystającym z 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. Ten przykładowy plik JSON obrazuje 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 źródłowym i docelowym dysku współdzielonym.

`insufficientFilePermissions`

Ten błąd występuje, gdy użytkownik nie ma uprawnień do zapisu pliku, a aplikacja próbuje go zmodyfikować. Ten przykładowy plik JSON ilustruje 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 naprawić ten błąd, poproś użytkownika, aby skontaktował się z właścicielem pliku i poprosił o uprawnienia do edycji. Możesz też sprawdzić poziomy dostępu użytkowników w metadanych pobranych metodą files.get i wyświetlić interfejs tylko do odczytu w przypadku braku 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 zezwala na umieszczanie folderów na ponad 100 poziomach.
Jeśli użytkownik musi utworzyć kolejny zagnieżdżony folder, poproś go o uporządkowanie odpowiedniego folderu nadrzędnego tak, aby zawierał mniej niż 100 poziomów, lub użycie 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). Istnieje limit 500 000 elementów dla folderów, plików i skrótów bezpośrednio w folderze. Elementy zagnieżdżone w podfolderach nie wliczają się do limitu 500 000 elementów. Więcej informacji o limitach dotyczących folderów Dysku znajdziesz w artykule Limity dotyczące folderów na Dysku Google.

Ten przykładowy plik JSON reprezentuje 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, wykonaj jedną z tych czynności:

Poinformuj użytkownika,że Dysk nie zezwala na foldery zawierające ponad 500 tys. elementów.
Jeśli użytkownik musi dodać więcej elementów do pełnego folderu, poproś go o uporządkowanie folderu w taki sposób, aby zawierał mniej niż 500 000 elementów, lub użycie podobnego folderu, który ma już mniej elementów.

`rateLimitExceeded`

Ten błąd występuje po osiągnięciu limitu liczby żądań w projekcie. Limit zależy od typu żądania. Ten przykładowy plik JSON ilustruje 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 uzyskać więcej informacji, poproś o zwiększenie limitu.
Żądania wsadowe, aby zmniejszyć liczbę wywołań interfejsu API.
Użyj wykładniczego ponowienia, aby ponowić żądanie.

`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 plik JSON reprezentuje 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 w przypadku udostępniania dużych ilości plików.
Jeśli jeden użytkownik wysyła wiele żądań w imieniu wielu użytkowników konta Google Workspace, rozważ utworzenie konta usługi z przekazywaniem dostępu w całej domenie 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ądzaj plikami na Dysku Google
Kup więcej miejsca na dane w Google.

`teamDriveFileLimitExceeded`

Ten błąd występuje, gdy użytkownik próbuje przekroczyć rygorystyczny limit elementów na dysku współdzielonym. Każdy folder na dysku współdzielonym użytkownika może zawierać maksymalnie 500 tys. 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 Limity związane z dyskami współdzielonymi na Dysku Google.

Ten przykładowy plik JSON reprezentuje 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 ze zbyt dużą liczbą plików mogą być trudne do porządkowania i wyszukiwania.

`teamDriveHierarchyTooDeep`

Błąd teamDriveHierarchyTooDeep występuje, gdy przekroczono limit liczby poziomów zagnieżdżonych folderów na dyskach współdzielonych. Dysk współdzielony użytkownika nie może zawierać ponad 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 ponad 100 poziomach.
Jeśli użytkownik musi utworzyć kolejny zagnieżdżony folder, poproś go o uporządkowanie odpowiedniego folderu nadrzędnego tak, aby zawierał mniej niż 100 poziomów, lub użycie 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 uprawnieniami odpowiednimi do czynności, którą musisz wykonać.
Zapoznaj się z rolami i uprawnieniami Dysku, aby dowiedzieć się, kto może uzyskiwać dostęp do dysków współdzielonych i nimi zarządzać. Dodatkowe informacje o poziomach dostępu znajdziesz też 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 plik JSON ilustruje 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, wykonaj 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ć, że obsługujemy zarówno Mój dysk, jak i dyski współdzielone.
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 przez administratora.

`teamDrivesParentLimit`

Ten błąd występuje, gdy użytkownik próbuje dodać do elementu na dysku współdzielonym więcej niż 1 element nadrzędny. Ten przykładowy plik JSON reprezentuje 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. Mimo że skrót może mieć tylko 1 element nadrzędny, plik skrótu można skopiować do dodatkowych lokalizacji. Więcej informacji znajdziesz w sekcji Tworzenie skrótu do pliku na Dysku.

`UrlLeaseLimitExceeded`

Ten błąd występuje podczas próby zapisania danych gry z Google Play w Twojej aplikacji. Ten przykładowy plik JSON reprezentuje 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, zakończ lub anuluj przesyłanie migawki, zanim utworzysz kolejną migawkę.

`userRateLimitExceeded`

Ten błąd występuje po osiągnięciu limitu na użytkownika. Może to być limit z konsoli Google Cloud lub z backendu Dysku. Ten przykładowy plik JSON reprezentuje 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, wykonaj jedną z tych czynności:

Zwiększ limit na użytkownika w projekcie Google Cloud. Aby uzyskać więcej informacji, poproś o zwiększenie limitu.

Jeśli jeden użytkownik wysyła wiele żądań w imieniu wielu użytkowników konta Google Workspace, rozważ utworzenie konta usługi z przekazywaniem dostępu w całej domenie za pomocą parametru quotaUser.
Użyj wykładniczego ponowienia, aby ponowić żądanie.

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 plik JSON reprezentuje 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 i używasz metody files.get, upewnij się, że parametr zapytania supportsAllDrives ma wartość true.
Poinformuj użytkownika, że nie ma uprawnień do odczytu pliku lub plik nie istnieje.
Poproś użytkownika, aby skontaktował się z właścicielem pliku i poprosił o uprawnienia.

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 okresie. Ten przykładowy plik JSON reprezentuje 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, 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 wykładniczego ponowienia w celu ponowienia próby wysłania żądania.

Naprawianie błędów

Podsumowanie kodu stanu HTTP

Błędy 400

badRequest

invalidSharingRequest

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

Zmiana listy kontroli dostępu (ACL) nie jest dozwolona dla tego użytkownika

Błędy 401

authError

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, 504;

Powiązane artykuły

`badRequest`

`invalidSharingRequest`

`authError`

`activeItemCreationLimitExceeded`

`appNotAuthorizedToFile`

`cannotModifyInheritedTeamDrivePermission`

`dailyLimitExceeded`

`domainPolicy`

`fileOwnerNotMemberOfTeamDrive`

`fileWriterTeamDriveMoveInDisabled`

`insufficientFilePermissions`

`myDriveHierarchyDepthLimitExceeded`

`numChildrenInNonRootLimitExceeded`

`rateLimitExceeded`

`sharingRateLimitExceeded`

`storageQuotaExceeded`

`teamDriveFileLimitExceeded`

`teamDriveHierarchyTooDeep`

`teamDriveMembershipRequired`

`teamDrivesFolderMoveInNotSupported`

`teamDrivesParentLimit`

`UrlLeaseLimitExceeded`

`userRateLimitExceeded`

`notFound`

`rateLimitExceeded`