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ą współdzieloną, dlatego stosujemy limity i ograniczenia, aby zapewnić sprawiedliwe korzystanie z niego przez wszystkich użytkowników i 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

Obowiązują 3 rodzaje limitów:

Na minutę na projekt: to liczba jednostek limitu, z których Twój projekt Google Cloud może korzystać w ciągu minuty.
Na minutę na użytkownika na projekt: to liczba jednostek limitu, z których może korzystać dowolny użytkownik w Twoim projekcie w chmurze. Ten limit ma na celu zapewnienie sprawiedliwego rozkładu wykorzystania wśród użytkowników.
Dziennie na projekt: określa maksymalną liczbę bajtów, które Twój projekt Google Cloud może wysł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 sprawdzanie limitu żądań w usłudze Drive może też generować odpowiedź 429: Rate limit exceeded. W takiej sytuacji użyj algorytmu wzrastającego czasu do ponowienia i spróbuj ponownie później.

Dzienny próg naliczania należności

Ten limit dzienny na projekt określa maksymalną liczbę jednostek limitu, jaką Twój projekt Google Cloud może wykorzystać w ciągu 24 godzin, zanim zostaną naliczone opłaty.

Korzystanie z usług w ramach tego limitu nie wiąże się z dodatkowymi opłatami, a Twoje konto Google Cloud nie jest obciążane. Szczegółowe informacje o rozliczeniach zostaną udostępnione w 2026 roku z co najmniej 90-dniowym wyprzedzeniem przed wejściem w życie jakichkolwiek zmian.

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

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 Ujednolicony model Google Workspace dla narzędzi agenta i interfejsów API.

Wykorzystanie limitu według metody

Liczba jednostek limitu wykorzystywanych na żądanie zależy od wywoływanej metody. W tabeli poniżej znajdziesz informacje o wykorzystaniu jednostek limitu w przypadku poszczególnych metod:

Działanie	Jednostki przydziału
odczytywać elementy, takie jak `files.get`;	5
elementy listy, np. `files.list`;	100
pobierać elementy, takie jak `files.download`;	200
Edytuj elementy, takie jak `files.update`	50
Inne działania, np. `files.generateIds`	5

Dodatkowe ograniczenia

Podczas korzystania z interfejsu Drive API obowiązują te ograniczenia:

Użytkownicy Google Workspace mogą przesyłać łącznie do 750 GB danych dziennie na Mój dysk i wszystkie dyski współdzielone. Ten limit dotyczy też kopii.
Użytkownicy, którzy przekroczą ten limit lub prześlą plik większy niż 750 GB, nie będą mogli przesyłać ani kopiować kolejnych plików, dopóki nie minie 24 godziny.
Maksymalny rozmiar pliku, który 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 kwot. 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ć w ciągu dnia.
W zależności od rodzaju konta Google Workspace obowiązują 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, używając wykładniczo rosnących czasów oczekiwania między żądaniami, aż do maksymalnego czasu do ponowienia. Jeśli żądania nadal są nieudane, ważne jest, aby opóźnienia między żądaniami z czasem się zwiększały, aż żądanie zostanie zrealizowane.

Przykładowy algorytm

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

Wysyłanie żą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, poczekaj 2 + random_number_milliseconds i spróbuj ponownie.
Jeśli prośba się nie powiedzie, poczekaj 4 + random_number_milliseconds i spróbuj ponownie.
I tak dalej, aż do maximum_backoff razy.
Kontynuuj oczekiwanie i ponawianie prób do osiągnięcia maksymalnej liczby prób, ale nie wydłużaj czasu oczekiwania między próbami.

gdzie:

Czas oczekiwania wynosi min(((2^n)+random_number_milliseconds), maximum_backoff), a wartość n jest zwiększana o 1 przy każdej iteracji (żądaniu).
random_number_milliseconds to losowa liczba milisekund mniejsza lub równa 1000. Pomaga to uniknąć sytuacji, w których wielu klientów jest synchronizowanych przez pewne zdarzenie i wszyscy ponawiają próbę w tym samym czasie, wysyłając żądania w zsynchronizowanych falach. Wartość random_number_milliseconds jest ponownie obliczana po każdej próbie ponowienia.
maximum_backoff wynosi zwykle 32 lub 64 sekundy. Odpowiednia wartość zależy od przypadku użycia.

Klient może ponawiać próby po osiągnięciu czasu maximum_backoff. Ponowne próby po tym momencie nie muszą już wydłużać czasu do ponowienia. Jeśli na przykład klient używa czasu maximum_backoff 64 sekund, 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 ponownymi próbami i liczba ponownych 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ć się z obciążaniem Twojego konta rozliczeniowego Google Cloud opłatami w późniejszym okresie 2026 r. Więcej informacji znajdziesz w artykule Ujednolicony model Google Workspace dla narzędzi agenta i interfejsów API.

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 korzystanie z jednego konta. Wysłanie wniosku o zwiększenie limitu nie gwarantuje jego zatwierdzenia. Zatwierdzenie próśb o dostosowanie limitu, które znacznie zwiększają jego wartość, może potrwać dłużej.

Nie wszystkie projekty mają takie same limity. W miarę upływu czasu i zwiększania wykorzystania Google Cloud wartości limitów mogą wymagać zwiększenia. 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:

Zwiększanie limitów serwera MCP

Serwer MCP Dysku używa wskaźnika alokacji kosztów zapytania. W tabelach poniżej znajdziesz szczegółowe informacje o koszcie zapytania dla każdej metody serwera MCP Dysku Google według sekcji:

Limity MCP na Dysku

Obowiązują 2 rodzaje limitów:

Za minutę na projekt: jest to koszt zapytania do projektu Google Cloud za jedną minutę.
Za minutę na użytkownika na projekt: jest to koszt zapytania do Twojego projektu w chmurze Google Cloud za jedną minutę, z której może korzystać dowolny użytkownik.