Respons Error

Jika permintaan API berhasil, API akan menampilkan kode status 200 OK beserta data yang diminta dalam isi respons. Jika terjadi error, API akan menampilkan salah satu kode error kanonis yang ditentukan oleh Google API, yang dipetakan ke kode status HTTP, dan isi respons yang berisi informasi error. Saat menemukan error, periksa kolom message dan status di isi respons JSON untuk mengetahui detail spesifik yang dapat membantu proses debug.

Format error

Jika permintaan menghasilkan error, API akan menampilkan kode status HTTP yang sesuai dan isi respons JSON. Respons error berisi objek error dengan struktur berikut:

{
  "error": {
    "code": 403,
    "message": "User does not have sufficient permissions for this property.",
    "status": "PERMISSION_DENIED"
  }
}

Objek error berisi kolom berikut:

Kolom	Deskripsi
kode	Kode status HTTP, seperti 400, 401, 403, 429, atau 500.
message	Keterangan singkat mengenai kesalahan.
status	Kode error kanonis, seperti INVALID_ARGUMENT, UNAUTHENTICATED, PERMISSION_DENIED, RESOURCE_EXHAUSTED, atau INTERNAL.

Error yang biasa terjadi

Tabel berikut mencantumkan error umum yang ditampilkan oleh API.

Kode Status HTTP	Kode Kanonis	Alasan	Deskripsi
400	INVALID_ARGUMENT	Permintaan Tidak Valid	Permintaan salah format. Hal ini dapat disebabkan oleh parameter yang tidak ada atau tidak valid, seperti rentang tanggal yang salah atau filter yang salah format.
401	UNAUTHENTICATED	Kredensial Tidak Valid	Permintaan tidak memiliki kredensial autentikasi yang valid untuk resource target. Hal ini dapat terjadi jika token akses OAuth 2.0 tidak ada, tidak valid, atau sudah tidak berlaku. Ikuti petunjuk di Mengautentikasi dengan OAuth 2.0 untuk mendapatkan token yang valid.
403	PERMISSION_DENIED	Izin Tidak Memadai	Pengguna yang diautentikasi tidak memiliki akses ke properti Google Analytics yang diminta.
429	RESOURCE_EXHAUSTED	Melebihi Kuota	Permintaan ditolak karena batas kuota API telah tercapai. Lihat Batas dan kuota Data API untuk mengetahui informasi selengkapnya. Anda mungkin melampaui batas per project atau per properti.
500	INTERNAL	Kesalahan Server Internal	Terjadi error server yang tidak terduga. Masalah ini biasanya bersifat sementara. Sebaiknya coba lagi permintaan dengan backoff eksponensial. Untuk menghindari terlampauinya kuota error server, penting untuk menerapkan backoff eksponensial dengan batas percobaan ulang.
503	UNAVAILABLE	Layanan Tidak Tersedia	Layanan ini untuk sementara tidak tersedia. Masalah ini biasanya bersifat sementara. Sebaiknya coba lagi permintaan dengan backoff eksponensial. Untuk menghindari terlampauinya kuota error server, penting untuk menerapkan backoff eksponensial dengan batas percobaan ulang.