API Sınırları ve Kotaları

Google Ads API, API işlemleri üzerinde işlem sayısı gibi sınırlamalar uygular. tek bir değişiklik isteğinde gönderilebilir. Aşağıdaki tabloda bazı önemli sınırlar ve kotalar bulunuyor.

İ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şime Sahip İşlemler Günde 15.000 API işlemi RESOURCE_EXHAUSTED
İstekleri değiştirme İ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 Hizmet istekleri Değişim 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ı, Google Cloud Platform'un sunduğu API işlem sayısı. API işlemleri, get istekleri ile mutate işlemlerinin toplamıdır. Sınırlar günlük API işlemleri, geliştirici jetonunun erişim düzeyine bağlıdır. İlgili içeriği oluşturmak için kullanılan Erişim Düzeyleri ve İzin Verilen Kullanım kılavuzu, Her erişim düzeyi için özel API işlem sınırları.

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

gRPC sınırlamaları

Tüm Google Ads API istemci kitaplıkları, İstek ve yanıt oluşturmak için gRPC. Varsayılan olarak gRPC, dosya boyutu 4 MB'tır, ancak istemci kitaplıklarımız maksimum ileti boyutunu Verimliliği artırmak için 64 MB.

Yanıtlar bu sınırı aşmamalıdır. Örneğin, eklemek, boyutu 64 MB'ı aşan bir yanıt oluşturabilir. Alıcı: Bu sınırdan kaçınmak için, seçilen alanların sayısını ve sayfayı azaltabilirsiniz. akış özelliğini kullanın. Değişiklikler için daha az gönderin işlem sayısı.

Bu sınırlamayı ihlal eden istekler oluşturulmaz GoogleAdsError; ancak şunlar oluşturur: 429 Resource Exhausted gRPC hatası. gRPC hata kodları listesine ve mesajlar bölümüne gidin.

İstekleri değiştirme

Kullanıcının günlük işlem kotasına ek olarak, isteği,istek başına 10.000'den fazla işlem içeremez.

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

Belirli hizmetler ve istek türleri için ek sınırlar ve dikkat edilmesi gereken noktalar: öğrenebilirsiniz.

Arama istekleri

Search veya SearchStream isteği, kullanıcının isteğine karşı bir işlem olarak sayılır. günlük işlem kotası. Bir SearchStream isteği bir API işlemi olarak sayılır fark yaratır.

Sayfalara ayrılmış istekler

Sayfalara ayrılmış istekler (örneğin, geçerli bir next_page_token) 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.

Arama istekleri gibi sayfalara ayrılan istekler de Page size cannot exceed 10,000 rows sınırlama ve ihlalde bulunması durumunda reddedilir şu hata mesajını verir: INVALID_PAGE_SIZE.

Sayfalara ayırma hakkında daha fazla bilgi için Sayfalara ayırma sonuçları başlıklı makaleye göz atı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ından tek bir işlem olarak sayılır.

Bu tür taleplerin birkaç örneği aşağıda verilmiştir:

API istisnaları döndüren istekler

GoogleAdsFailure, kullanıcının günlük işlem kotası.

Başarısız olan ancak sonuç döndürmeyen istekler GoogleAdsFailure; örneğin şu adresteki bir hatadan: kullanıcının günlük işlem kotasına dahil edilmez. çünkü istekler hizmete hiçbir zaman ulaşmayacak. Buna örnek olarak ağ bağlantısı hatası.

Planlama hizmetleri

Maliyet ve karmaşıklık nedeniyle aşağıda listelenen Planlama hizmeti yöntemleri şunlardır: 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 ayarlama yükleme hizmeti

Faturalandırma ve hesap bütçesi hizmetleri

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

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

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

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

  • Bütçe talimatı değişiklikleri ile yeni bir bütçe ekleyebilirsiniz. 12 saat dolmadan değişiklik yaparsanız değişiklik şunlara neden olabilir: yalnızca Google Ads hesabınız tarafından giderilebilecek düzeltilemeyen hatalar temsil eder.

Müşteri hesabı davetiyeleri

Yeni kullanıcılar, şununla mevcut müşteri hesaplarına davet edilebilir: CustomerUserAccessService. Çünkü diğer kullanıcılara davetiye e-postaları gönderdiğinde bu işlev, olduğunu ve bu nedenle davranışıyla ilgili sınırlamalar olduğunu lütfen unutmayın:

Kullanıcı verileri

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

Bunu zorunlu kılmak için OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS veya UserDataError.TOO_MANY_USER_IDENTIFIERS 20'den fazla user_identifiers olduğunda hata döndürülür UserData set.

Diğer sınır türleri

Bir işlem listesinde çok fazla öğeye sahip, işlem listesi gibi tekrarlanan bir alan şu hataya neden olabilir: REQUEST_SIZE_LIMIT_EXCEEDED. Aynı hata mesajı, başka sorunlardan da kaynaklanıyor olabilir.

Bu sınırlamayla karşılaşıyorsanız ve tekrarlanan alanına, bir değiştirme isteğindeki işlemlerin listesidir.

GAQL sorgusu yapılırken, maksimum öğe sayısı değer 20.000'dir.IN 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ı