Limity wykorzystania

Interfejs Google Docs 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ą kondycję systemu Google Workspace.

Jeśli przekroczysz limit, zwykle otrzymasz odpowiedź z kodem stanu HTTP 429: Too many requests. W takim przypadku użyj algorytmu wzrastającego czasu do ponowienia i spróbuj ponownie później.

W tabeli poniżej znajdziesz szczegółowe informacje o limitach żądań:

Limity
Żądania odczytu
Na minutę na projekt 3000
Na minutę na użytkownika na projekt 300
Żądania zapisu
Na minutę na projekt 600
Na minutę na użytkownika na projekt 60

Rozwiązywanie błędów limitu opartego na czasie

W przypadku wszystkich błędów opartych na czasie (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 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 wykładniczo, zwiększając czas oczekiwania między ponowieniami aż do maksymalnego czasu do ponowienia. Na przykład:

  1. Wyślij żądanie do interfejsu Google Docs API.
  2. Jeśli żądanie się nie powiedzie, poczekaj 1 + random_number_milliseconds i ponów żądanie.
  3. Jeśli żądanie się nie powiedzie, poczekaj 2 + random_number_milliseconds i ponów żądanie.
  4. Jeśli żądanie się nie powiedzie, poczekaj 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ą już 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 Docs API jest bezpłatne. Przekroczenie limitów żądań będzie wiązać się z obciążeniem konta rozliczeniowego Google Cloud opłatami w dalszej części 2026 r. Więcej informacji znajdziesz w artykule Standardowy model Google Workspace dla narzędzi i interfejsów API agenta.

Poproś o zwiększenie limitu

W zależności od wykorzystania zasobów w projekcie 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 jego wartość, może potrwać dłużej.

Nie wszystkie projekty mają takie same limity. W miarę upływu czasu i coraz częstszego korzystania z Google Cloud wartości limitów mogą się zwiększać. Jeśli przewidujesz znaczny wzrost wykorzystania, możesz proaktywnie poprosić o zmianę limitów na stronie Limity i ograniczenia systemu w konsoli Google Cloud.

Więcej informacji znajdziesz w tych materiałach:

Limity serwera MCP Dokumentów

Serwer MCP Dokumentów używa danych o żądaniach odczytu i zapisu. W tabelach poniżej znajdziesz szczegółowe informacje o limitach i kosztach zapytań dla każdej metody serwera MCP Dokumentów według sekcji:

Limity MCP Dokumentów

Obowiązują 2 typy limitów:

  • Na minutę na projekt: liczba żądań, które Twój projekt w chmurze Google Cloud może wysłać w ciągu minuty.
  • Na minutę na użytkownika na projekt: liczba żądań, które może wysłać dowolny użytkownik w Twoim projekcie w chmurze.

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

Limity
Żądania odczytu
Na minutę na projekt 3000
Na minutę na użytkownika na projekt 300
Żądania zapisu
Na minutę na projekt 600
Na minutę na użytkownika na projekt 60

Limity zestawu narzędzi MCP Dokumentów

W tabeli poniżej znajdziesz szczegółowe informacje o kosztach zapytań dla każdego docsmcp.googleapis.com zestawu narzędzi:

Punkt końcowy Narzędzie Koszt zapytania
/mcp/v1 read_doc 1 żądanie odczytu
update_doc 1 żądanie zapisu

Więcej informacji znajdziesz w dokumentacji interfejsu Docs MCP API.