Respons Error Standar

Dokumen ini mengidentifikasi beberapa pesan dan kode error yang ditampilkan Google API. Secara khusus, error yang tercantum di sini berada di domain global, atau default, untuk Google API. Banyak API juga menentukan domainnya sendiri, yang mengidentifikasi error khusus API yang tidak berada di domain global. Untuk error tersebut, nilai properti domain dalam respons JSON akan menjadi nilai khusus API, seperti youtube.parameter.

Halaman ini mencantumkan error berdasarkan kode status HTTP-nya seperti yang ditetapkan dalam RFC 7231.

Contoh respons JSON di bawah ini menunjukkan bagaimana error global dikomunikasikan:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "invalidParameter",
    "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]",
    "locationType": "parameter",
    "location": "chart"
   }
  ],
  "code": 400,
  "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]"
 }
}

Error

  1. MOVED_PERMANENTLY (301)
  2. SEE_OTHER (303)
  3. NOT_MODIFIED (304)
  4. TEMPORARY_REDIRECT (307)
  5. BAD_REQUEST (400)
  6. UNAUTHORIZED (401)
  7. PAYMENT_REQUIRED (402)
  8. FORBIDDEN (403)
  9. NOT_FOUND (404)
  10. METHOD_NOT_ALLOWED (405)
  11. CONFLICT (409)
  12. GONE (410)
  13. PRECONDITION_FAILED (412)
  14. REQUEST_ENTITY_TOO_LARGE (413)
  15. REQUESTED_RANGE_NOT_SATISFIABLE (416)
  16. EXPECTATION_FAILED (417)
  17. PRECONDITION_REQUIRED (428)
  18. TOO_MANY_REQUESTS (429)
  19. INTERNAL_SERVER_ERROR (500)
  20. NOT_IMPLEMENTED (501)
  21. SERVICE_UNAVAILABLE (503)

MOVED_PERMANENTLY (301)

Kode error Deskripsi
movedPermanently Permintaan ini dan permintaan selanjutnya untuk operasi yang sama harus dikirim ke URL yang ditentukan pada header Location respons ini, bukan ke URL yang dikirimi permintaan.

SEE_OTHER (303)

Kode error Deskripsi
seeOther Permintaan Anda berhasil diproses. Untuk mendapatkan respons, kirim permintaan GET ke URL yang ditentukan pada header Location.
mediaDownloadRedirect Permintaan Anda berhasil diproses. Untuk mendapatkan respons, kirim permintaan GET ke URL yang ditentukan pada header Location.

NOT_MODIFIED (304)

Kode error Deskripsi
notModified Kondisi yang ditetapkan untuk header If-None-Match tidak terpenuhi. Respons ini menunjukkan bahwa dokumen yang diminta belum dimodifikasi, dan respons yang di-cache harus diambil. Periksa nilai header permintaan HTTP If-None-Match.

TEMPORARY_REDIRECT (307)

Kode error Deskripsi
temporaryRedirect Agar permintaan Anda diproses, kirim ulang permintaan tersebut ke URL yang ditentukan pada header Location respons ini.

BAD_REQUEST (400)

Kode error Deskripsi
badRequest Permintaan API tidak valid atau tidak diformat dengan benar. Akibatnya, server API tidak dapat memahami permintaan tersebut.
badBinaryDomainRequest Permintaan domain biner tidak valid.
badContent Jenis konten data permintaan atau jenis konten untuk suatu bagian dari permintaan multibagian tidak didukung.
badLockedDomainRequest Permintaan domain yang terkunci tidak valid.
corsRequestWithXOrigin Permintaan CORS berisi header XD3 X-Origin, yang menunjukkan permintaan CORS yang salah.
endpointConstraintMismatch Permintaan gagal karena tidak cocok dengan API yang ditentukan. Periksa nilai jalur URL untuk memastikan akurasinya.
invalid Permintaan gagal karena memuat nilai yang tidak valid. Nilai dapat berupa parameter value, nilai header, atau nilai properti.
invalidAltValue Parameter value alt menentukan format output yang tidak dikenal.
invalidHeader Permintaan gagal karena memuat header yang tidak valid.
invalidParameter Permintaan gagal karena memuat parameter atau parameter value yang tidak valid. Tinjau dokumentasi API guna menentukan parameter yang valid untuk permintaan Anda.
invalidQuery Permintaan tidak valid. Periksa dokumentasi API untuk mengetahui parameter yang didukung untuk permintaan tersebut, dan melihat apakah permintaan itu memuat kombinasi beberapa parameter yang tidak valid atau satu parameter value yang tidak valid. Periksa nilai untuk parameter permintaan q.
keyExpired Kunci API yang diberikan dalam permintaan sudah tidak berlaku, sehingga server API tidak dapat memeriksa batas kuota untuk aplikasi yang membuat permintaan tersebut. Periksa Google Developers Console untuk mendapatkan informasi lebih lanjut atau memperoleh kunci baru.
keyInvalid Kunci API yang diberikan dalam permintaan tidak valid, yang berarti server API tidak dapat memeriksa batas kuota untuk aplikasi yang membuat permintaan tersebut. Gunakan Google Developers Console untuk menemukan kunci API atau untuk mendapatkannya.
lockedDomainCreationFailure Token OAuth diterima dalam string kueri, yang dilarang oleh API ini untuk format respons selain JSON atau XML. Jika memungkinkan, coba kirim token OAuth sebagai gantinya ke header Otorisasi.
notDownload Hanya permintaan download media yang dapat dikirim ke jalur URL /download/*. Kirim ulang permintaan ke lokasi yang sama, tapi tanpa awalan /download.
notUpload Permintaan gagal karena bukan merupakan permintaan upload, dan hanya permintaan upload yang dapat dikirim ke URI /upload/*. Coba kirim ulang permintaan ke lokasi yang sama, tapi tanpa awalan /upload.
parseError Server API tidak dapat mengurai isi permintaan.
required Permintaan API tidak berisi informasi yang diperlukan. Informasi yang diperlukan dapat berupa parameter atau properti resource.
tooManyParts Permintaan multibagian gagal karena berisi terlalu banyak bagian.
unknownApi API yang dipanggil oleh permintaan tidak dikenali.
unsupportedMediaProtocol Klien menggunakan protokol media yang tidak didukung.
unsupportedOutputFormat Parameter value alt menentukan format output yang tidak didukung untuk layanan ini. Periksa nilai untuk parameter permintaan alt.
wrongUrlForUpload Permintaan ini merupakan permintaan upload, tetapi gagal karena tidak dikirim ke URI yang tepat. Permintaan upload harus dikirim ke URI yang berisi awalan /upload/*. Coba kirim ulang permintaan ke lokasi yang sama, tapi dengan awalan /upload.

UNAUTHORIZED (401)

Kode error Deskripsi
unauthorized Pengguna tidak diizinkan untuk membuat permintaan.
authError Kredensial otorisasi yang disediakan untuk permintaan tidak valid. Periksa nilai header permintaan HTTP Authorization.
expired Sesi Berakhir. Periksa nilai header permintaan HTTP Authorization.
lockedDomainExpired Permintaan gagal karena domain terkunci yang sebelumnya valid sudah tidak berlaku.
required Pengguna harus login untuk membuat permintaan API ini. Periksa nilai header permintaan HTTP Authorization.

PAYMENT_REQUIRED (402)

Kode error Deskripsi
dailyLimitExceeded402 Batas anggaran harian yang ditetapkan oleh developer telah tercapai.
quotaExceeded402 Operasi yang diminta memerlukan lebih banyak resource daripada yang diizinkan oleh kuota. Diperlukan pembayaran untuk menyelesaikan operasi.
user402 Operasi yang diminta memerlukan pembayaran dari pengguna yang terautentikasi.

FORBIDDEN (403)

Kode error Deskripsi
forbidden Operasi yang diminta dilarang dan tidak dapat diselesaikan.
accessNotConfigured Project Anda tidak dikonfigurasi untuk mengakses API ini. Gunakan Google Developers Console untuk mengaktifkan API project Anda.
accessNotConfigured Project telah diblokir karena terjadi penyalahgunaan. Buka http://support.google.com/code/go/developer_compliance.
accessNotConfigured Project ditandai untuk dihapus.
accountDeleted Akun pengguna yang terkait dengan kredensial otorisasi permintaan telah dihapus. Periksa nilai header permintaan HTTP Authorization.
accountDisabled Akun pengguna yang terkait dengan kredensial otorisasi permintaan telah dinonaktifkan. Periksa nilai header permintaan HTTP Authorization.
accountUnverified Alamat email pengguna yang membuat permintaan belum diverifikasi. Periksa nilai header permintaan HTTP Authorization.
concurrentLimitExceeded Permintaan gagal karena batas penggunaan serentak telah tercapai.
dailyLimitExceeded Batas kuota harian untuk API telah tercapai.
dailyLimitExceeded Batas kuota harian telah tercapai, dan project diblokir karena terjadi penyalahgunaan. Lihat Formulir dukungan kepatuhan Google API untuk membantu menyelesaikan masalah ini.
dailyLimitExceededUnreg Permintaan gagal karena batas harian untuk penggunaan API tak terautentikasi telah tercapai. Untuk terus menggunakan API ini, pengguna harus mendaftar melalui Google Developers Console.
downloadServiceForbidden API tidak mendukung layanan download.
insufficientAudience Permintaan tidak dapat diselesaikan untuk audiens ini.
insufficientAuthorizedParty Permintaan tidak dapat diselesaikan untuk aplikasi ini.
insufficientPermissions Pengguna terautentikasi tidak memiliki izin yang memadai untuk mengeksekusi permintaan ini.
limitExceeded Permintaan tidak dapat diselesaikan karena adanya pembatasan kapasitas atau akses.
lockedDomainForbidden API ini tidak mendukung domain terkunci.
quotaExceeded Operasi yang diminta memerlukan lebih banyak resource daripada yang diizinkan oleh kuota.
rateLimitExceeded Terlalu banyak permintaan yang dikirim dalam jangka waktu yang diberikan.
rateLimitExceededUnreg Batas kapasitas telah terlampaui dan Anda harus mendaftarkan aplikasi agar dapat terus memanggil API ini. Lakukan pendaftaran menggunakan Google Developers Console.
responseTooLarge Resource yang diminta terlalu besar untuk ditampilkan.
servingLimitExceeded Batas kapasitas keseluruhan yang ditentukan untuk API ini telah tercapai.
sslRequired SSL diperlukan untuk menjalankan operasi ini.
unknownAuth Server API tidak mengenali skema otorisasi yang digunakan untuk permintaan ini. Periksa nilai header permintaan HTTP Authorization.
userRateLimitExceeded Permintaan gagal karena batas kapasitas per pengguna telah tercapai.
userRateLimitExceededUnreg Permintaan gagal karena batas kapasitas per pengguna telah tercapai, dan developer klien tidak teridentifikasi dalam permintaan. Gunakan Google Developer Console (https://console.developers.google.com) untuk membuat project bagi aplikasi Anda.
variableTermExpiredDailyExceeded Permintaan gagal karena kuota periode variabel sudah tidak berlaku dan batas harian tercapai.
variableTermLimitExceeded Permintaan gagal karena batas kuota periode variabel tercapai.

NOT_FOUND (404)

Kode error Deskripsi
notFound Operasi yang diminta gagal karena resource yang terkait dengan permintaan tidak dapat ditemukan.
notFound Resource yang terkait dengan permintaan tidak dapat ditemukan. Jika Anda belum menggunakan API ini dalam dua minggu terakhir, terapkan kembali aplikasi App Engine, lalu coba panggil API ini lagi.
unsupportedProtocol Protokol yang digunakan dalam permintaan tidak didukung.

METHOD_NOT_ALLOWED (405)

Kode error Deskripsi
httpMethodNotAllowed Metode HTTP yang terkait dengan permintaan tidak didukung.

CONFLICT (409)

Kode error Deskripsi
conflict Permintaan API tidak dapat diselesaikan karena operasi yang diminta akan bentrok dengan item yang ada. Misalnya, permintaan yang mencoba membuat item duplikat akan menimbulkan bentrok, meskipun item duplikat biasanya diidentifikasi dengan error yang lebih spesifik.
duplicate Operasi yang diminta gagal karena mencoba membuat resource yang sudah ada.

GONE (410)

Kode error Deskripsi
deleted Permintaan gagal karena resource yang terkait dengan permintaan telah dihapus

PRECONDITION_FAILED (412)

Kode error Deskripsi
conditionNotMet Kondisi yang ditetapkan di header permintaan HTTP If-Match atau If-None-Match permintaan tidak terpenuhi. Lihat bagian ETag pada spesifikasi HTTP untuk informasi selengkapnya. Periksa nilai header permintaan HTTP If-Match.

REQUEST_ENTITY_TOO_LARGE (413)

Kode error Deskripsi
backendRequestTooLarge Permintaan terlalu besar.
batchSizeTooLarge Permintaan batch memuat terlalu banyak elemen.
uploadTooLarge Permintaan gagal karena data yang dikirim dalam permintaan terlalu besar.

REQUESTED_RANGE_NOT_SATISFIABLE (416)

Kode error Deskripsi
requestedRangeNotSatisfiable Permintaan menetapkan rentang yang tidak dapat dipenuhi.

EXPECTATION_FAILED (417)

Kode error Deskripsi
expectationFailed Ekspektasi klien tidak dapat dipenuhi oleh server.

PRECONDITION_REQUIRED (428)

Kode error Deskripsi
preconditionRequired Permintaan memerlukan prasyarat yang tidak disediakan. Agar permintaan ini berhasil, Anda harus menyertakan header If-Match atau If-None-Match dengan permintaan ini.

TOO_MANY_REQUESTS (429)

Kode error Deskripsi
rateLimitExceeded Terlalu banyak permintaan yang dikirim dalam jangka waktu yang diberikan.

INTERNAL_SERVER_ERROR (500)

Kode error Deskripsi
internalError Permintaan gagal karena error internal.

NOT_IMPLEMENTED (501)

Kode error Deskripsi
notImplemented Operasi yang diminta belum diimplementasikan.
unsupportedMethod Permintaan gagal karena mencoba menjalankan metode atau operasi yang tidak dikenal.

SERVICE_UNAVAILABLE (503)

Kode error Deskripsi
backendError Terjadi error backend.
backendNotConnected Permintaan gagal karena terjadi error koneksi.
notReady Server API belum siap menerima permintaan.