Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Kullanım sınırları

Google Takvim API'si, tüm kullanıcılar tarafından adil bir şekilde kullanılmasını sağlamak için kotalara sahiptir. Takvim API'sini kullanırken üç önemli sınırlamayı göz önünde bulundurun:

API kullanım kotaları: Proje ve kullanıcı başına uygulanır. Daha fazla bilgi için Calendar API kullanım kotası türleri başlıklı makaleyi inceleyin.
Genel Takvim kullanım sınırları: Calendar API, Google Workspace sisteminin genel performansını korumak için sınırlamaları olan paylaşılan bir hizmettir. Daha fazla bilgi için Takvim kullanım sınırlarını aşmaktan kaçınma başlıklı makaleyi inceleyin.
İşlem sınırları: Bu sınırlar herhangi bir zamanda uygulanabilir. Örneğin, tek bir takvime hızlı bir şekilde yazmaya çalışırsanız sınırlar geçerli olabilir.

Calendar API kotaları

İki tür kota uygulanır:

Proje başına dakika: Bu, Google Cloud projenizin bir dakikada yapabileceği istek sayısıdır.
Kullanıcı başına proje başına dakika: Bu, belirli bir kullanıcının Cloud projenizde yapabileceği istek sayısıdır. Bu sınır, kullanıcılarınız arasında kullanımın adil bir şekilde dağıtılmasını sağlar.

Kotalar, kayan pencere kullanılarak dakika başına hesaplanır. Dakika başına kotanızı aşan hızlı bir trafik patlaması, ortalama olarak kullanımınızın kotalar içinde kalmasını sağlamak için sonraki dönemde hız sınırlamasına neden olur.

Bu sınırlar aşağıdaki tabloda ayrıntılı olarak açıklanmıştır:

Kullanım sınırı türü	Sınır
Proje başına dakika	10.000 istek
Proje başına kullanıcı başına dakikada	600 istek

Günlük faturalandırma eşiği

Bu proje başına günlük sınır, Cloud projenizin ücretlendirme uygulanmadan önce 24 saatlik bir süre içinde kullanabileceği maksimum istek sayısını tanımlar.

Bu eşiğin altındaki kullanım için ek ücret alınmaz ve Google Cloud hesabınız faturalandırılmaz. Faturalandırmayla ilgili tüm ayrıntılar, 2026'da değişiklikler yürürlüğe girmeden en az 90 gün önce paylaşılacaktır.

Bu günlük eşik sınırını artırma isteğinde bulunamazsınız.

Sınırla ilgili ayrıntılar aşağıdaki tabloda verilmiştir:

Eşik sınırlama türü	Sınır
Proje başına günlük	1.000.000 istek

Daha fazla bilgi için Google Workspace'in aracı araçları ve API'leri için standartlaştırılmış modeli başlıklı makaleyi inceleyin.

Zamana dayalı kota hatalarını düzeltme

Zamana dayalı tüm hatalar (X dakika başına en fazla N istek) için kodunuzun istisnayı yakalamasını ve cihazlarınızın aşırı yük oluşturmadığından emin olmak için kısaltılmış eksponansiyel geri yükleme kullanmasını öneririz.

Eksponansiyel geri yükleme, ağ uygulamaları için standart bir hata işleme stratejisidir. Eksponansiyel geri yükleme algoritması, istekler arasındaki bekleme sürelerini üstel olarak artırarak istekleri yeniden dener. Maksimum geri yükleme süresine kadar bu işlem devam eder. İstekler hâlâ başarısız oluyorsa istek başarılı olana kadar istekler arasındaki gecikmelerin zaman içinde artması önemlidir.

Örnek algoritma

Eksponansiyel geri yükleme algoritması, istekleri eksponansiyel olarak yeniden dener ve yeniden denemeler arasındaki bekleme süresini maksimum geri yükleme süresine kadar artırır. Örneğin:

Google Takvim API'ye istek gönderin.
İstek başarısız olursa 1 + random_number_milliseconds bekleyin ve isteği yeniden deneyin.
İstek başarısız olursa 2 + random_number_milliseconds bekleyin ve isteği yeniden deneyin.
İstek başarısız olursa 4 + random_number_milliseconds saniye bekleyin ve isteği yeniden deneyin.
Bu işlem maximum_backoff kez tekrarlanabilir.
Maksimum deneme sayısına ulaşana kadar beklemeye ve yeniden denemeye devam edin ancak yeniden denemeler arasındaki bekleme süresini artırmayın.

Bu örnekte:

Bekleme süresi min(((2^n)+random_number_milliseconds), maximum_backoff)'dır. Her yineleme (istek) için n değeri 1 artırılır.
random_number_milliseconds,1.000'den küçük veya 1.000'e eşit rastgele bir milisaniye sayısıdır. Bu sayede, birçok istemcinin bir durum nedeniyle senkronize olup aynı anda yeniden denediği ve istekleri senkronize dalgalar halinde gönderdiği durumlar önlenir. random_number_milliseconds değeri her yeniden deneme isteğinden sonra yeniden hesaplanır.
maximum_backoff genellikle 32 veya 64 saniyedir. Uygun değer, kullanım alanına bağlıdır.

İstemci, maximum_backoff süresine ulaştıktan sonra yeniden denemeye devam edebilir. Bu noktadan sonraki yeniden denemelerde geri çekilme süresinin artırılması gerekmez. Örneğin, bir istemci 64 saniyelik bir maximum_backoff kullanıyorsa bu değere ulaştıktan sonra istemci her 64 saniyede bir yeniden deneyebilir. Bir noktada, istemcilerin süresiz olarak yeniden denemesi engellenmelidir.

Yeniden denemeler arasındaki bekleme süresi ve yeniden deneme sayısı, kullanım alanınıza ve ağ koşullarına bağlıdır.

Fiyatlandırma

Google Takvim API'nin tüm standart kullanımları ek ücret ödenmeden kullanılabilir. Kota sınırlarını aşan istekler için 2026'nın ilerleyen dönemlerinde Google Cloud Faturalandırma Hesabınızdan ücret alınması planlanmaktadır. Daha fazla bilgi için Google Workspace'in aracı araçları ve API'leri için standartlaştırılmış modeli başlıklı makaleyi inceleyin.

Kota artışı isteme

Projenizin kaynak kullanımına bağlı olarak kota ayarlaması isteğinde bulunmak isteyebilirsiniz. Bir hizmet hesabının yaptığı API çağrıları, tek bir hesap kullanıyormuş gibi değerlendirilir. Ayarlanmış kota başvurusunda bulunmak onay alacağınıza dair bir garanti teşkil etmez. Kota değerini önemli ölçüde artıracak kota ayarlama isteklerinin onaylanması daha uzun sürebilir.

Her projenin kotası aynı değildir. Google Cloud'u zaman içinde daha fazla kullandıkça kota değerlerinizin artırılması gerekebilir. Kullanımın önemli oranda artacağını düşünüyorsanız Google Cloud Console'daki Kotalar ve Sistem Sınırları sayfasından önlem amaçlı olarak kota ayarlaması isteyebilirsiniz.

Daha fazla bilgi edinmek için aşağıdaki kaynakları inceleyin:

Sorun giderme

Kotalardan biri aşılırsa hız sınırına tabi tutulursunuz ve sorgularınıza yanıt olarak 403 usageLimits veya 429 usageLimits durum kodu alırsınız.

Bu durumda aşağıdakileri deneyebilirsiniz:

Tüm en iyi uygulamaları uyguladığınızdan emin olun: Üstel geri çekilme kullanın, trafik kalıplarını rastgele hale getirin ve push bildirimlerini kullanın.
Projeniz büyüyorsa ve daha fazla kullanıcınız varsa kota artışı isteyebilirsiniz.
Kullanıcı başına kota sınırlarına ulaşırsanız aşağıdakileri yapabilirsiniz:
- Hizmet hesabı kullanıyorsanız yükü kullanıcılara dağıtın veya birden fazla hizmet hesabı arasında paylaştırın.
- Kullanıcı başına kota artışı isteğinde bulunabilirsiniz ancak uygulamanız genel takvim kullanım sınırları veya operasyonel sınırlar gibi başka türden sınırlara ulaşabileceğinden, genel olarak kotayı varsayılan değerin üzerine çıkarmanızı önermeyiz.
Üretim projenizle benzer bir yapılandırmaya sahip, yalnızca test için kullanılan ayrı bir proje kaydederek kota sınırlarınızı test edin. Daha fazla bilgi için Test quota limit handling (Kota sınırı işlemeyi test etme) başlıklı makaleyi inceleyin.

Trafik kalıplarını rastgele hale getirme

Takvim istemcileri, aynı anda işlem yapan birden fazla istemcinin neden olduğu ani trafik artışlarına eğilimlidir. Örneğin, Takvim istemcisi için yaygın bir kötü uygulama, gece yarısı tam senkronizasyon yapmaktır. Bu durum genellikle dakika başına kotanızı aşar ve sıklık sınırlama ile geri çekilmelere neden olur.

Bunu önlemek için trafiğinizi mümkün olduğunca gün içine yayın. Müşterinizin günlük senkronizasyon yapması gerekiyorsa müşterinin rastgele bir zaman belirlemesini sağlayın (her müşteri için farklı bir zaman). Düzenli olarak bir işlem yapmanız gerekiyorsa aralığı ±%25 oranında değiştirin. Bu sayede trafik daha eşit şekilde dağıtılır ve daha iyi bir kullanıcı deneyimi sağlanır.

Push bildirimlerini kullanma

Kullanıcının takviminde bir değişiklik olduğunda işlem yapılması, bu işlevin yaygın kullanım alanlarından biridir. Buradaki bir anti-pattern, ilgilenilen her takvimi tekrar tekrar yoklamaktır. Bu durum, kotanızın hızlı bir şekilde tükenmesine neden olur. Örneğin, uygulamanızın 5.000 kullanıcısı varsa ve her kullanıcının takvimini dakikada bir kez yokluyorsa herhangi bir işlem yapılmadan önce bile dakikada en az 5.000 kota gerekir.

Sunucu tarafı uygulamaları, push bildirimlerine kaydolabilir. Bu sayede Takvim, ilgilendiğiniz bir şey olduğunda sizi bilgilendirebilir. Bunların ayarlanması daha fazla çalışma gerektirir ancak kotayı daha verimli kullanmanıza ve daha iyi bir kullanıcı deneyimi sunmanıza olanak tanır. Bildirim almak istediğiniz eventType öğesini belirtin. Daha fazla bilgi için Push bildirimleri başlıklı makaleyi inceleyin.

Hizmet hesaplarıyla uygun tahsis

Uygulamanız alan genelinde yetki kullanarak istekte bulunuyorsa varsayılan olarak hizmet hesabı, kimliğine büründüğünüz kullanıcı yerine "proje başına kullanıcı başına dakika başına" kotaları kapsamında ücretlendirilir. Bu, hizmet hesabının birden fazla kullanıcının takviminde çalışsa bile kotasını tüketip sıklık sınırına tabi tutulabileceği anlamına gelir.

Hangi kullanıcının ücretlendirileceğini belirtmek için quotaUser URL parametresini (veya x-goog-quota-user HTTP üstbilgisini) kullanarak bu durumdan kaçınabilirsiniz. Google bu parametreyi yalnızca kota hesaplamaları için kullanır. Daha fazla bilgi için Kullanıcı başına istek sayısını sınırlama başlıklı makaleyi inceleyin.

Kota sınırı işleme özelliğini test etme

Uygulamanızın, kota sınırlarına ulaşmayı pratikte sorunsuz bir şekilde yönettiğinden (örneğin, üstel geri çekilme ile yeniden denemeler yoluyla) emin olmak ve kullanıcılarınızda olası rahatsızlıkları en aza indirmek için uygulamanızı gerçekçi bir ortamda test edin.

Gerçek uygulama kullanımınızda herhangi bir kesinti olmadan test etmek için Google Cloud Console'da yalnızca test için ayrı bir proje kaydedin ve ardından OAuth izin ekranını üretim projenize benzer şekilde yapılandırın. Ardından, bu proje için yapay olarak düşük kota sınırları belirleyebilir ve uygulamanızın davranışını gözlemleyebilirsiniz.

Takvim MCP sunucusu kotaları

Takvim MCP sunucusu, sorgu maliyeti tahsisi metriğini kullanır. Aşağıdaki tablolarda, her bir Takvim MCP sunucusu yönteminin sorgu maliyeti bölümlere göre ayrıntılı olarak açıklanmaktadır:

Takvim MCP kotaları