Pesan error

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

  1. MOVED_PERMANENTLY (301)
  2. SEE_OTHER (303)
  3. NOT_MODIFIED (304)
  4. TEMPORARY_REDIRECT (307)
  5. BAD_REQUEST (400)
  6. TIDAK SAH (401)
  7. PAYMENT_REQUIRED (402)
  8. DILARANG (403)
  9. TIDAK_DITEMUKAN (404)
  10. METODE_TIDAK_DIIZINKAN (405)
  11. KONFLIK (409)
  12. TIDAK ADA (410)
  13. PRECONDITION_FAILED (412)
  14. REQUEST_ENTITY_TOO_LARGE (413)
  15. DIMINTA_RANGE_NOT_SATISFIABLE (416)
  16. EXPECTATION_FAILED (417)
  17. PRECONDITION_REQUIRED (428)
  18. Terlalu banyak permintaan (429)
  19. INTERNAL_SERVER_ERROR (500)
  20. TIDAK_TERAPKAN (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 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.
invalidHeader Permintaan gagal karena memuat header yang tidak valid.
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.