Google Calendar API, tüm kullanıcılar tarafından adil bir şekilde kullanılmasını sağlayan kotalara sahiptir. Takvim API'sı:
- API kullanım kotaları proje ve kullanıcı başına zorunlu kılınır. Sonraki bölümüne bakın.
- Genel Takvim kullanım sınırları: Kaçınma Takvim kullanım sınırları.
- Operasyonel sınırlar: Herhangi bir zamanda fiyat kısıtlamalı olabilirsiniz. Örneğin: tek bir takvime arka arkaya yazmayı denediğinizde.
Calendar API kullanım kotası türleri
İki tür kota uygulanır:
- Proje başına dakika başına: Bu, Google Cloud projesi.
- Kullanıcı başına proje başına bir dakika: Bu, Cloud projenizdeki belirli bir kullanıcıyla paylaşabilirsiniz. Bu sınırın amacı kullanımın kullanıcılarınız arasında adil bir dağıtım olmasını sağlamanıza yardımcı olur.
Kotalar, kayan bir pencere kullanılarak dakika başına hesaplanır. Böylece, trafiğiniz bir dakika içinde dakika başına kotanızı aşarsa, süre sınırlamasını takiben bir sonraki pencerede kullanımınızın ortalama olarak hâlâ kota dahilinde kalıyor.
Kotalardan herhangi birinin aşılması durumunda, hızınız sınırlandırılır ve
403 usageLimits durum kodu
veya
429 usageLimits durum kodu
uygulayabilirsiniz. Bu durumda yapabilecekleriniz:
- Aşağıdaki en iyi uygulamaların tümüne uyduğunuzdan emin olun: eksponansiyel geri yükleme yöntemini kullanın. trafik kalıplarını rastgele kullanmayın, push bildirimlerini kullanın.
- Projeniz büyüyorsa ve daha fazla kullanıcınız varsa proje başına kota artışı.
- Kullanıcı başına kota sınırına ulaşılırsa aşağıdakileri yapabilirsiniz:
- Bir hizmet hesabı kullanıyorsanız yükü kullanıcılara paylaştırın hizmet hesaplarına bölebilirsiniz.
- Kullanıcı başına kotanın artırılmasını isteyebilirsiniz ancak bunu uygulama olarak varsayılan değerin üzerine çıkarmanız önerilmez başka sınır türlerine ulaşmakla karşılaşabilirsiniz, örneğin genel takvim kullanım sınırlarını görebilirsiniz.
Kota artışı isteği
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:
- Projeniz için faturalandırma hesabınız yoksa hesap oluşturun.
- "Etkin API'ler" sayfasını ziyaret edin. API kitaplığını açın ve liste'ye dokunun.
- 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.
Eksponansiyel geri yükleme kullan
İstek hızınızı yavaşlatmanızı istediğimizde "usageLimits" bir yanıt veya 429 yanıtı (bkz. tüm hata dokümanlarına göz atın). Bu önemli bir hata değildir. İsteğinizi kısa bir süre sonra tekrar denemenizi seçebilirsiniz. İstekler hâlâ çok hızlı ulaşabiliyorsa tekrar sorarız ve bu şekilde devam eder. Bunun doğru şekilde işlemesi için, test ve kontrol grupları arasındaki zamanla artar.
Genel olarak kısaltılmış eksponansiyel geri yükleme kullanmanız gerekir. "the" Cloud Storage belgeleri algoritmanın nasıl çalıştığı hakkında iyi bir açıklamaya sahip. Eğer Google istemci kitaplığı kullanıyorsanız bu işlem normalde sizin için gerçekleştirilir; danışma kolayca kontrol edebilirsiniz. Normalde kitaplık uygulamasını karar vermekten çekinmeyin.
Trafik kalıplarını rastgele hale getirme
Takvim istemcileri, aynı anda işlem yapan birden fazla istemcidir. Örneğin, tam senkronizasyon gerçekleştirmek şu an için kötü bir uygulamadır: gece yarısı. Bu durumda dakika başına kotanızın aşılması neredeyse hız sınırlamasına ve geri çekilmesine neden olabilir.
Bunu önlemek için trafiğinizin güne yayıldığından emin olun Mümkün olduğunca kullanın. Müşterinizin günlük senkronizasyon yapması gerekiyorsa istemcinin Rastgele bir zaman belirler (her müşteri için farklı). Herhangi bir işlemi düzenli olarak gerçekleştiriyorsanız +/- %25 aralığını değiştirin. Bu, daha dengeli bir şekilde sağlar ve çok daha iyi bir kullanıcı deneyimi sağlar.
Push bildirimlerini kullanma
Yaygın kullanım alanlarından biri, bir şey değiştiğinde bir işlem gerçekleştirmektir takviminde görünür. Buradaki kalıpların dışında, her zaman bir takvime dokunabilirsiniz. Bu işlem, kotanızın tamamını çok hızlı bir şekilde tüketir. Örneğin, Uygulamanızın 5.000 kullanıcısı varsa ve her kullanıcının takvimini bir kez anketlerle bu, dakika başına en az 5.000 veya daha fazla bir proje başlatma belgesine dönüştürebilirsiniz.
Sunucu tarafı uygulamalar push bildirimlerine kaydolabilir. Bu da,
bir bildirim kullanabilirsiniz. Bu araçlar, yürütülmesi gereken
aynı zamanda kotanızı önemli ölçüde daha verimli şekilde kullanmanıza da olanak tanır.
daha iyi bir kullanıcı deneyimi sağlar. Şu öğe için eventType belirttiğinizden emin olun:
Bunu nasıl yapacağınıza karar verin. Daha fazla bilgi için bkz.
Push bildirimleri.
Hizmet hesaplarıyla doğru muhasebe
Uygulamanız, istekleri
alan genelinde yetki,
hizmet hesabı varsayılan olarak "her dakika için dakika başına"
proje başına proje sayısı" kotaları (kimlerin kimliğine büründüğünüz kullanıcı değil) tarafından belirlenir. Bunun anlamı şudur:
hizmet hesabının kotası tükenecek ve hız sınırlaması olacak.
birden fazla kullanıcı üzerinde çalışıyor olsa da takvim. Önerebileceğiniz işlemler
Bunun için quotaUser URL parametresini (veya x-goog-quota-user HTTP
başlığı) gösterilir. Bu yalnızca kota için kullanılır
hesaplama. Görüntüleyin
Kullanıcı başına istekleri sınırlama
Cloud belgelerine göz atın.
Kota sınırı işlemeyi test etme
Uygulamanızın kota sınırlarına ulaşma konusunda sorunsuz bir şekilde başlayabilmesi için (ör. üstel geri yükleme ile yeniden denemeler yaparak) ve kullanıcılarınızın rahatsız olabileceği durumları en aza indirmek için gerçek bir ortama dönüştürmenizi sağlar.
Bu tür bir testin gerçek uygulama kullanımınızı etkilememesi için, yalnızca test amaçlı ayrı bir proje kaydetmenizi Google API Konsolu ve yapılandırma Bu, üretim projenize benzer. Ardından ayarlanmış yapay zeka kotasını belirleyin ve uygulamanızın davranışını gözlemleyin.
Fiyatlandırma
Google Calendar API'nin her türlü kullanımı ek ücret ödemeden kullanılabilir. Kotanın aşılması istek sınırları nedeniyle ek ücret alınmaz ve hesabınız faturalandırılmaz.