Google Ads API, API işlemleriyle ilgili sınırlamalar uygular (ör. tek bir değiştirme isteğinde gönderilebilecek işlem sayısı). 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 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 isteklerinin 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ı özetlenmiştir.
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. Varsayılan olarak gRPC'nin 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ı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ırı aşmamak için seçili 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ırı 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 hususlar 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 göre 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
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 sayfa jetonu içeren sayfalara ayırma istekleri 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 sayfalama başlıklı makaleyi inceleyin.
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:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
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.
CID başına saniyede 1 istekle sınırlıdır:
KeywordPlanIdeaService.GenerateKeywordIdeas
KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
Bu sınırlamaları ihlal eden istekler,
RESOURCE_EXHAUSTED
hatasıyla reddedilir.1 QPS, 60 saniyede 60 istek olarak hesaplanır.
CID başına saniyede 2 istekle sınırlıdı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 |
KeywordPlan başına KeywordPlanAdGroup |
200 |
KeywordPlan başına KeywordPlanAdGroupKeyword |
10.000 |
KeywordPlanCampaignKeyword (negatif anahtar kelimeler) |
1.000 |
KeywordPlan başına KeywordPlanCampaign |
1 |
Dönüşüm yükleme hizmeti
İstek başına 2.000 arama veya tıklama dönüşümüyle sınırlıdır:
Bu sınırları ihlal eden istekler,
TOO_MANY_CONVERSIONS_IN_REQUEST
hatasıyla reddedilir.
Dönüşüm ayarlama yükleme hizmeti
İstek başına 2.000 dönüşüm ayarlaması ile sınırlıdır:
Bu sınırları ihlal eden istekler,
TOO_MANY_ADJUSTMENTS_IN_REQUEST
hatasıyla reddedilir.
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ırı 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ı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ışıyla ilgili sınırlamalar vardır:
Kullanıcılar aynı müşteri hesabı için birden fazla bekleyen davetiye alamaz. Beklemedeki davetiyesi olan bir kullanıcıya davetiye göndermek için daha sonra tekrar istek yapılırsa şu hata döndürülür:
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION
.Müşteri hesaplarında aynı anda bekleyen 70'den fazla davetiye bulunamaz. 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 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
varsa 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 kaynaklanabilir.
Bu sınırla karşılaşırsanız ve yinelenen bir alan kullanan istekler gönderiyorsanız bir değiştirme isteğinde işlem listesi dağıtarak yinelenen alandaki öğe sayısını azaltmayı deneyin.
GAQL sorgusu oluştururken bir IN
yan tümcesinde 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.