Kullanım sınırları ve kotalar
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Sınırlar ve kotalar, Google altyapısını Bayi API'sini uygunsuz bir şekilde kullanan otomatik bir süreçten korur. Bir API'den gelen aşırı istekler, zararsız bir yazım hatasından veya gereksiz API çağrıları yapan verimsiz tasarlanmış bir sistemden kaynaklanabilir. Nedeni ne olursa olsun, belirli bir kaynaktan gelen trafiğin belirli bir düzeye ulaştığında engellenmesi, Google Workspace sisteminin genel sağlığı için gereklidir. Bir geliştiricinin eylemlerinin daha büyük topluluğu olumsuz etkilememesini sağlar.
API istek hataları
API isteğinizin başarısız olması durumunda uygulamanız bir HTTP durum kodu yanıtı alır. 403 durum kodu, yanlış girişle ilgili hata bilgilerini, 503 HTTP durum kodu ise hangi API kotalarının aşıldığını belirten hata bilgilerini içerir. Bu yanıtlar, özel uygulamanızın bu hataları algılamasına ve uygun işlemi yapmasına olanak tanır.
Zamana dayalı hatalar
Özellikle 503 durum kodu hataları olmak üzere, zamana dayalı tüm hatalar (iş parçacığı başına N saniyede en fazla N öğe) için kodunuzun istisnayı yakalamasını ve üstel geri çekilme algoritması kullanarak başarısız olan çağrıyı yeniden denemeden önce kısa bir süre beklemesini öneririz. Bir iş parçacığı için Bayi API'si örneğinde, 5 saniye beklenir ve başarısız olan çağrı yeniden denenir. İstek başarılı olursa bu kalıbı diğer ileti dizileri için tekrarlayın. İkinci istek başarılı olmazsa uygulamanız, arama başarılı olana kadar isteğin sıklığını azaltmalıdır. Örneğin, ilk 5 saniyelik gecikmeyi 10 saniyeye çıkarın ve başarısız olan aramanızı tekrar deneyin. Ayrıca, yeniden deneme sınırı belirleyin.
Örneğin, uygulamanız kullanıcıya hata döndürmeden önce farklı gecikme süreleriyle bir isteği 5-7 kez yeniden deneyin.
Sınırlar
| API sınır kategorileri |
Sınırlar |
Abonelik purchaseOrderId |
Bu özellik en fazla 80 düz metin karakterini kabul eder. |
Abonelik maxResults |
maxResults sorgu dizesi 1-100 sonuç içerebilir.
Varsayılan olarak 20 sonuç gösterilir.
|
Aktarım jetonu (customerAuthToken) |
Müşterinin aktarım jetonu, oluşturulduktan sonra 30 gün boyunca geçerlidir.
|
| Bir müşteri için maksimum kullanıcı sayısı |
Sözleşmenize bağlı olarak maksimum kullanıcı sayısı 50.000 veya bayinizle yaptığınız sözleşmede tanımlanan maksimum sayı olabilir.
|
| Yetkisiz istekler |
Google, Bayi API'sine yetkisiz istek gönderilmesine izin vermez.
Yetkilendirme jetonu sağlanmazsa istek yetkisiz olarak kabul edilir. Daha fazla bilgi için Kimlik doğrulama ve yetkilendirme hakkında bilgi başlıklı makaleyi inceleyin.
|
Diğer sınır türleri
| Diğer sınır türleri |
Sınırlamalar ve yönergeler |
| Veri biçimi |
Veri biçimi JavaScript Object Notation
JSON'dur.
JSON, rastgele veri yapılarını temsil etme yöntemi sağlayan yaygın bir internet biçimidir. JSON, tamamen dilden bağımsız bir metin biçimidir ancak C, C++, C#, Java, JavaScript, Perl ve Python gibi C ailesi dillerinin programcılarına tanıdık gelen kuralları kullanır.
|
| Saat biçimi |
Tüm tarih ve saatler, milisaniye cinsinden Epoch dönüştürücüsünde gösterilir. Bu biçim; abonelik oluşturma zamanı, planın taahhüt başlangıç ve bitiş zamanları ile 30 günlük ücretsiz denemenin bitiş zamanı değerleri için geçerlidir.
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[],[],null,["# Usage limits and quotas\n\n\u003cbr /\u003e\n\nLimits and quotas protect the Google infrastructure from an automated process\nthat uses the Reseller API in an inappropriate way. Excessive requests from\nan API might result from a harmless typo, or might result from an inefficiently\ndesigned system that makes needless API calls. Regardless of the cause,\nblocking traffic from a specific source when it reaches a certain level is\nnecessary for the overall health of the Google Workspace system. It ensures that\none developer's actions can not negatively impact the larger community.\n\nAPI request failures\n--------------------\n\nIn the unlikely event that your API request fails, your application receives an\nHTTP status code response. A status code of `403` has error\ninformation about incorrect input and an HTTP status code of `503`\nhas error information indicating which API quotas have been exceeded. These\nresponses let your custom application detect these errors and take appropriate\naction.\n\nTime-based errors\n-----------------\n\nFor all errors that are time based (maximum of N things for N seconds per\nthread), especially the `503` status code errors, we recommend that\nyour code catch the exception and by using\nan\n[exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff)\nalgorithm, wait for a small delay before retrying the failed call. A\nReseller API example for one thread\nis to wait 5 seconds and retry the failed call. If the request is successful,\nrepeat this pattern for the other threads. If the second request isn't\nsuccessful, your application should scale back on the frequency of the request\nuntil a call is successful. For example, increase the initial 5 second delay\nto 10 seconds and retry your failed call again. Also, decide on a retry limit.\nFor example retry a request 5 to 7 times with different delay times before\nyour application returns an error to the user.\n\nLimits\n------\n\n| API limit categories | Limits |\n|----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Subscription `purchaseOrderId` | This property accepts up to 80 plain text characters. |\n| Subscription `maxResults` | The `maxResults` query string can be 1 - 100 results. The default is 20 results. |\n| Transfer Token (`customerAuthToken`) | A customer's transfer token is valid for 30 days after it's generated. |\n| Maximum number of users for a customer | Depending on your contract, the maximum number of users can either be 50,000 or the maximum defined in your reseller contract. |\n| Unauthorized requests | Google doesn't allow unauthorized requests to the Reseller API. A request is considered unauthorized if no authorization token is provided. For more information, see [Learn about authentication \\& authorization](/workspace/guides/auth-overview). |\n\nOther types of limits\n---------------------\n\n| Other types of limits | Limitations and guidelines |\n|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Data format | The data format is in the JavaScript Object Notation [JSON](https://wikipedia.org/wiki/JSON). \u003cbr /\u003e \u003cbr /\u003e JSON is a common internet format that provides a method of representing arbitrary data structures. JSON is a text format that is completely language-independent but uses conventions that are familiar to programmers of the C-family of languages, including C, C++, C#, Java, JavaScript, Perl, and Python. |\n| Time format | All date times are in the [Epoch converter](https://www.epochconverter.com/) in milliseconds. This format applies to the values for the subscription creation time, a plan's commitment start and end times, and a 30 day free trial's end time. |"]]
