API Sınırları ve Kotaları

Google Ads API, API işlemlerinde tek bir değişiklik isteğinde gönderilebilecek işlem sayısı gibi sınırlar uygular. Aşağıdaki tabloda, bilinmesi gereken bazı önemli sınırlar ve kotalar özetlenmiştir.

İstek Türü, Sınırlama ve Hata Kodu
Sayfalara ayrılmış istekler Sayfa başına 10.000 satır INVALID_PAGE_SIZE
Temel Erişimle İşlemler Günde 15.000 API işlemi RESOURCE_EXHAUSTED
Değişiklik istekleri İstek başına 10.000 işlem TOO_MANY_MUTATE_OPERATIONS
Planlama Hizmeti istekleri 1 QPS RESOURCE_EXHAUSTED
Dönüşüm Yükleme Hizmeti istekleri İstek başına 2.000 dönüşüm TOO_MANY_CONVERSIONS_IN_REQUEST
Faturalandırma ve Hesap Bütçe Hizmeti istekleri Değişiklik isteği başına 1 işlem TOO_MANY_MUTATE_OPERATIONS

Günlük API işlem sınırları

Günlük API kullanım sınırları, geliştirici jetonu başına yapılan API işlemlerinin sayısına bağlıdır. API işlemleri, alma istekleri ve değiştirme işlemlerinin toplamıdır. Günlük API işlemleri için sınırlar, geliştirici jetonunun erişim düzeyine bağlıdır. Erişim Düzeyleri ve İzin Verilen Kullanım kılavuzu, her erişim düzeyi için belirli API işlem sınırlarını açıklar.

Bu sınırları ihlal eden istekler şu hatayla birlikte reddedilir: RESOURCE_EXHAUSTED.

gRPC sınırlamaları

Tüm Google Ads API istemci kitaplıkları, istek ve yanıt oluşturmak için gRPC'yi kullanır. Varsayılan olarak gRPC'nin mesaj boyutu 4 MB'tır ancak istemci kitaplıklarımız verimliliği artırmak için maksimum ileti boyutunu 64 MB olarak ayarlar.

Yanıt sayısı bu sınırı aşmamalıdır. Örneğin, çok sayıda alan içeren bir arama isteği, 64 MB'ı aşan bir yanıt oluşturabilir. Bu sınırı önlemek için seçilen alanların sayısını azaltabilir, sayfa boyutunu küçültebilir veya akış özelliğini kullanabilirsiniz. Değişiklikler için istek başına daha az işlem gönderin.

Bu sınırlamayı ihlal eden istekler GoogleAdsError oluşturmaz ancak 429 Resource Exhausted gRPC hatası oluşturur. gRPC hata kodları ve mesajları listesine bakın.

Değişiklik istekleri

Kullanıcının günlük işlem kotasına göre sayıma ek olarak, değişen istekler istek başına 10.000'den fazla işlem içeremez.

Bu sınırlamayı ihlal eden istekler şu hatayla reddedilir: TOO_MANY_MUTATE_OPERATIONS.

Belirli hizmetler ve istek türleriyle ilgili ek sınırlar ve dikkat edilmesi gereken noktalar aşağıda açıklanmıştır.

Arama istekleri

Search veya SearchStream isteği, kullanıcının günlük işlem kotasında tek bir işlem olarak sayılır. Bir SearchStream isteği, grup sayısından bağımsız olarak bir API işlemi olarak sayılır.

Sayfalara ayrılmış istekler

Sayfalara ayrılmış istekler (örneğin, geçerli bir next_page_token içeren istekler) kullanıcının günlük işlem kotasına dahil edilmez. Ancak süresi dolmuş veya geçersiz sayfa jetonu içeren sayfalara ayırma istekleri bir istisna oluşturur ve günlük işlem kotasına dahil edilir.

Arama istekleri gibi sayfalara ayrılan istekler de Page size cannot exceed 10,000 rows sınırlamasına tabidir ve bu sınırı ihlal etmesi halinde şu hatayla birlikte reddedilir: INVALID_PAGE_SIZE.

Sayfalara ayırma hakkında daha fazla ayrıntı için Sonuçları sayfalandırma bölümüne bakın.

Diğer talep türleri

Get, Mutate, Search veya SearchStream isteği olmayan bir istek, kullanıcının günlük işlem kotasında tek bir işlem olarak sayılır.

Bu tür taleplere ilişkin birkaç örneği aşağıda bulabilirsiniz:

API istisnaları döndüren istekler

GoogleAdsFailure ile reddedilen istekler yine kullanıcının günlük işlem kotasına dahil edilir.

Başarısız olan ancak GoogleAdsFailure döndürmeyen istekler (örneğin, ağ düzeyindeki bir hatadan dolayı) hizmete hiçbir zaman ulaşamayacağı için kullanıcının günlük işlem kotasına dahil edilmez. Buna örnek olarak ağ bağlantısı hatası verilebilir.

Planlama hizmetleri

Maliyet ve karmaşıklık nedeniyle, aşağıda listelenen Planning hizmeti yöntemleri diğer istek türlerinden ayrı sınırlara tabidir.

Anahtar kelime planı oluştururken bu sınırları göz önünde bulundurun.

Anahtar Kelime Planı Nesnesi Maksimum Sayı
Hesap başına KeywordPlan 10.000
KeywordPlanAdGroup / KeywordPlan 200
KeywordPlanAdGroupKeyword / KeywordPlan 10.000
KeywordPlanCampaignKeyword (negatif anahtar kelimeler) 1.000
KeywordPlanCampaign / KeywordPlan 1

Dönüşüm yükleme hizmeti

Dönüşüm ayarlaması yükleme hizmeti

Faturalandırma ve hesap bütçesi hizmetleri

  • Yalnızca aylık faturalandırma için yapılandırılan hesaplarda değişiklik yapılabilir.

    Bu sınırlamayı ihlal eden istekler şu hatayla reddedilir: MUTATE_NOT_ALLOWED.

  • Değişiklik istekleri için yalnızca 1 işleme izin verilir.

    Bu sınırlamayı ihlal eden istekler şu hatayla reddedilir: TOO_MANY_MUTATE_OPERATIONS.

  • Aynı hesapta yapılan bütçe talimatı değişiklikleri arasında en az 12 saat beklemeniz gerekir. 12 saat dolmadan önce değişiklik yapmak, yalnızca Google Ads hesap temsilciniz tarafından giderilebilecek düzeltilemeyen hatalara yol açabilir.

Müşteri hesaplarına davetiyeler

Yeni kullanıcılar, CustomerUserAccessService ile mevcut müşteri hesaplarına davet edilebilir. Bu işlev diğer kullanıcılara davetiye e-postaları gönderdiğinden kötüye kullanılma olasılığı vardır ve bu nedenle davranışıyla ilgili sınırlamalar vardır:

Kullanıcı verileri

Kullanıcı verileri UserDataService ve OfflineUserDataJobService ile yönetilir. Belirli bir oluşturma/kaldırma UserData işleminde, her user_identifiers kümesi tek bir kullanıcıya özel olmalıdır.

Bunu uygulamak için birUserData kümesinde 20'den fazla user_identifiers olduğunda OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS veya UserDataError.TOO_MANY_USER_IDENTIFIERS hatası döndürülür.

Diğer sınır türleri

İstekte çok fazla öğeye sahip olan işlemler listesi gibi tekrarlanan bir alan, şu hatayla sonuçlanabilir: REQUEST_SIZE_LIMIT_EXCEEDED. Aynı hata mesajı başka sorunlardan da kaynaklanıyor olabilir.

Bu sınırlamayla karşılaşırsanız ve tekrarlanan bir alan kullanan istekler yapıyorsanız bir değişim isteğinde bir işlem listesi dağıtarak tekrarlanan alandaki öğe sayısını azaltmayı deneyin.

Bir GAQL sorgusu oluştururken IN yan tümcesi içindeki maksimum öğe sayısı 20.000'dir. Bu sınırı aşarsanız FILTER_HAS_TOO_MANY_VALUES hatası döndürülür.

Önceki
Genel bakış
Sonraki
Sistem sınırları