API Sınırları ve Kotaları

Google Ads API, API işlemleri üzerinde, tek bir değişiklik isteğinde gönderilebilecek işlemlerin sayısı gibi sınırları zorunlu kılar. Aşağıdaki tabloda, dikkate alınması gereken önemli sınır ve kotalardan bazıları özetlenmiştir.

İstek Türü, Sınırlama ve Hata Kodu
Temel Erişim ile İş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 isteklerinin yönetimi 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çesi Hizmeti istekleri Değiştirme isteği başına 1 işlem TOO_MANY_MUTATE_OPERATIONS

Günlük API işlemi 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 göre belirlenir. 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'nda her erişim düzeyine özel API işlem sınırları açıklanmaktadır.

Bu sınırları ihlal eden istekler, RESOURCE_EXHAUSTED hatasıyla reddedilir.

gRPC sınırlamaları

Tüm Google Ads API istemci kitaplıkları, istek ve yanıt oluşturmak için gRPC 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 mesaj boyutunu 64 MB olarak ayarlar.

Yanıtlar bu sınırı aşmamalıdır. Örneğin, çok sayıda alan içeren bir arama isteği, boyutu 64 MB'ı aşan bir yanıt oluşturabilir. Bu sınırdan kaçınmak için seçilen alanların sayısını azaltabilir veya akışı kullanabilirsiniz. Değiştirme işlemleri 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ının listesine bakın.

Değişiklik istekleri

Bir değiştirme isteği, kullanıcının günlük işlem kotasına dahil edilmenin yanı sıra istek başına 10.000'den fazla işlem içeremez.

Bu sınırı ihlal eden istekler TOO_MANY_MUTATE_OPERATIONS hatasıyla reddedilir.

Belirli hizmetler ve istek türleriyle ilgili ek sınırlamalar 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ına 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.

Sayfaya bölünmüş istekler

Sayfaya 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 istisna oluşturur ve günlük işlem kotasına dahil edilir.

Sayfalara ayırma hakkında daha fazla bilgi için Sonuçlara göz atma bölümüne bakın.

Diğer istek türleri

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

Bu tür taleplere örnek olarak aşağıdakiler verilebilir:

API istisnaları döndüren istekler

GoogleAdsFailure ile reddedilen istekler, kullanıcının günlük işlem kotasından düşülür.

Ağ düzeyinde bir hata nedeniyle başarısız olan ancak GoogleAdsFailure döndürmeyen istekler, hizmete hiçbir zaman ulaşamayacağından 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ğıdaki Planlama hizmeti yöntemleri, diğer istek türlerinden farklı 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
KeywordPlan başına KeywordPlanAdGroupKeyword 10.000
KeywordPlanCampaignKeyword (negatif anahtar kelimeler) 1.000
KeywordPlan başına KeywordPlanCampaign 1

Dönüşüm yükleme hizmeti

Dönüşüm ayarlama yükleme hizmeti

Faturalandırma ve hesap bütçesi hizmetleri

  • Mutasyonlar yalnızca aylık faturalandırma için yapılandırılmış hesaplar üzerinde yapılabilir.

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

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

    Bu sınırı ihlal eden istekler TOO_MANY_MUTATE_OPERATIONS hatasıyla reddedilir.

  • Aynı hesapta bütçe sırası değişiklikleri arasında en az 12 saat beklemeniz gerekir. 12 saat geçmeden değişiklik yapmak, yalnızca Google Ads hesap temsilciniz tarafından çözülebilecek, kurtarılamaz hatalara neden olabilir.

Müşteri hesaplarına davetler

Yeni kullanıcılar, CustomerUserAccessService ile mevcut müşteri hesaplarına davet edilebilir. Bu özellik diğer kullanıcılara davet e-postaları gönderdiği için kötüye kullanıma açıktır. Bu nedenle, davranışının sınırlamaları vardır:

Kullanıcı verileri

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

Bu kuralın uygulanması için, UserData 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

Bir istekteki çok fazla öğe içeren yinelenen bir alan (ör. işlem listesi) REQUEST_SIZE_LIMIT_EXCEEDED hatasına neden olabilir. Aynı hata mesajı, başka sorunlardan da kaynaklanıyor olabilir.

Bu sınırlamayla karşılaşıyorsanız ve yinelenen alan kullanan isteklerde bulunuyorsanız bir değişiklik isteğinde işlem listesini dağıtarak tekrarlanan alandaki öğe sayısını azaltmayı deneyin.

GAQL sorgusu yapılırken bir IN ifadesi içinde bulunabilecek 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ı