Halaman ini diterjemahkan oleh Cloud Translation API.

Mengatasi error

Google Drive API menampilkan dua tingkat informasi error:

Kode error HTTP dan pesan header.
Objek JSON di isi respons dengan detail tambahan yang dapat membantu Anda menentukan cara menangani error.

Aplikasi Google Drive harus menangkap dan menangani semua error yang mungkin terjadi saat menggunakan REST API. Panduan ini memberikan petunjuk tentang cara mengatasi error Drive API tertentu.

Ringkasan kode status HTTP

Kode error	Deskripsi
`200 - OK`	Permintaan berhasil (ini adalah respons standar untuk permintaan HTTP yang berhasil).
`400 - Bad Request`	Permintaan tidak dapat dipenuhi karena error klien dalam permintaan.
`401 - Unauthorized`	Permintaan berisi kredensial yang tidak valid.
`403 - Forbidden`	Permintaan diterima dan dipahami, tetapi pengguna tidak memiliki izin untuk menjalankan permintaan tersebut.
`404 - Not Found`	Halaman yang diminta tidak dapat ditemukan.
`429 - Too Many Requests`	Terlalu banyak permintaan ke API.
`500, 502, 503, 504 - Server Errors`	Terjadi error tak terduga saat memproses permintaan.

Error 400

Error ini berarti permintaan tidak dapat diterima, sering kali karena parameter wajib diisi tidak ada.

`badRequest`

Error ini dapat terjadi karena salah satu masalah berikut dalam kode Anda:

Kolom atau parameter wajib diisi belum diisi.
Nilai yang diberikan atau kombinasi kolom yang diberikan tidak valid.
Anda mencoba menambahkan orang tua duplikat ke file Drive.
Anda mencoba menambahkan induk yang akan membuat siklus dalam grafik direktori.

Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "global",
        "location": "orderBy",
        "locationType": "parameter",
        "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order.",
        "reason": "badRequest"
      }
    ],
    "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order."
  }
}

Untuk memperbaiki error ini, periksa kolom message dan sesuaikan kode Anda.

`illegalKeepForeverModification`

Error ini terjadi saat mencoba menyetel revisi file blob yang ditandai sebagai "Simpan Selamanya" ke false. Contoh JSON berikut adalah representasi dari kesalahan ini:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "illegalKeepForeverModification",
    "message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
   }
  ],
  "code": 400,
  "message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
 }
}

Untuk memperbaiki error ini, hapus revisi file blob secara permanen untuk menghapus setelan "Simpan Selamanya".

`invalidSharingRequest`

Error ini terjadi karena beberapa alasan. Untuk menentukan penyebabnya, evaluasi kolom reason dari JSON yang ditampilkan. Error ini paling sering terjadi karena:

Berbagi berhasil, tetapi email notifikasi tidak terkirim dengan benar.
Perubahan Daftar Kontrol Akses (ACL) tidak diizinkan untuk pengguna ini.

Kolom message menunjukkan error sebenarnya.

Berbagi berhasil, tetapi email notifikasi tidak terkirim dengan benar

Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidSharingRequest",
        "message": "Bad Request. User message: \"Sorry, the items were successfully shared but emails could not be sent to email@domain.com.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

Untuk memperbaiki error ini, beri tahu pengguna (pembagi) bahwa mereka tidak dapat berbagi karena email notifikasi tidak dapat dikirim ke alamat email tujuan. Pengguna harus memastikan bahwa alamat email yang dimasukkan benar dan dapat menerima email.

Perubahan ACL tidak diizinkan untuk pengguna ini

Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidSharingRequest",
        "message": "Bad Request. User message: \"ACL change not allowed.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

Untuk memperbaiki error ini, periksa setelan berbagi domain Google Workspace tempat file berada. Setelan mungkin melarang berbagi di luar domain atau berbagi drive bersama mungkin tidak diizinkan.

Error 401

Error ini berarti permintaan tidak berisi token akses yang valid.

`authError`

Error ini terjadi jika token akses yang Anda gunakan sudah tidak berlaku atau tidak valid. Error ini juga dapat disebabkan oleh otorisasi yang tidak ada untuk cakupan yang diminta. Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "authError",
        "message": "Invalid Credentials",
        "locationType": "header",
        "location": "Authorization",
      }
    ],
    "code": 401,
    "message": "Invalid Credentials"
  }
}

Untuk memperbaiki error ini, perbarui token akses menggunakan token refresh yang berlaku lama. Jika gagal, arahkan pengguna melalui alur OAuth, seperti yang dijelaskan dalam Memilih cakupan Google Drive API.

`fileNotDownloadable`

Error ini terjadi saat Anda mencoba menggunakan metode revisions.get dengan parameter URL alt=media pada dokumen Google Workspace. Contoh JSON berikut adalah representasi error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileNotDownloadable",
        "message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
      }
    ],
    "code": 403,
    "message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
  }
}

Untuk memperbaiki error ini, coba salah satu langkah berikut:

Hapus parameter URL alt=media jika Anda ingin melihat metadata revisi tertentu, seperti mimetype.
Gunakan metode files.export untuk mengekspor konten byte dokumen Google Workspace. Untuk mengetahui informasi selengkapnya, lihat Mengekspor konten dokumen Google Workspace.

Error 403

Error ini berarti batas penggunaan telah terlampaui atau pengguna tidak memiliki hak istimewa yang benar. Untuk menentukan penyebabnya, evaluasi kolom reason dari JSON yang ditampilkan.

Untuk mengetahui informasi tentang batas Drive API, lihat Batas penggunaan. Untuk mengetahui informasi tentang batas folder Drive, lihat Batas file dan folder.

`activeItemCreationLimitExceeded`

Error activeItemCreationLimitExceeded terjadi saat batas jumlah item yang dibuat per akun telah terlampaui. Setiap pengguna dapat memiliki hingga 500 juta item yang dibuat oleh akun. Untuk mengetahui informasi selengkapnya, lihat Batas item pengguna.

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "activeItemCreationLimitExceeded",
    "message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
   }
  ],
  "code": 403,
  "message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
 }
}

Untuk memperbaiki error ini:

Memberi tahu pengguna bahwa Drive mencegah akun membuat lebih dari 500 juta item.
Jika pengguna harus membuat item di akun yang sama ini, beri tahu mereka untuk menghapus beberapa objek secara permanen. Jika tidak, mereka dapat menggunakan akun lain yang sudah memenuhi persyaratan.

`appNotAuthorizedToFile`

Error ini terjadi saat aplikasi Anda tidak ada di ACL untuk file tersebut. Error ini mencegah pengguna membuka file dengan aplikasi Anda. Contoh JSON berikut adalah representasi error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "appNotAuthorizedToFile",
        "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
  }
}

Untuk memperbaiki error ini, coba salah satu langkah berikut:

Buka pemilih Google Drive dan minta pengguna untuk membuka file.
Minta pengguna untuk membuka file menggunakan menu konteks Buka dengan di UI Drive aplikasi Anda.
Gunakan metode files.get untuk memeriksa kolom isAppAuthorized pada resource files guna memverifikasi bahwa aplikasi Anda membuat atau membuka file.

`cannotModifyInheritedTeamDrivePermission`

Error ini terjadi saat pengguna mencoba mengubah izin yang diwariskan dari item dalam drive bersama. Izin yang diwariskan tidak dapat dihapus dari item di drive bersama. Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "cannotModifyInheritedTeamDrivePermission",
        "message": "Cannot update or delete an inherited permission on a shared drive item."
      }
    ],
    "code": 403,
    "message": "Cannot update or delete an inherited permission on a shared drive item."
  }
}

Untuk memperbaiki error ini, pengguna harus menyesuaikan izin pada item induk langsung atau tidak langsung yang izinnya diwarisi. Untuk mengetahui informasi selengkapnya, lihat Cara kerja izin. Anda juga dapat mengambil resource permissions untuk melihat apakah izin pada item drive bersama ini diwariskan atau diterapkan secara langsung.

`dailyLimitExceeded`

Error ini terjadi saat batas API untuk project Anda tercapai. Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "dailyLimitExceeded",
        "message": "Daily Limit Exceeded"
      }
    ],
    "code": 403,
    "message": "Daily Limit Exceeded"
  }
}

Error ini muncul saat pemilik aplikasi telah menetapkan batas kuota untuk membatasi penggunaan resource tertentu. Untuk memperbaiki error ini, hapus batas penggunaan untuk kuota "Kueri per hari".

`domainPolicy`

Error ini terjadi saat kebijakan untuk domain pengguna tidak mengizinkan akses ke Drive oleh aplikasi Anda. Contoh JSON berikut adalah representasi error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "domainPolicy",
        "message": "The domain administrators have disabled Drive apps."
      }
    ],
    "code": 403,
    "message": "The domain administrators have disabled Drive apps."
  }
}

Untuk memperbaiki error ini:

Memberi tahu pengguna bahwa domain tidak mengizinkan aplikasi Anda mengakses file di Drive.
Mengarahkan pengguna untuk menghubungi administrator domain guna meminta akses untuk aplikasi Anda.

`downloadRestrictedForRevision`

Error ini terjadi saat pengguna tidak dapat mendownload revisi file blob. Contoh JSON berikut adalah representasi error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "download_restricted_for_revision",
        "message": "This revision cannot be downloaded by the authenticated user."
      }
    ],
    "code": 403,
    "message": "This revision cannot be downloaded by the authenticated user."
  }
}

Untuk memperbaiki error ini, beri tahu pengguna bahwa satu-satunya cara untuk mendownload revisi file blob adalah jika revisi tersebut ditandai sebagai "Simpan Selamanya". Untuk mengetahui informasi selengkapnya, lihat Menentukan revisi yang akan disimpan dari penghapusan otomatis.

`fileOwnerNotMemberOfTeamDrive`

Error ini terjadi saat mencoba memindahkan file ke drive bersama dan pemilik file bukan anggota. Contoh JSON berikut adalah representasi dari kesalahan ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileOwnerNotMemberOfTeamDrive",
        "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
      }
    ],
    "code": 403,
    "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
  }
}

Untuk memperbaiki error ini:

Tambahkan anggota ke drive bersama dengan role=owner. Untuk mengetahui informasi selengkapnya, lihat Membagikan file, folder, dan drive.
Tambahkan file ke drive bersama. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengisi folder.

`fileWriterTeamDriveMoveInDisabled`

Error ini terjadi saat administrator domain belum mengizinkan pengguna dengan role=writer memindahkan item ke drive bersama. Pengguna yang mencoba memindahkan item memiliki lebih sedikit izin daripada yang diizinkan di drive bersama tujuan. Contoh JSON berikut adalah representasi error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileWriterTeamDriveMoveInDisabled",
        "message": "The domain administrator has not allowed writers to move items into a shared drive."
      }
    ],
    "code": 403,
    "message": "The domain administrator has not allowed writers to move items into a shared drive."
  }
}

Untuk memperbaiki error ini, gunakan akun pengguna administrator yang sama di drive bersama sumber dan tujuan.

`insufficientFilePermissions`

Error ini terjadi saat pengguna tidak memiliki akses tulis ke file, dan aplikasi Anda mencoba mengubah file. Contoh JSON berikut adalah representasi error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "insufficientFilePermissions",
        "message": "The user does not have sufficient permissions for file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user does not have sufficient permissions for file {fileId}."
  }
}

Untuk memperbaiki error ini, minta pengguna menghubungi pemilik file dan meminta akses edit. Anda juga dapat memeriksa tingkat akses pengguna dalam metadata yang diambil oleh metode files.get dan menampilkan UI hanya baca jika izin tidak ada.

`myDriveHierarchyDepthLimitExceeded`

Error myDriveHierarchyDepthLimitExceeded terjadi saat batas untuk jumlah tingkat folder bertingkat telah terlampaui. Drive Saya milik pengguna tidak boleh berisi lebih dari 100 tingkat folder bertingkat. Untuk mengetahui informasi selengkapnya, lihat Batas kedalaman folder.

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "myDriveHierarchyDepthLimitExceeded",
    "message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/workspace/drive/api/guides/handle-errors#nested-folder-levels."
   }
  ],
  "code": 403,
  "message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/workspace/drive/api/guides/handle-errors#nested-folder-levels."
 }
}

Untuk memperbaiki error ini:

Memberi tahu pengguna bahwa Drive mencegah penempatan folder dengan kedalaman lebih dari 100 tingkat.
Jika pengguna harus membuat folder bertingkat lain, minta mereka untuk mengatur ulang folder induk yang diinginkan agar memiliki kedalaman kurang dari 100 tingkat atau menggunakan folder induk lain yang sudah memenuhi persyaratan.

`numChildrenInNonRootLimitExceeded`

Error ini terjadi jika batas jumlah turunan (folder, file, dan pintasan) folder telah terlampaui. Ada batas 500.000 item untuk folder, file, dan pintasan langsung di dalam folder. Item yang berada di subfolder tidak dihitung dalam batas 500.000 item ini. Untuk mengetahui informasi selengkapnya tentang batas folder Drive, lihat Batas folder di Google Drive.

Contoh JSON berikut adalah representasi dari error ini:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "numChildrenInNonRootLimitExceeded",
    "message": "The limit for this folder's number of children (files and folders) has been exceeded."
   }
  ],
  "code": 403,
  "message": "The limit for this folder's number of children (files and folders) has been exceeded."
 }
}

Untuk memperbaiki error ini, coba salah satu langkah berikut:

Memberi tahu pengguna bahwa Drive mencegah folder dengan lebih dari 500.000 item.
Jika pengguna harus menambahkan lebih banyak item ke folder lengkap, beri tahu mereka untuk mengatur ulang folder agar berisi kurang dari 500.000 item atau menggunakan folder serupa yang sudah berisi lebih sedikit item.

`rateLimitExceeded`

Error ini terjadi saat batas frekuensi project telah tercapai. Batas ini berbeda-beda, bergantung pada jenis permintaan. Contoh JSON berikut adalah representasi error ini:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "message": "Rate Limit Exceeded",
    "reason": "rateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}

Untuk memperbaiki error ini, coba salah satu langkah berikut:

Tingkatkan kuota per pengguna di project Google Cloud. Untuk mengetahui informasi selengkapnya, minta penambahan kuota.
Permintaan batch untuk menggabungkan beberapa panggilan API menjadi satu permintaan HTTP.
Gunakan backoff eksponensial untuk mencoba lagi permintaan.

`sharingRateLimitExceeded`

Error ini terjadi saat pengguna mencapai batas berbagi dan sering dikaitkan dengan batas email. Contoh JSON berikut adalah representasi dari error ini:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "Rate limit exceeded. User message: \"These item(s) could not be shared because a rate limit was exceeded: filename",
    "reason": "sharingRateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}

Untuk memperbaiki error ini:

Jangan mengirim email saat berbagi file dalam jumlah besar.
Jika satu pengguna membuat banyak permintaan atas nama banyak pengguna akun Google Workspace, pertimbangkan akun layanan dengan delegasi seluruh domain menggunakan parameter quotaUser.

`storageQuotaExceeded`

Error ini terjadi saat pengguna mencapai batas penyimpanan mereka. Contoh JSON berikut adalah representasi error ini:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "The user's Drive storage quota has been exceeded.",
    "reason": "storageQuotaExceeded",
   }
  ],
  "code": 403,
  "message": "The user's Drive storage quota has been exceeded."
 }
}

Untuk memperbaiki error ini:

Tinjau batas penyimpanan akun Drive Anda. Untuk mengetahui informasi selengkapnya, lihat Batas penyimpanan dan upload Google Workspace.
Mengelola penyimpanan Anda di Drive, Gmail, dan Google Foto.
Membeli penyimpanan Google yang lebih besar.

`teamDriveFileLimitExceeded`

Error ini terjadi saat pengguna mencoba melampaui batas item ketat di drive bersama. Setiap folder di drive bersama pengguna dibatasi menampung 500.000 item, termasuk file, folder, dan pintasan. Batas ini didasarkan pada jumlah item, bukan penggunaan penyimpanan. Untuk mengetahui informasi selengkapnya, lihat Batas drive bersama di Google Drive.

Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveFileLimitExceeded",
        "message": "The file limit for this shared drive has been exceeded."
      }
    ],
    "code": 403,
    "message": "The file limit for this shared drive has been exceeded."
  }
}

Untuk memperbaiki error ini, kurangi jumlah item di drive bersama. Drive bersama yang berisi terlalu banyak file mungkin sulit untuk diatur dan ditelusuri.

`teamDriveHierarchyTooDeep`

Error teamDriveHierarchyTooDeep terjadi jika batas jumlah tingkat folder bertingkat di drive bersama telah terlampaui. Drive bersama pengguna tidak boleh berisi lebih dari 100 tingkat folder bertingkat. Untuk mengetahui informasi selengkapnya, lihat Batas kedalaman folder.

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "teamDriveHierarchyTooDeep",
    "message": "The shared drive hierarchy depth will exceed the limit."
   }
  ],
  "code": 403,
  "message": "The shared drive hierarchy depth will exceed the limit."
 }
}

Untuk memperbaiki error ini:

Memberi tahu pengguna bahwa drive bersama mencegah penempatan folder dengan kedalaman lebih dari 100 tingkat.
Jika pengguna harus membuat folder bertingkat lain, minta mereka untuk mengatur ulang folder induk yang diinginkan agar memiliki kedalaman kurang dari 100 tingkat atau menggunakan folder induk lain yang sudah memenuhi persyaratan.

`teamDriveMembershipRequired`

Error ini terjadi saat pengguna mencoba mengakses drive bersama yang bukan miliknya. Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveMembershipRequired",
        "message": "The attempted action requires shared drive membership."
      }
    ],
    "code": 403,
    "message": "The attempted action requires shared drive membership."
  }
}

Untuk memperbaiki error ini, coba salah satu langkah berikut:

Minta pengelola drive bersama untuk menambahkan Anda dengan izin yang sesuai untuk tindakan yang harus Anda lakukan.
Tinjau peran dan izin Drive untuk mempelajari siapa yang dapat mengakses dan mengelola tim berbagi. Informasi tambahan tentang tingkat akses juga dapat ditemukan di Membuat drive bersama.

`teamDrivesFolderMoveInNotSupported`

Error ini terjadi saat pengguna mencoba memindahkan folder dari Drive Saya ke drive bersama. Contoh JSON berikut adalah representasi error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesFolderMoveInNotSupported",
        "message": "Moving folders into shared drives is not supported."
      }
    ],
    "code": 403,
    "message": "Moving folders into shared drives is not supported."
  }
}

Untuk memperbaiki error ini, coba salah satu langkah berikut:

Pindahkan item individual dari folder ke drive bersama menggunakan Drive API. Tetapkan parameter supportsAllDrives=true untuk menunjukkan dukungan Drive Saya dan drive bersama.
Jika Anda harus memindahkan folder ke drive bersama, gunakan UI Drive. Untuk mengetahui informasi selengkapnya, lihat Memindahkan folder ke drive bersama sebagai admin.

`teamDrivesParentLimit`

Error ini terjadi saat pengguna mencoba menambahkan lebih dari satu induk ke item di drive bersama. Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesParentLimit",
        "message": "A shared drive item must have exactly one parent."
      }
    ],
    "code": 403,
    "message": "A shared drive item must have exactly one parent."
  }
}

Untuk memperbaiki error ini, gunakan pintasan Drive untuk menambahkan beberapa link ke file. Meskipun hanya dapat memiliki satu induk, file pintasan dapat disalin ke lokasi tambahan. Untuk mengetahui informasi selengkapnya, lihat Membuat pintasan ke file Drive.

`UrlLeaseLimitExceeded`

Error ini terjadi saat mencoba menyimpan data game Google Play melalui aplikasi Anda. Contoh JSON berikut adalah representasi dari error ini:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "UrlLeaseLimitExceeded",
    "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
   }
  ],
  "code": 403,
  "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
 }
}

Untuk memperbaiki error ini, selesaikan atau batalkan semua upload untuk snapshot sebelum membuat lebih banyak snapshot.

`userRateLimitExceeded`

Error ini terjadi saat batas per pengguna telah tercapai. Hal ini mungkin merupakan batas dari konsol Google Cloud atau batas dari backend Drive. Contoh JSON berikut adalah representasi dari error ini:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "userRateLimitExceeded",
    "message": "User Rate Limit Exceeded"
   }
  ],
  "code": 403,
  "message": "User Rate Limit Exceeded"
 }
}

Untuk memperbaiki error ini, coba salah satu langkah berikut:

Tingkatkan kuota per pengguna di project Google Cloud. Untuk mengetahui informasi selengkapnya, minta penambahan kuota.
Jika satu pengguna membuat banyak permintaan atas nama banyak pengguna akun Google Workspace, pertimbangkan akun layanan dengan delegasi seluruh domain menggunakan parameter quotaUser.
Gunakan backoff eksponensial untuk mencoba lagi permintaan.

Untuk mengetahui informasi tentang batas Drive API, lihat Batas penggunaan.

Error 404

Error ini berarti bahwa resource yang diminta tidak dapat diakses atau tidak ada.

`notFound`

Error ini terjadi saat pengguna tidak memiliki akses baca ke file, atau file tidak ada. Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "notFound",
        "message": "File not found {fileId}"
      }
    ],
    "code": 404,
    "message": "File not found: {fileId}"
  }
}

Untuk memperbaiki error ini:

Jika file berada di drive bersama, dan Anda menggunakan metode files.get, pastikan parameter kueri supportsAllDrives disetel ke true.
Memberi tahu pengguna bahwa mereka tidak memiliki akses baca ke file atau file tidak ada.
Minta pengguna untuk menghubungi pemilik file dan meminta izin akses ke file tersebut.

Error 429

Error ini berarti terlalu banyak permintaan yang dikirim ke API terlalu cepat.

`rateLimitExceeded`

Error ini terjadi saat pengguna telah mengirim terlalu banyak permintaan dalam jangka waktu tertentu. Contoh JSON berikut adalah representasi dari error ini:

{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "rateLimitExceeded",
        "message": "Rate Limit Exceeded"
      }
    ],
    "code": 429,
    "message": "Rate Limit Exceeded"s
  }
}

Untuk memperbaiki error ini, gunakan backoff eksponensial untuk mencoba ulang permintaan.

Error 500, 502, 503, 504

Error ini terjadi saat terjadi error server yang tidak terduga saat memproses permintaan. Berbagai masalah dapat menyebabkan error ini, termasuk waktu permintaan yang tumpang-tindih dengan permintaan lain atau permintaan untuk tindakan yang tidak didukung, seperti mencoba memperbarui izin untuk satu halaman di Google Sites, bukan seluruh situs.

Berikut adalah daftar error 5xx:

500 Error backend
502 Gateway Buruk
503 Layanan Tidak Tersedia
504 Waktu Tunggu Gateway

Untuk memperbaiki error ini, gunakan backoff eksponensial untuk mencoba ulang permintaan.

Mengatasi error Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Ringkasan kode status HTTP

Error 400

badRequest

illegalKeepForeverModification

invalidSharingRequest

Berbagi berhasil, tetapi email notifikasi tidak terkirim dengan benar

Perubahan ACL tidak diizinkan untuk pengguna ini

Error 401

authError

fileNotDownloadable

Error 403

activeItemCreationLimitExceeded

appNotAuthorizedToFile

cannotModifyInheritedTeamDrivePermission

dailyLimitExceeded

domainPolicy

downloadRestrictedForRevision

fileOwnerNotMemberOfTeamDrive

fileWriterTeamDriveMoveInDisabled

insufficientFilePermissions

myDriveHierarchyDepthLimitExceeded

numChildrenInNonRootLimitExceeded

rateLimitExceeded

sharingRateLimitExceeded

storageQuotaExceeded

teamDriveFileLimitExceeded

teamDriveHierarchyTooDeep

teamDriveMembershipRequired

teamDrivesFolderMoveInNotSupported

teamDrivesParentLimit

UrlLeaseLimitExceeded

userRateLimitExceeded

Error 404

notFound

Error 429

rateLimitExceeded

Error 500, 502, 503, 504

Topik terkait

Mengatasi error

`badRequest`

`illegalKeepForeverModification`

`invalidSharingRequest`

`authError`

`fileNotDownloadable`

`activeItemCreationLimitExceeded`

`appNotAuthorizedToFile`

`cannotModifyInheritedTeamDrivePermission`

`dailyLimitExceeded`

`domainPolicy`

`downloadRestrictedForRevision`

`fileOwnerNotMemberOfTeamDrive`

`fileWriterTeamDriveMoveInDisabled`

`insufficientFilePermissions`

`myDriveHierarchyDepthLimitExceeded`

`numChildrenInNonRootLimitExceeded`

`rateLimitExceeded`

`sharingRateLimitExceeded`

`storageQuotaExceeded`

`teamDriveFileLimitExceeded`

`teamDriveHierarchyTooDeep`

`teamDriveMembershipRequired`

`teamDrivesFolderMoveInNotSupported`

`teamDrivesParentLimit`

`UrlLeaseLimitExceeded`

`userRateLimitExceeded`

`notFound`

`rateLimitExceeded`