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
- MOVED_PERMANENTLY (301)
- SEE_OTHER (303)
- NOT_MODIFIED (304)
- TEMPORARY_REDIRECT (307)
- BAD_REQUEST (400)
- UNAUTHORIZED (401)
- PAYMENT_REQUIRED (402)
- FORBIDDEN (403)
- NOT_FOUND (404)
- METHOD_NOT_ALLOWED (405)
- CONFLICT (409)
- GONE (410)
- PRECONDITION_FAILED (412)
- REQUEST_ENTITY_TOO_LARGE (413)
- REQUESTED_RANGE_NOT_SATISFIABLE (416)
- EXPECTATION_FAILED (417)
- PRECONDITION_REQUIRED (428)
- TOO_MANY_REQUESTS (429)
- INTERNAL_SERVER_ERROR (500)
- NOT_IMPLEMENTED (501)
- 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 nilainya sudah benar. |
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. |
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 selengkapnya atau memperoleh kunci baru. |
keyInvalid |
Kunci API yang diberikan dalam permintaan tidak valid, sehingga server API tidak dapat memeriksa batas kuota untuk aplikasi yang membuat permintaan tersebut. Gunakan Google Developers Console untuk menemukan kunci API atau mendapatkan kunci baru. |
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 dalam header Otorisasi. |
notDownload |
Hanya permintaan download media yang dapat dikirim ke jalur URL /download/* . Kirim ulang permintaan ke lokasi yang sama, tetapi 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 jalur yang sama, tetapi 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, tetapi 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 Konsol Google Developers untuk mengaktifkan API project Anda. |
accessNotConfigured |
Project telah diblokir karena terjadi penyalahgunaan. Lihat http://support.google.com/code/go/developer_compliance. |
accessNotConfigured |
Project telah 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 Konsol Google Developers. |
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 tercapai dan Anda harus mendaftarkan aplikasi agar dapat terus memanggil API ini. Daftar 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 Developers Console (https://console.developers.google.com) guna membuat project untuk 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 mengetahui detailnya. 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. |