Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Limity wykorzystania

Interfejs Google Drive API jest usługą udostępnianą, dlatego stosujemy limity, aby zapewnić, że wszyscy użytkownicy korzystają z niego w sposób uczciwy, oraz chronić ogólną wydajność systemu Google Workspace.

Limity są określane w jednostkach limitu, czyli abstrakcyjnych jednostkach miary reprezentujących wykorzystanie zasobów Dysku Google.

Limity interfejsu Drive API

Egzekwowane są 3 rodzaje limitów:

Na minutę na projekt: to liczba jednostek limitu, które projekt Google Cloud może wykorzystać w ciągu minuty.
Na minutę na użytkownika na projekt: to liczba jednostek limitu, które może wykorzystać dany użytkownik w Twoim projekcie w chmurze. Ten limit ma pomóc w zapewnieniu sprawiedliwego podziału wykorzystania między użytkowników.
Dziennie na projekt: określa maksymalną liczbę bajtów, które Twój projekt Google Cloud może przesłać w ciągu 24 godzin, zanim zostaną naliczone opłaty.

W tabeli poniżej znajdziesz szczegółowe informacje o tych limitach:

Typ limitu wykorzystania	Limit
Na minutę na projekt	1 000 000 jednostek limitu
Za minutę na użytkownika na projekt	325 000 jednostek limitu
Dziennie na projekt	1 TB

Jeśli przekroczysz limit, otrzymasz odpowiedź z kodem stanu HTTP 403: User rate limit exceeded. Dodatkowe kontrole limitu liczby żądań w backendzie Dysku mogą też wygenerować odpowiedź 429: Rate limit exceeded. Jeśli tak się stanie, użyj algorytmu wzrastającego czasu do ponowienia i spróbuj ponownie później.

Dzienny próg naliczania należności

Ten limit na dzień na projekt określa maksymalną liczbę jednostek limitu, które projekt w chmurze Google może wykorzystać w ciągu 24 godzin, zanim zostaną naliczone opłaty.

Użycie poniżej tego progu nie powoduje naliczenia dodatkowych opłat, a Twoje konto Google Cloud nie jest obciążane. Pełne informacje o płatnościach zostaną udostępnione w 2026 r. z co najmniej 90-dniowym wyprzedzeniem przed wejściem w życie jakichkolwiek zmian.

Nie możesz poprosić o zwiększenie tego dziennego limitu.

W tabeli poniżej znajdziesz szczegółowe informacje o limicie:

Typ limitu progu	Limit
Dziennie na projekt	400 000 000 jednostek limitu

Więcej informacji znajdziesz w artykule Standaryzowany model Google Workspace dotyczący narzędzi i interfejsów API agentów.

Koszty jednostkowe limitu na metodę

Liczba jednostek limitu wykorzystywanych na żądanie różni się w zależności od wywołanej metody, jak opisano w poniższych tabelach:

Metody odczytu (5 jednostek limitu)

Metoda
`drive.about.get`
`drive.accessproposals.get`
`drive.apps.get`
`drive.approvals.get`
`drive.changes.get`
`drive.children.get`
`drive.comments.get`
`drive.drives.get`
`drive.files.get (without alt=media)`
`drive.parents.get`
`drive.permissions.get`
`drive.properties.get`
`drive.replies.get`
`drive.revisions.get (without alt=media)`
`drive.teamdrives.get`

Metody wyświetlania listy (100 jednostek limitu)

Metoda
`drive.accessproposals.list`
`drive.apps.list`
`drive.changes.list`, `drive.changes.watch`
`drive.children.list`
`drive.comments.list`
`drive.drives.list`
`drive.files.list`, `drive.files.watch`
`drive.parents.list`
`drive.permissions.list`
`drive.properties.list`
`drive.replies.list`
`drive.revisions.list`
`drive.teamdrives.list`

Metody edycji (50 jednostek limitu)

Metoda
`drive.approvals.decline`
`drive.children.delete`, `drive.children.insert`
`drive.comments.create`, `drive.comments.delete`, `drive.comments.insert`, `drive.comments.patch`, `drive.comments.update`
`drive.drives.create`, `drive.drives.delete`, `drive.drives.hide`, `drive.drives.insert`, `drive.drives.unhide`, `drive.drives.update`
`drive.files.copy`, `drive.files.create`, `drive.files.delete`, `drive.files.emptyTrash`, `drive.files.insert`, `drive.files.modifyLabels`, `drive.files.patch`, `drive.files.touch`, `drive.files.trash`, `drive.files.untrash`, `drive.files.update`
`drive.parents.delete`, `drive.parents.insert`
`drive.permissions.create`, `drive.permissions.delete`, `drive.permissions.insert`, `drive.permissions.patch`, `drive.permissions.update`
`drive.properties.delete`, `drive.properties.insert`, `drive.properties.patch`, `drive.properties.update`
`drive.replies.create`, `drive.replies.delete`, `drive.replies.insert`, `drive.replies.patch`, `drive.replies.update`
`drive.revisions.delete`, `drive.revisions.patch`, `drive.revisions.update`
`drive.teamdrives.create`, `drive.teamdrives.delete`, `drive.teamdrives.insert`, `drive.teamdrives.update`

Metody pobierania (200 jednostek limitu)

Metoda
`drive.files.download`, `drive.files.export`, `drive.files.get (with alt=media)`
`drive.revisions.get (with alt=media)`

Inne metody (5 jednostek limitu)

Metoda
`drive.changes.getStartPageToken`
`drive.channels.stop`
`drive.files.generateCseToken`, `drive.files.generateIds`, `drive.files.listLabels`
`drive.operations.get`
`drive.permissions.getIdForEmail`

Dodatkowe ograniczenia

Podczas pracy z interfejsem Drive API obowiązują te ograniczenia:

Użytkownicy Google Workspace mogą przesyłać tylko 750 GB danych dziennie między Moim dyskiem a wszystkimi dyskami współdzielonymi. Ten limit dotyczy też kopii.
Użytkownicy, którzy przekroczą limit 750 GB lub prześlą plik większy niż 750 GB, nie będą mogli przesyłać ani kopiować kolejnych plików przez 24 godziny.
Maksymalny rozmiar pliku, jaki użytkownicy mogą przesłać, to 5 TB. Przesyłanie zostanie zakończone, tylko gdy pierwszy plik przekroczy limit. Maksymalny rozmiar pliku, który użytkownicy mogą skopiować, to 750 GB.
Powiadomienia dostarczane na adres podany podczas otwierania kanału powiadomień nie są wliczane do limitów. Jednak wywołania metod changes.watch, channels.stop i files.watch wliczają się do limitu.
Jeśli nie przekroczysz limitów na minutę, nie ma ograniczeń co do liczby żądań, które możesz wysłać dziennie.
W zależności od typu konta Google Workspace mogą obowiązywać dodatkowe limity miejsca na Dysku.

Rozwiązywanie problemów z limitami opartymi na czasie

W przypadku wszystkich błędów związanych z czasem (maksymalnie N żądań na X minut) zalecamy, aby kod przechwytywał wyjątek i używał skróconego wzrastającego czasu do ponowienia, aby urządzenia nie generowały nadmiernego obciążenia.

Wzrastający czas do ponowienia to standardowa strategia obsługi błędów w aplikacjach sieciowych. Algorytm wzrastającego czasu do ponowienia ponawia żądania, stosując wykładniczo rosnące czasy oczekiwania między żądaniami, aż do osiągnięcia maksymalnego czasu do ponowienia. Jeśli żądania nadal nie będą się udawać, ważne jest, aby opóźnienia między żądaniami zwiększały się z czasem, aż żądanie zostanie zrealizowane.

Przykładowy algorytm

Algorytm wzrastającego czasu do ponowienia ponawia żądania wykładniczo, zwiększając czas oczekiwania między próbami aż do maksymalnego czasu do ponowienia. Na przykład:

wysyłać żądania do interfejsu Google Drive API,
Jeśli żądanie się nie powiedzie, poczekaj 1 + random_number_milliseconds i spróbuj ponownie.
Jeśli żądanie się nie powiedzie, odczekaj 2 + random_number_milliseconds i spróbuj ponownie.
Jeśli żądanie się nie powiedzie, odczekaj 4 + random_number_milliseconds i spróbuj ponownie.
i tak dalej, aż do maximum_backoff razy.
Kontynuuj oczekiwanie i ponawianie prób aż do osiągnięcia maksymalnej liczby prób, ale nie zwiększaj czasu oczekiwania między próbami.

gdzie:

Czas oczekiwania wynosi min(((2^n)+random_number_milliseconds), maximum_backoff), przy czym wartość n jest zwiększana o 1 przy każdej iteracji (żądaniu).
random_number_milliseconds to losowa liczba milisekund mniejsza niż lub równa 1000. Pomaga to uniknąć sytuacji, w których wiele klientów jest synchronizowanych przez jakąś sytuację i wszystkie ponawiają próby jednocześnie, wysyłając żądania w zsynchronizowanych falach. Wartość random_number_milliseconds jest ponownie obliczana po każdym żądaniu ponowienia.
Wartość maximum_backoff to zwykle 32 lub 64 sekundy. Odpowiednia wartość zależy od przypadku użycia.

Klient może kontynuować próby po upływie czasu maximum_backoff. Po tym czasie nie trzeba już zwiększać czasu oczekiwania. Jeśli na przykład klient używa czasu maximum_backoff wynoszącego 64 sekundy, po osiągnięciu tej wartości może ponawiać próbę co 64 sekundy. W pewnym momencie należy uniemożliwić klientom ponawianie prób w nieskończoność.

Czas oczekiwania między próbami i liczba prób zależą od przypadku użycia i warunków sieciowych.

Ceny

Standardowe korzystanie z interfejsu Google Drive API jest dostępne bez dodatkowych opłat. Przekroczenie limitów żądań będzie wiązało się z obciążaniem Twojego konta rozliczeniowego Google Cloud opłatami w późniejszym okresie 2026 r. Więcej informacji znajdziesz w artykule Standaryzowany model Google Workspace dotyczący narzędzi i interfejsów API agentów.

Poproś o zwiększenie limitu

W zależności od wykorzystania zasobów w projekcie możesz poprosić o dostosowanie limitu. Wywołania interfejsu API przez konto usługi są traktowane jako użycie jednego konta. Wysłanie wniosku o zwiększenie limitu nie gwarantuje jego zatwierdzenia. Zatwierdzenie próśb o dostosowanie limitu, które znacznie zwiększyłyby wartość limitu, może potrwać dłużej.

Nie wszystkie projekty mają takie same limity. W miarę jak z czasem będziesz coraz częściej korzystać z Google Cloud, może być konieczne zwiększenie wartości limitów. Jeśli spodziewasz się znacznego wzrostu wykorzystania, możesz z wyprzedzeniem poprosić o zmianę limitów na stronie Limity przydziału i limity systemu w konsoli Google Cloud.

Więcej informacji znajdziesz w tych materiałach:

Limity serwera MCP Dysku

Serwer MCP Dysku używa wskaźnika alokacji kosztów zapytania. W poniższych tabelach znajdziesz szczegółowe informacje o kosztach zapytań dotyczących poszczególnych metod serwera MCP na Dysku według sekcji:

Limity MCP Dysku

Egzekwowane są 2 rodzaje limitów:

Na minutę na projekt: to koszt zapytania w projekcie Google Cloud przez 1 minutę.
Na minutę na użytkownika na projekt: to koszt zapytania do projektu w chmurze Google Cloud przez 1 minutę, który może wykorzystać dany użytkownik.