Dokumen ini mengidentifikasi beberapa kode dan pesan 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)
- TIDAK SAH (401)
- PAYMENT_REQUIRED (402)
- DILARANG (403)
- TIDAK_DITEMUKAN (404)
- METODE_TIDAK_DIIZINKAN (405)
- KONFLIK (409)
- TIDAK ADA (410)
- PRECONDITION_FAILED (412)
- REQUEST_ENTITY_TOO_LARGE (413)
- DIMINTA_RANGE_NOT_SATISFIABLE (416)
- EXPECTATION_FAILED (417)
- PRECONDITION_REQUIRED (428)
- Terlalu banyak permintaan (429)
- INTERNAL_SERVER_ERROR (500)
- TIDAK_TERAPKAN (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 dalam header Location respons ini, bukan ke URL yang dikirimi permintaan ini. |
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 . |
REDIRECT_TEMPORARY (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 bagian dari permintaan multibagian tidak didukung. |
badLockedDomainRequest |
Permintaan domain yang dikunci tidak valid. |
corsRequestWithXOrigin |
Permintaan CORS berisi header XD3 X-Origin, yang menunjukkan permintaan CORS yang buruk. |
endpointConstraintMismatch |
Permintaan gagal karena tidak cocok dengan API yang ditentukan. Periksa nilai jalur URL untuk memastikan nilainya benar. |
invalid |
Permintaan gagal karena berisi nilai yang tidak valid. Nilai dapat berupa nilai parameter, nilai header, atau nilai properti. |
invalidAltValue |
Nilai parameter alt menentukan format output yang tidak diketahui. |
invalidParameter |
Permintaan gagal karena berisi parameter atau nilai parameter yang tidak valid. Tinjau dokumentasi API untuk 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 berisi kombinasi parameter yang tidak valid atau nilai parameter 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 informasi selengkapnya atau untuk mendapatkan kunci baru. |
keyInvalid |
Kunci API yang disediakan 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 Anda atau mendapatkannya. |
lockedDomainCreationFailure |
Token OAuth diterima dalam string kueri, yang dilarang oleh API ini untuk format respons selain JSON atau XML. Jika memungkinkan, coba kirimkan token OAuth di header Otorisasi. |
notDownload |
Hanya permintaan download media yang dapat dikirim ke jalur URL /download/* . Kirim ulang permintaan ke jalur 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 memiliki 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 dikenal. |
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 jalur yang sama, tetapi dengan awalan /upload . |
TIDAK SAH (401)
Kode error |
Deskripsi |
unauthorized |
Pengguna tidak diizinkan membuat permintaan. |
authError |
Kredensial otorisasi yang diberikan 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 kuota. Diperlukan pembayaran untuk menyelesaikan operasi ini. |
user402 |
Operasi yang diminta memerlukan pembayaran dari pengguna terautentikasi. |
DILARANG (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. Lihat 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. |
dailyLimitExceededUnreg |
Permintaan gagal karena batas harian untuk penggunaan API tanpa autentikasi 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 yang diautentikasi tidak memiliki izin yang memadai untuk mengeksekusi permintaan ini. |
limitExceeded |
Permintaan tidak dapat diselesaikan karena pembatasan akses atau kapasitas. |
lockedDomainForbidden |
API ini tidak mendukung domain terkunci. |
quotaExceeded |
Operasi yang diminta memerlukan lebih banyak resource daripada yang diizinkan kuota. |
rateLimitExceeded |
Terlalu banyak permintaan yang dikirim dalam rentang waktu yang ditentukan. |
rateLimitExceededUnreg |
Batas kapasitas telah terlampaui dan Anda harus mendaftarkan aplikasi agar dapat terus memanggil API. Mendaftar menggunakan Google Developers Console. |
responseTooLarge |
Resource yang diminta terlalu besar untuk ditampilkan. |
servingLimitExceeded |
Batas kapasitas keseluruhan yang ditentukan untuk API telah tercapai. |
sslRequired |
SSL diperlukan untuk melakukan operasi ini. |
unknownAuth |
Server API tidak mengenali skema otorisasi yang digunakan untuk permintaan tersebut. 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 diidentifikasi dalam permintaan. Harap gunakan Google Developers Console (https://console.developers.google.com) untuk membuat project 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. |
TIDAK_DITEMUKAN (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, deploy ulang aplikasi App Engine dan coba panggil lagi. |
unsupportedProtocol |
Protokol yang digunakan dalam permintaan tidak didukung. |
METODE_TIDAK_DIIZINKAN (405)
Kode error |
Deskripsi |
httpMethodNotAllowed |
Metode HTTP yang terkait dengan permintaan tidak didukung. |
KONFLIK (409)
Kode error |
Deskripsi |
conflict |
Permintaan API tidak dapat diselesaikan karena operasi yang diminta akan bertentangan dengan item yang sudah ada. Misalnya, permintaan yang mencoba membuat item duplikat akan menimbulkan konflik, meskipun item duplikat biasanya diidentifikasi dengan error yang lebih spesifik. |
duplicate |
Operasi yang diminta gagal karena mencoba membuat resource yang sudah ada. |
PERGI (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 dalam 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 berisi terlalu banyak elemen. |
uploadTooLarge |
Permintaan gagal karena data yang dikirim dalam permintaan terlalu besar. |
DIMINTA_RANGE_TIDAK_SATISFIABLE (416)
Kode error |
Deskripsi |
requestedRangeNotSatisfiable |
Permintaan menentukan rentang yang tidak dapat dipenuhi. |
{i>EXPECTATION_FAILED<i} (417)
Kode error |
Deskripsi |
expectationFailed |
Ekspektasi klien tidak dapat dipenuhi oleh server. |
PRECONDITION_REQUIRED (428)
Kode error |
Deskripsi |
preconditionRequired |
Permintaan memerlukan prasyarat yang tidak diberikan. Agar permintaan ini berhasil, Anda harus menyertakan header If-Match atau If-None-Match dengan permintaan ini. |
TOO_MANY_ Update (429)
Kode error |
Deskripsi |
rateLimitExceeded |
Terlalu banyak permintaan yang dikirim dalam rentang waktu yang ditentukan. |
INTERNAL_SERVER_ERROR (500)
Kode error |
Deskripsi |
internalError |
Permintaan gagal karena error internal. |
TIDAK_TERTERAPKAN (501)
Kode error |
Deskripsi |
notImplemented |
Operasi yang diminta belum diimplementasikan. |
unsupportedMethod |
Permintaan gagal karena mencoba mengeksekusi metode atau operasi yang tidak diketahui. |
SERVICE_UNAVAILABLE (503)
Kode error |
Deskripsi |
backendError |
Terjadi error backend. |
backendNotConnected |
Permintaan gagal karena terjadi error koneksi. |
notReady |
Server API belum siap menerima permintaan. |