Batas penggunaan

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

Batas ditentukan dalam unit kuota, yaitu unit pengukuran abstrak yang mewakili penggunaan resource Google Drive.

Kuota Drive API

Tiga jenis kuota diberlakukan:

  • Per menit per project: Ini adalah jumlah unit kuota yang dapat digunakan project Google Cloud Anda dalam satu menit.

  • Per menit per pengguna per project: Ini adalah jumlah unit kuota yang dapat digunakan oleh satu pengguna tertentu di project Cloud Anda. Batas ini bertujuan untuk membantu Anda memastikan distribusi penggunaan yang adil di antara pengguna.

  • Per hari per project: Batas ini menentukan jumlah maksimum byte yang dapat keluar dari project Google Cloud Anda dalam periode 24 jam sebelum biaya berlaku.

Tabel berikut menjelaskan batasan ini:

Jenis batas penggunaan Batas
Per menit per project 1.000.000 unit kuota
Per menit per pengguna per project 325.000 unit kuota
Per hari per project 1 TB

Jika Anda melebihi kuota, Anda akan menerima respons kode status HTTP 403: User rate limit exceeded. Pemeriksaan batas frekuensi tambahan di backend Drive juga dapat menghasilkan 429: Rate limit exceeded respons. Jika hal ini terjadi, Anda harus menggunakan algoritma backoff eksponensial dan mencoba lagi nanti.

Nilai minimum penagihan harian

Batas per hari per project ini menentukan jumlah maksimum unit kuota yang dapat digunakan project Google Cloud Anda dalam periode 24 jam sebelum biaya berlaku.

Penggunaan di bawah nilai minimum ini tidak dikenai biaya tambahan dan akun Google Cloud Anda tidak ditagih. Detail penagihan lengkap akan dibagikan nanti pada tahun 2026 dengan pemberitahuan minimal 90 hari sebelum perubahan apa pun berlaku.

Anda tidak dapat meminta peningkatan batas nilai minimum harian ini.

Tabel berikut menjelaskan batasnya:

Jenis batas nilai minimum Batas
Per hari per project 400.000.000 unit kuota

Untuk mengetahui informasi selengkapnya, lihat Model standar Google Workspace untuk alat agen dan API.

Penggunaan kuota per metode

Jumlah unit kuota yang digunakan per permintaan bervariasi, bergantung pada metode yang dipanggil. Tabel berikut menguraikan penggunaan unit kuota per metode:

Tindakan Unit kuota
Membaca item, seperti files.get 5
Mencantumkan item, seperti files.list 100
Mendownload item, seperti files.download 200
Mengedit item, seperti files.update 50
Tindakan lain, seperti files.generateIds 5

Penghambat tambahan

Batasan berikut diberlakukan saat menggunakan Drive API:

  • Pengguna Google Workspace hanya dapat mengupload file berukuran maksimum 750 GB per hari antara Drive Saya dan semua drive bersama. Batas ini juga berlaku untuk salinan.

  • Pengguna yang mencapai batas 750 GB atau mengupload file yang lebih besar dari 750 GB tidak dapat mengupload atau menyalin file tambahan hingga 24 jam telah berlalu.

  • Ukuran file maksimum yang dapat diupload pengguna adalah 5 TB. Hanya file pertama yang melampaui batas yang akan selesai diupload. Ukuran file maksimum yang dapat disalin pengguna adalah 750 GB.

  • Notifikasi yang dikirimkan ke alamat yang ditentukan saat membuka saluran notifikasi tidak dihitung terhadap batas kuota Anda. Namun, panggilan ke metode changes.watch, channels.stop, dan files.watch akan dihitung terhadap kuota Anda.

  • Selama Anda tidak melebihi kuota per menit, tidak ada batasan jumlah permintaan yang dapat Anda buat per hari.

  • Bergantung pada jenis akun Google Workspace Anda, ada batas penyimpanan Drive tambahan .

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 terpotong 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 untuk meningkatkan penundaan antar-permintaan 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 Drive API.
  2. Jika permintaan gagal, tunggu 1 + random_number_milliseconds, lalu coba lagi permintaan tersebut.
  3. Jika permintaan gagal, tunggu 2 + random_number_milliseconds, lalu coba lagi permintaan tersebut.
  4. Jika permintaan gagal, tunggu 4 + random_number_milliseconds, lalu coba lagi permintaan tersebut.
  5. Dan seterusnya, hingga waktu maximum_backoff.
  6. Lanjutkan menunggu dan mencoba 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 angka acak milidetik yang kurang dari atau sama dengan 1.000. Hal ini membantu menghindari kasus saat banyak klien disinkronkan oleh situasi tertentu dan semua mencoba lagi secara bersamaan, sehingga mengirimkan permintaan dalam gelombang yang disinkronkan. Nilai random_number_milliseconds dihitung ulang setelah setiap permintaan percobaan ulang.
  • 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 Drive API tersedia tanpa biaya tambahan. Melebihi batas permintaan kuota direncanakan akan dikenai biaya ke 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, 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 mungkin memerlukan 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 Kuota & Batas Sistem di konsol Google Cloud.

Untuk mempelajari lebih lanjut, lihat referensi berikut: