Hata yanıtları

Bir API isteği başarılı olduğunda API, yanıt gövdesinde istenen verilerle birlikte 200 OK durum kodunu döndürür. Bir hata oluşursa API, Google API'leri tarafından tanımlanan, HTTP durum koduyla eşlenmiş kanonik hata kodlarından birini ve hata bilgilerini içeren bir yanıt gövdesini döndürür. Bir hatayla karşılaştığınızda hata ayıklamaya yardımcı olacak ayrıntılar için JSON yanıt gövdesindeki message ve status alanlarını inceleyin.

Hata biçimi

Bir istek hatayla sonuçlanırsa API, uygun bir HTTP durum kodu ve bir JSON yanıt gövdesi döndürür. Hata yanıtı, aşağıdaki yapıya sahip bir error nesnesi içerir:

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

error nesnesi şu alanları içerir:

Alan Açıklama
code 400, 401, 403, 429 veya 500 gibi HTTP durum kodu.
message Hatayla ilgili kısa bir açıklama.
status INVALID_ARGUMENT, UNAUTHENTICATED, PERMISSION_DENIED, RESOURCE_EXHAUSTED veya INTERNAL gibi standart hata kodu.

Sık karşılaşılan hatalar

Aşağıdaki tabloda, API tarafından döndürülen yaygın hatalar listelenmiştir.

HTTP Durum Kodu Standart Kod Neden Açıklama
400 INVALID_ARGUMENT Hatalı İstek İstek yanlış biçimlendirilmiş. Bu durum, yanlış tarih aralığı veya hatalı biçimlendirilmiş filtre gibi eksik ya da geçersiz parametrelerden kaynaklanabilir.
401 UNAUTHENTICATED Geçersiz Kimlik Bilgileri İstek, hedef kaynak için geçerli kimlik doğrulama bilgilerine sahip değil. Bu durum, OAuth 2.0 erişim jetonu eksikse, geçersizse veya süresi dolmuşsa meydana gelebilir. Geçerli bir jeton almak için OAuth 2.0 ile kimlik doğrulama bölümündeki talimatları uygulayın.
403 PERMISSION_DENIED Yetersiz İzinler Kimliği doğrulanmış kullanıcının, istenen Google Analytics mülküne erişimi yok.
429 RESOURCE_EXHAUSTED Kota Aşıldı API kota sınırlarına ulaşıldığından istek reddedildi. Daha fazla bilgi için Data API sınırları ve kotaları başlıklı makaleyi inceleyin. Proje başına veya mülk başına sınırları aşıyor olabilirsiniz.
500 INTERNAL Dahili Sunucu Hatası Beklenmeyen bir sunucu hatası oluştu. Bu durum genellikle geçicidir. İsteği eksponansiyel geri yükleme ile yeniden denemeniz önerilir. Sunucu hatası kotalarını aşmamak için yeniden deneme sınırlarıyla eksponansiyel geri yükleme uygulamak önemlidir.
503 UNAVAILABLE Hizmet Kullanılamıyor Hizmet geçici olarak kullanılamıyor. Bu durum genellikle geçicidir. İsteği eksponansiyel geri yükleme ile yeniden denemeniz önerilir. Sunucu hatası kotalarını aşmamak için yeniden deneme sınırlarıyla eksponansiyel geri yükleme uygulamak önemlidir.