API Sınırlılıkları ve Kotaları

Google Ads API, tek bir mutate isteğinde gönderilebilecek işlem sayısı gibi API işlemleriyle ilgili sınırlamalar uygular. Aşağıdaki tabloda, dikkat edilmesi gereken önemli sınırlardan ve kotalardan bazıları özetlenmektedir.

İstek Türü, Sınırlama ve Hata Kodu
Temel erişim düzeyiyle yapılan iş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ç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şlemleriyle ilgili 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üzeyi için geçerli olan 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ı

Google Ads API istemci kitaplıklarının tümü, istek ve yanıt oluşturmak için gRPC'yi kullanır. gRPC'nin varsayılan ileti 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ıtlarda bu sınır aşılmamalı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ıra takılmamak için seçilen alanların sayısını azaltabilir veya akış kullanabilirsiniz. Değişiklikler için istek başına daha az işlem gönderin.

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

Değişiklik istekleri

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ırlamayı ihlal eden istekler, TOO_MANY_MUTATE_OPERATIONS hatasıyla reddedilir.

Belirli hizmetler ve istek türleriyle ilgili ek sınırlar ve dikkat edilmesi gereken noktalar aşağıda özetlenmiştir.

Arama istekleri

Search veya SearchStream isteği, kullanıcının günlük işlem kotasına bir işlem olarak yansıtılır. Toplu işlem sayısından bağımsız olarak bir SearchStream isteği, bir API işlemi olarak sayılır.

Sayfalandırılmış istekler

Sayfalandırı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 bir sayfa jetonu içeren sayfalara ayırma istekleri bir istisna oluşturur ve günlük işlem kotasına dahil edilir.

Sayfalandırma hakkında daha fazla bilgi için Sonuçlar arasında gezinme başlıklı makaleyi inceleyin.

Diğer istek türleri

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

Bu tür isteklere birkaç örnek:

API istisnaları döndüren istekler

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

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

Anahtar kelime planlama hizmeti

Maliyet ve karmaşıklık nedeniyle aşağıdaki anahtar kelime planlama 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
KeywordPlan başına KeywordPlanAdGroup 200
KeywordPlan başına KeywordPlanAdGroupKeyword 10.000
KeywordPlanCampaignKeyword (negatif anahtar kelimeler) 1.000
KeywordPlan başına KeywordPlanCampaign 1

Kitle analizi hizmeti

AudienceInsightsService yöntemlerindeki aşağıdaki yöntemler belirli kota sınırlarına tabidir.

Dönüşüm yükleme hizmeti

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

Faturalandırma ve hesap bütçesi hizmetleri

  • Değişiklikler yalnızca aylık faturalandırma için yapılandırılmış hesaplarda yapılabilir.

    Bu sınırlamayı ihlal eden istekler, MUTATE_NOT_ALLOWED hatasıyla reddedilir.

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

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

  • Aynı hesapta bütçe siparişi değişiklikleri arasında en az 12 saat beklemeniz gerekir. 12 saat geçmeden değişiklik yapılması, 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ılma ihtimali vardır. Bu nedenle, bu özelliğin davranışıyla ilgili 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.

Bunu zorunlu kılmak için bir 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.

İşlem sayısından bağımsız olarak en fazla 100.000 kullanıcı tanımlayıcısına izin verilir.

Diğer sınır türleri

İsteklerde çok fazla öğe içeren işlemler listesi gibi yinelenen bir alan şu hataya neden olabilir: REQUEST_SIZE_LIMIT_EXCEEDED. Aynı hata mesajı başka sorunlardan da kaynaklanabilir.

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

GAQL sorgusu oluştururken IN ifadesindeki 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ı