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 przydziału, 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: jest to liczba jednostek limitu, których projekt Google Cloud może użyć w ciągu minuty.

  • Na minutę na użytkownika na projekt: jest to liczba jednostek przydziału, których może użyć dowolny użytkownik w projekcie w chmurze. Ten limit ma na celu zapewnienie sprawiedliwego podziału wykorzystania między użytkowników.

  • Na dzień na projekt: określa maksymalną liczbę bajtów, które 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
Na minutę na użytkownika na projekt 325 000 jednostek przydziału
Na dzień na projekt 1 TB

Jeśli przekroczysz limit, otrzymasz odpowiedź z kodem stanu HTTP 403: User rate limit exceededHTTP. Dodatkowe sprawdzenie limitu liczby żądań w backendzie Dysku może też wygenerować odpowiedź 429: Rate limit exceeded. W takim przypadku 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 przydziału, których projekt Google Cloud może użyć w ciągu 24 godzin, zanim zostaną naliczone opłaty.

Wykorzystanie poniżej tego progu nie wiąże się z dodatkowymi opłatami, a Twoje konto Google Cloud nie jest obciążane. Pełne informacje o rozliczeniach udostępnimy w 2026 r. z co najmniej 90-dniowym wyprzedzeniem przed wprowadzeniem 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
Na dzień na projekt 400 000 000 jednostek limitu

Więcej informacji znajdziesz w artykule Ustandaryzowany model Google Workspace dla narzędzi agenta i interfejsów API.

Wykorzystanie limitu na metodę

Liczba jednostek przydziału zużytych na żądanie zależy od wywoływanej metody. W tabeli poniżej znajdziesz informacje o wykorzystaniu jednostek przydziału na metodę:

Działanie Jednostki limitu
Odczytywanie elementów, np. files.get 5
Wyświetlanie listy elementów, np. files.list 100
Pobieranie elementów, np. files.download 200
Edytowanie elementów, np. files.update 50
Inne działania, np. files.generateIds 5

Dodatkowe ograniczenia

Podczas pracy z interfejsem 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ą limit 750 GB lub prześlą plik większy niż 750 GB, nie będą mogli przesyłać ani kopiować dodatkowych plików przez 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 przydziału. Jednak wywołania metod changes.watch, channels.stop i files.watch są wliczane 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 obowiązują dodatkowe limity miejsca na Dysku.

Rozwiązywanie błędów limitu czasu

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ł obciętego 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 coraz dłuższych czasów oczekiwania między żądaniami, aż do maksymalnego czasu do ponowienia. Jeśli żądania nadal się nie powiodą, ważne jest, aby opóźnienia między żądaniami z czasem się zwiększały, aż żądanie się powiedzie.

Przykładowy algorytm

Algorytm wzrastającego czasu do ponowienia ponawia żądania w sposób wykładniczy, zwiększając czas oczekiwania między ponowieniami aż do maksymalnego czasu do ponowienia. Na przykład:

  1. Wyślij żądanie do interfejsu Google Drive API.
  2. Jeśli żądanie się nie powiedzie, odczekaj 1 + random_number_milliseconds i ponów żądanie.
  3. Jeśli żądanie się nie powiedzie, odczekaj 2 + random_number_milliseconds i ponów żądanie.
  4. Jeśli żądanie się nie powiedzie, odczekaj 4 + random_number_milliseconds i ponów żądanie.
  5. I tak dalej, aż do czasu maximum_backoff.
  6. Czekaj i ponawiaj próbę aż do maksymalnej liczby ponowień, ale nie zwiększaj czasu oczekiwania między ponowieniami.

gdzie:

  • Czas oczekiwania to min(((2^n)+random_number_milliseconds), maximum_backoff), a n jest zwiększane o 1 w 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 zsynchronizowanych przez jakąś sytuację i wszyscy ponawiają próbę jednocześnie, wysyłając żądania w zsynchronizowanych falach. Wartość random_number_milliseconds jest ponownie obliczana po każdym żądaniu ponowienia.
  • maximum_backoff to zwykle 32 lub 64 sekundy. Odpowiednia wartość zależy od przypadku użycia.

Klient może kontynuować ponawianie próby po osiągnięciu czasu maximum_backoff. Ponowienia po tym momencie nie muszą zwiększać czasu do ponowienia. 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óby w nieskończoność.

Czas oczekiwania między ponowieniami i liczba ponowień zależą od przypadku użycia i warunków sieciowych.

Ceny

Standardowe korzystanie z interfejsu Google Drive API jest bezpłatne. Przekroczenie limitów żądań przydziału spowoduje obciążenie Twojego konta rozliczeniowego Google Cloud w późniejszym okresie 2026 r. Więcej informacji znajdziesz w artykule Ustandaryzowany model Google Workspace dla narzędzi i interfejsów API agenta.

Poproś o zwiększenie limitu

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

Nie wszystkie projekty mają takie same limity. W miarę upływu czasu i zwiększania wykorzystania Google Cloud może być konieczne zwiększenie wartości limitu. Jeśli przewidujesz znaczny wzrost wykorzystania, możesz aktywnie poprosić o zmianę limitu na stronie Limity i ograniczenia systemu w konsoli Google Cloud.

Więcej informacji znajdziesz w tych materiałach: