Hata yanıtları

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 standart hata kodlarından birini (bir HTTP durum koduna eşlenmiş) ve hata bilgilerini içeren bir yanıt gövdesi 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 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 HTTP durum kodu (ör. 400, 401, 403, 429 veya 500).
message Hatanın kısa bir açıklaması.
status Standart hata kodu (ör. INVALID_ARGUMENT, UNAUTHENTICATED, PERMISSION_DENIED, RESOURCE_EXHAUSTED veya INTERNAL).

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 İstekte, hedef kaynak için geçerli kimlik doğrulama bilgileri yok. Bu durum, OAuth 2.0 erişim jetonunun eksik, geçersiz veya süresinin dolmuş olmasından kaynaklanabilir. 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ığı için istek reddedildi. Daha fazla bilgi için Data API sınırları ve kotaları başlıklı makaleyi inceleyin. Proje veya mülk başına sınırları aşıyor olabilirsiniz.
500 INTERNAL Dahili Sunucu Hatası Beklenmeyen bir sunucu hatası oluştu. Bu genellikle geçici bir sorundur. İsteği eksponansiyel geri yükleme ile yeniden denemeniz önerilir. Sunucu hatası kotalarını aşmamak için yeniden deneme sınırları ile eksponansiyel geri yükleme uygulamak önemlidir.
503 UNAVAILABLE Hizmet Kullanılamıyor Hizmet geçici olarak kullanılamamaktadır. Bu genellikle geçici bir sorundur. İsteği eksponansiyel geri yükleme ile yeniden denemeniz önerilir. Sunucu hatası kotalarını aşmamak için yeniden deneme sınırları ile eksponansiyel geri yükleme uygulamak önemlidir.