Batas penggunaan

Karena Google Docs API adalah layanan bersama, kami menerapkan kuota dan batasan untuk memastikan layanan ini digunakan secara adil oleh semua pengguna dan untuk melindungi kesehatan keseluruhan sistem Google Workspace.

Jika melebihi kuota, Anda umumnya akan menerima respons kode status HTTP 429: Too many requests. Jika hal ini terjadi, Anda harus menggunakan algoritma backoff eksponensial dan mencoba lagi nanti.

Tabel berikut menjelaskan batas permintaan:

Kuota
Permintaan baca
Per menit per project 3000
Per menit per pengguna per project 300
Permintaan tulis
Per menit per project 600
Per menit per pengguna per project 60

Mengatasi error kuota berbasis waktu

Untuk semua error berbasis waktu (maksimum N permintaan per X menit), sebaiknya kode Anda menangkap pengecualian dan menggunakan backoff eksponensial yang dipangkas untuk memastikan perangkat Anda tidak menghasilkan beban yang berlebihan.

Backoff eksponensial adalah strategi penanganan error standar untuk aplikasi jaringan. Algoritma backoff eksponensial mencoba ulang permintaan menggunakan waktu tunggu yang meningkat secara eksponensial di antara permintaan, hingga waktu backoff maksimum. Jika permintaan masih gagal, penting agar penundaan di antara permintaan meningkat dari waktu ke waktu hingga permintaan berhasil.

Contoh algoritma

Algoritma backoff eksponensial mencoba ulang permintaan secara eksponensial, sehingga meningkatkan waktu tunggu antar-percobaan ulang hingga waktu backoff maksimum. Contoh:

  1. Buat permintaan ke Google Dokumen API.
  2. Jika permintaan gagal, tunggu 1 + random_number_milliseconds detik, lalu coba lagi permintaan tersebut.
  3. Jika permintaan gagal, tunggu 2 + random_number_milliseconds detik dan coba lagi permintaan tersebut.
  4. Jika permintaan gagal, tunggu 4 + random_number_milliseconds dan coba lagi permintaan tersebut.
  5. Dan seterusnya, hingga maximum_backoff kali.
  6. Terus tunggu dan coba ulang hingga jumlah maksimum percobaan ulang, tetapi jangan tambah waktu tunggu antar-percobaan ulang.

dengan:

  • Waktu tunggu adalah min(((2^n)+random_number_milliseconds), maximum_backoff), dengan n bertambah 1 untuk setiap iterasi (permintaan).
  • random_number_milliseconds adalah jumlah acak milidetik yang kurang dari atau sama dengan 1.000. Hal ini membantu menghindari kasus saat banyak klien disinkronkan oleh beberapa situasi dan semua mencoba lagi secara bersamaan, sehingga mengirimkan permintaan dalam gelombang yang disinkronkan. Nilai random_number_milliseconds dihitung ulang setelah setiap permintaan coba lagi.
  • maximum_backoff biasanya 32 atau 64 detik. Nilai yang sesuai bergantung pada kasus penggunaan.

Klien dapat terus mencoba ulang setelah mencapai waktu maximum_backoff. Percobaan ulang setelah tahap ini tidak perlu terus meningkatkan waktu backoff. Misalnya, jika klien menggunakan waktu maximum_backoff 64 detik, setelah mencapai nilai ini, klien dapat mencoba lagi setiap 64 detik. Pada saat tertentu, klien seharusnya dicegah untuk mencoba ulang tanpa batas waktu.

Waktu tunggu antara percobaan ulang dan jumlah percobaan ulang bergantung pada kasus penggunaan dan kondisi jaringan Anda.

Harga

Semua penggunaan standar Google Docs API tersedia tanpa biaya tambahan. Melebihi batas permintaan kuota direncanakan akan menimbulkan biaya pada akun penagihan Google Cloud Anda pada tahun 2026. Untuk mengetahui informasi selengkapnya, lihat Model standar Google Workspace untuk alat dan API agen.

Meminta penambahan kuota

Bergantung pada penggunaan resource project, Anda mungkin ingin meminta penyesuaian kuota. Panggilan API oleh akun layanan dianggap menggunakan satu akun. Mengajukan permohonan untuk penyesuaian kuota belum tentu disetujui. Permintaan penyesuaian kuota yang akan meningkatkan nilai kuota secara signifikan membutuhkan waktu lebih lama untuk disetujui.

Tidak semua project memiliki kuota yang sama. Seiring meningkatnya penggunaan Google Cloud dari waktu ke waktu, nilai kuota Anda mungkin perlu ditingkatkan. Jika Anda memperkirakan adanya peningkatan penggunaan yang signifikan di masa mendatang, Anda dapat secara proaktif meminta penyesuaian kuota dari halaman Quotas & System Limits di konsol Google Cloud.

Untuk mempelajari lebih lanjut, lihat referensi berikut:

Kuota server MCP Docs

Server MCP Dokumen menggunakan metrik permintaan baca dan tulis. Tabel berikut memerinci kuota dan biaya kueri untuk setiap metode server MCP Docs menurut bagian:

Kuota MCP Docs

Dua jenis kuota yang diterapkan:

  • Per menit per project: Ini adalah jumlah permintaan yang dapat dibuat project Google Cloud Anda dalam satu menit.
  • Per menit per pengguna per project: Ini adalah jumlah permintaan yang dapat dibuat oleh satu pengguna tertentu di project Cloud Anda.

Tabel berikut menjelaskan kuota ini:

Kuota
Permintaan baca
Per menit per project 3.000
Per menit per pengguna per project 300
Permintaan tulis
Per menit per project 600
Per menit per pengguna per project 60

Kuota set alat MCP Docs

Tabel berikut memerinci biaya kueri untuk setiap set alat docsmcp.googleapis.com:

Endpoint Alat Biaya kueri
/mcp/v1 read_doc 1 permintaan baca
update_doc 1 permintaan penulisan

Untuk mengetahui informasi selengkapnya, lihat Referensi API MCP Dokumen.