API İstekleriyle İlgili Sınırlar ve Kotalar

Bu belgede, Management API'leri ve Reporting API'leri istemeyle ilgili sınırlar ve kotalar açıklanmaktadır.

Google Analytics milyonlarca site tarafından kullanılmaktadır. Sistemin işleyebileceğinden daha fazla veri almasını önlemek ve sistem kaynaklarının adil bir şekilde dağıtılmasını sağlamak için API isteklerine sınırlar ve kotalar uygularız. Sınırlar ve kotalar değişikliğe tabidir.

Bu videoda, Google Analytics API istek kotalarını yönetmeyle ilgili en iyi uygulamalar anlatılmaktadır.

Genel kota sınırları

Aşağıdaki kotalar Management API, Core Reporting API v3, MCF Reporting API, Metadata API, User Deletion API ve Real Time Reporting API için geçerlidir:

  • Proje başına günde 50.000 istek (artırılabilir.
  • IP adresi başına saniyede 10 sorgu (QPS).
    • API Konsolu'nda, Kullanıcı başına 100 saniyedeki istek sayısı adlı benzer bir kota vardır. Varsayılan olarak, kullanıcı başına 100 saniyede 100 istek şeklinde belirlenmiştir ve maksimum 1.000 değerine ayarlanabilir. Ancak API'ye gönderilen isteklerin sayısı, kullanıcı başına saniyede maksimum 10 istekle sınırlandırılmıştır.
    • Uygulamanız tüm API isteklerini tek bir IP adresinden yapıyorsa (ör. kullanıcılarınız adına) her kullanıcı için tam QPS kotası almak üzere her istekte userIP veya quotaUser parametresini kullanın. Ayrıntılar için standart sorgu parametreleri özetine bakın.

Yönetim API'leri

Google Analytics, aşağıdaki Management API'lerine yapılan isteklere kota uygular:

Yazma API'leri

Bu kotalar, yazma (insert, update, patch ve delete) istekleri için geçerlidir:

  • Proje başına günde 50 yazma isteği (artırılabilir)
  • Hesap Kimliği başına saniyede 1,5 sorgu (QPS)

Yazma isteği hataları

Yazma isteğiniz başarısız olursa ve 500 veya 503 yanıt kodu alırsanız isteği yeniden gönderebilirsiniz. Google Analytics sayesinde şunlara izin verilir:

  • Saat başına 50 başarısız yazma isteği.

Saat başına 50'den fazla başarısız yazma isteği göndermeye çalışırsanız şu hatayı alırsınız:

Quota Error: The number of recent failed writes is too high.

Başarısız bir yazma isteğini sürekli olarak yeniden göndermek yerine yeniden göndermek için eksponansiyel geri yükleme uygulayın.

Verileri İçe Aktarma API'sı

Bu kotalar Uploads kaynağına özeldir:

  • Ömür Boyu Genişletilmiş Verileri İçe Aktarma depolama alanı sınırları (Koleksiyon API'leri ve SDK'larından gönderilen isabet verileri için geçerli değildir):
  • Mülk başına 50 Veri Kümesi
  • Mülk başına günde 50 yükleme işlemi
  • Yüklenen dosya başına 1 GB
  • Maliyet Verilerine özel sınırlar:
    • Veri kümesi başına tarih (ga:date) başına 100 MB. Örneğin, bir yüklemede 2014-10-10 için 50 MB'lık, ikinci bir yüklemede ise 50 MB'lık veri içe aktarıyorsanız, söz konusu veri kümesi için 2014-10-10 aralığı için 100 MB sınırına ulaşmışsınızdır.

Denemeler API'sı

Bu kota yalnızca Denemeler için geçerlidir:

  • Görünüm (profil) başına 12 deneme

Aşağıdaki statuseslardan birine sahip denemeler bu kotaya dahil edilir:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

Bir günden uzun süren denemeler (durum = ENDED) bu kotaya dahil edilmez.

Örneklenmemiş Raporlar API'si

Bu kotalar yalnızca Örneklenmemiş Raporlar için geçerlidir:

  • Örneklenmemiş raporlar oluşturmaya yönelik API istekleri, genel Yazma İstekleri kotasına dahil edilir.
  • API, web arayüzünün örneklenmemiş raporlar oluşturmak için kullandığı mülk başına günlük jeton sistemini kullanır.
  • İzin verilen maksimum örneklenmemiş rapor sayısı 3.500'dür. Bu sınıra ulaşıldığında, API ile başka örneklenmemiş raporlar oluşturulmaya çalışıldığında aşağıdaki hata alınır: 
    Error creating this entity. You have reached the maximum allowed entities of this type.

Kullanıcı İzni API'sı

Bu kota yalnızca Kullanıcı İzinleri için geçerlidir:

  • Bir kullanıcı en fazla 100 Analytics hesabına sahip olabilir. 100 Analytics hesabı olan bir kullanıcıyı yeni bir hesaba eklemek hataya neden olur.

Aşağıdaki kotalar, kullanıcı izinlerine yönelik toplu yazma (delete, insert, update) istekleri için geçerlidir:

  • Toplu istek başına 300 kullanıcı izni yazma isteği
  • 30 toplu kullanıcı izni yazma isteği 1 yazma isteği olarak sayılır.

Kota sınırlarını aşma

Google Analytics API isteme kotası aşılırsa API, 403 veya 429 hata kodunu ve hesabın kotayı aştığını belirten bir mesaj döndürür. Daha fazla bilgi için hizmet şartlarını inceleyin.

Ek kota isteme

Yalnızca şunları artırma isteğinde bulunabilirsiniz:

Projenizin kullanım sınırlarını görüntülemek, değiştirmek veya kotanızda artış talep etmek için şunları yapın:

  1. Projeniz için faturalandırma hesabınız yoksa hesap oluşturun.
  2. API Konsolu'nda API kitaplığının Etkin API'ler sayfasını ziyaret edin ve listeden bir API seçin.
  3. Kota ile ilgili ayarları görüntülemek ve değiştirmek için Kotalar'ı seçin. Kullanım istatistiklerini görüntülemek için Kullanım'ı seçin.

Maksimum kota miktarının artırılmasını talep etmek için lütfen Analytics API kota istek formunu kullanın. İsteği göndermeden önce kota istek formundaki bilgileri incelediğinizden ve talimatları uyguladığınızdan emin olun. Reporting API v4 için Google API Konsolu'ndaki API adı Google Analytics Reporting API'dir. Diğer tüm v3 API'leri (ör. Management API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) Google API Konsolu'ndaki Analytics API bölümünde listelenmiştir.

Kota yönetimi ve uygulamanızda kota kullanımı için ince ayarlar yapma hakkında daha fazla bilgi edinmek için API'leri ve kullanımı sınırlama başlıklı makaleyi inceleyin.