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:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
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.
Müşteri kimliği veya geliştirici jetonu başına saniyede 1 istekle sınırlıdır:
KeywordPlanService.GetKeywordPlan
KeywordPlanService.GenerateHistoricalMetrics
KeywordPlanService.GenerateForecastMetrics
Bu sınırlamaları ihlal eden istekler şu hatayla reddedilir:
RESOURCE_EXHAUSTED
.1 QPS, 60 saniye başına 60 istek olarak hesaplanır.
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
İstek başına 2.000 telefon araması veya tıklama dönüşümüyle sınırlıdır:
Bu sınırları ihlal eden istekler şu hatayla birlikte reddedilir:
TOO_MANY_CONVERSIONS_IN_REQUEST
.
Dönüşüm ayarlaması yükleme hizmeti
İstek başına 2.000 dönüşüm ayarlamasıyla sınırlıdır:
Bu sınırları ihlal eden istekler şu hatayla birlikte reddedilir:
TOO_MANY_ADJUSTMENTS_IN_REQUEST
.
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ılar, aynı müşteri hesabı için birden fazla bekleyen davetiye alamaz. Bekleyen bir davetiyesi olan bir kullanıcıya davetiye göndermek için sonraki bir istekte bulunursa şu hata döndürülür:
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION
.Müşteri hesaplarında tek seferde bekleyen 70'ten fazla davetiye olamaz. Bu değerin aşılmasına neden olan bir istek gönderilirse şu hata döndürülür:
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED
.
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.