Sınırlar ve kotalar

Data Manager API ile çalışırken geçerli olan sınırları ve kotaları öğrenmek için bu kılavuzu inceleyin.

Proje sınırları

Data Manager API'yi kullanmak için bir Google Cloud projeniz olmalıdır. Google Cloud projesi, API isteklerinin kimliğini doğrulamak için kullandığınız OAuth istemcisini ve kimlik bilgilerini sağlar.

Data Manager API, her Google Cloud projesinde hizmet ve işlem türüne (okuma ve değiştirme) göre ayrılmış sıklık sınırları uygular:

Hizmet İşlem Günlük istek sayısı Dakika başına istek
IngestionService Değişiklik (yazma) 100.000 300
IngestionService Okuma 100.000 300
Diğer tüm hizmetlerin toplamı Değişiklik (yazma) 50.000 300
Diğer tüm hizmetlerin toplamı Okuma 50.000 300

Sınırları aşan istekler RESOURCE_EXHAUSTED hatası ve 429 Too Many Requests HTTP durumuyla reddedilir.

İstek sayısını aktif olarak azaltarak ve istemci tarafında saniye başına sorgu sayısını kısıtlayarak uygulamanızın kontrolünü elinize alabilir ve sıklık sınırlarını azaltabilirsiniz. Uygulamanız sınırlarına ulaşmadan önce bildirim almak için Google Cloud Console'da kota uyarıları ve izleme de ayarlayabilirsiniz.

Kota adları

Her sınır, Google Cloud'daki bir kota sınırı adına ve metriğe karşılık gelir. Bir istek sınırı aştığında Data Manager API, metadata.quota_limit altındaki ErrorInfo standart ayrıntı yükünde kota sınırı adını döndürür:

Kota sınırı adı Hizmet İşlem Pencere Sınır
IngestionMutateRequestsPerDayPerProject IngestionService Değişiklik Gün 100.000
IngestionMutateRequestsPerMinutePerProject IngestionService Değişiklik Dakika 300
IngestionReadRequestsPerDayPerProject IngestionService Okuma Gün 100.000
IngestionReadRequestsPerMinutePerProject IngestionService Okuma Dakika 300
ManagementMutateRequestsPerDayPerProject Diğer tüm hizmetler Değişiklik Gün 50.000
ManagementMutateRequestsPerMinutePerProject Diğer tüm hizmetler Değişiklik Dakika 300
ManagementReadRequestsPerDayPerProject Diğer tüm hizmetler Okuma Gün 50.000
ManagementReadRequestsPerMinutePerProject Diğer tüm hizmetler Okuma Dakika 300

Günlük ve dakika başına sınır hatalarını ayırt etmek ve geçici olarak duraklatıp geri çekilmeyle yeniden denemek mi yoksa günlük kota sıfırlanana kadar duraklatmak mı gerektiğini belirlemek için ErrorInfo yükündeki metadata.quota_limit değerini inceleyin. Ayrıntılar için Kota ve sıklık sınırlaması hataları başlıklı makaleyi inceleyin.

Sıklık sınırlamalarını ve eşzamanlılığı yönetme

Proje kotalarını aşmadan işleme kapasitesini en üst düzeye çıkarmak için aşağıdaki yönergeleri uygulayın:

  • İstek başına toplu kayıtlar: İstek sınırlarına kadar her isteğe mümkün olduğunca çok kayıt ekleyin (istek başına en fazla 10.000 AudienceMember kaynağı veya 2.000 Event kaynağı).

  • Aynı anda en fazla 10 eşzamanlı istek gönderin: Dakika başına 300 istek sınırını aşmadan toplam besleme süresini azaltmak için IngestionService adresine aynı anda en fazla 10 eşzamanlı istek gönderin.

  • Bekleme süresiyle dakika başına sıklık sınırlarını yeniden deneyin: Bir istek RESOURCE_EXHAUSTED (HTTP 429) ile başarısız olursa ve metadata.quota_limit dakika başına bir sınır (ör. IngestionMutateRequestsPerMinutePerProject) belirtiyorsa dalgalanma ile eksponansiyel geri yükleme kullanarak yeniden deneyin (ör. yeniden denemeler arasında 1 sn, 2 sn ve 4 sn bekleyin).

  • Günlük kota dolduğunda duraklatma: metadata.quota_limit günlük bir sınır (ör. IngestionMutateRequestsPerDayPerProject) belirtiyorsa hemen yeniden denemeyin. Günlük kota Pasifik Saati'ne göre gece yarısında sıfırlanana kadar istekleri duraklatın.

İstek sınırları

Belirli isteklerle ilgili sınırlar şunlardır: