Sağlanan erişim jetonu Google Ads API OAuth 2.0 kapsamını içermediği için istek reddedildi.
İtirazı yanıtlama
Erişim jetonunun gerekli kapsamları içerdiğinden emin olun. Bu hatanın yaygın bir nedeni, farklı bir OAuth kapsamı grubu kullanılarak oluşturulmuş mevcut bir erişim jetonunu yeniden kullanmanızdır. Gerekli kapsamlarla yeni bir erişim jetonunun nasıl oluşturulacağına dair örnek için OAuth yetkilendirme parametreleri bölümüne bakın.
Korunmayla ilgili ipuçları
Erişim jetonunun gerekli kapsamları içerdiğinden emin olun. Gerekli kapsamlara sahip bir erişim elde etmek için kullanıcınızın kimliğini gerekli kapsamlarla yeniden doğrulayın. Uygulamanızda birden fazla OAuth kapsamı kullanılıyorsa ayrıntılı OAuth izinleri uygulamanız gerekebilir.
google.auth.exceptions.RefreshError
invalid_grant
Özet
Jetonun süresi dolmuş veya jeton iptal edilmiş.
Genel nedenler
Harici kullanıcı türü için yapılandırılmış bir OAuth kullanıcı rızası ekranı ve Testing yayınlama durumuna sahip bir Google Cloud Platform projesine, 7 gün içinde sona erecek bir yenileme jetonu verilir.
İtirazı yanıtlama
Google projenizin yayınlama durumu Testing olduğundan yenileme jetonunun süresi 7 günde bir dolar ve invalid_grant hatası alınır. Google API Konsolu'na gidip OAuth kullanıcı rızası ekranı'na gidin. Ardından, yenileme jetonunun 7 gün içinde süresinin dolmasını önlemek için yayınlama durumunu In production olarak değiştirin.
Bu operatör, Ad sınıfının bir alt sınıfıyla kullanılamaz.
Genel nedenler
Reklamın status dışındaki özellikleri değiştirmeye çalışıyorsunuz.
İtirazı yanıtlama
Yok
Korunmayla ilgili ipuçları
Oluşturulan reklamlar değiştirilemez. Reklamı değiştirmek istiyorsanız yeni bir reklam oluşturup eski reklamı kaldırmanız gerekir. Ancak reklamın status, MutateAdGroupAds kullanılarak değiştirilebilir.
INVALID_INPUT
Özet
Bir reklamdaki alanlardan biri geçersiz karakterler içeriyor.
Genel nedenler
URL'lerde özel karakterler kullanma
İtirazı yanıtlama
Yok
Korunmayla ilgili ipuçları
API isteğinde bulunmadan önce uygulamanızdaki URL'leri doğrulayın.
LINE_TOO_WIDE
Özet
Bir reklamdaki alanlardan biri, izin verilen maksimum uzunluğu aşıyordu. Metin reklamlar hakkında başlıklı makaleyi inceleyin.
Genel nedenler
Metin satırının çok uzun olması
İtirazı yanıtlama
Yok
Korunmayla ilgili ipuçları
API isteğinde bulunmadan önce satırın uzunluğunu doğrulayın.
Bir reklam grubu ekleniyor veya yeniden adlandırılıyor ancak ad, başka bir reklam grubu tarafından zaten kullanılıyor.
Genel nedenler
Etkin veya duraklatılmış mevcut bir reklam grubunun adıyla yeni bir reklam grubu oluşturma
İtirazı yanıtlama
Hatayı günlüğe kaydedin ve kullanıcıya bir hata mesajı gösterin. İsteğe bağlı olarak benzersiz bir reklam grubu adı önerebilir veya kullanılan adların listesini gösterebilirsiniz.
HTTP başlığında bir müşteri müşteri kimliği belirtilmiyor.
İtirazı yanıtlama
Yok
Korunmayla ilgili ipuçları
Tüm çağrılar için istemci müşteri kimliği gereklidir. Bu nedenle, HTTP üstbilgisinde bir kimlik belirttiğinizden emin olun. Bu işlemi sizin için yapacak olan istemci kitaplıklarımızı kullanabilirsiniz.
Arka uçta hesap oluşturulmadan hemen önce yeni oluşturulan bir hesaba erişmeye çalışmak
İtirazı yanıtlama
Önce beş dakika bekleyin, ardından her 30 saniyede bir tekrar deneyin.
Korunmayla ilgili ipuçları
Hesap oluşturulduktan sonra istek göndermeden önce birkaç dakika bekleyin.
GOOGLE_ACCOUNT_COOKIE_INVALID
Özet
İstek başlığındaki erişim jetonu geçersiz veya süresi dolmuş.
Genel nedenler
Erişim jetonu geçersiz kılınmıştır.
İtirazı yanıtlama
Yeni bir jeton isteyin. İstemci kitaplıklarımızdan birini kullanıyorsanız jetonu nasıl yenileyeceğinizle ilgili dokümanına bakın.
Korunmayla ilgili ipuçları
Erişim jetonlarını geçerlilik süreleri dolana kadar saklayıp yeniden kullanın.
NOT_ADS_USER
Özet
Erişim jetonunu oluşturmak için kullanılan Google Hesabı herhangi bir Google Ads hesabıyla ilişkilendirilmemiş.
Genel nedenler
Sağlanan giriş bilgileri, Google Ads'in etkinleştirilmediği bir Google Hesabı'na karşılık geliyor.
İtirazı yanıtlama
OAuth akışı için geçerli bir Google Ads hesabıyla (genellikle yönetici hesabınız) oturum açtığınızdan emin olun. Yönetici hesabınızda oturum açıp söz konusu müşteri veya yönetici hesabını seçerek, Tools and Settings > Access and security bölümüne gidip Google Hesabı e-posta adresini ekleyerek Google Hesabı'nı mevcut bir Google Ads hesabına erişmeye davet edebilirsiniz.
Korunmayla ilgili ipuçları
Yok
OAUTH_TOKEN_INVALID
Özet
Başlıktaki OAuth erişim jetonu geçerli değil.
Genel nedenler
HTTP üstbilgisiyle iletilen erişim jetonunuz doğru değildi.
İtirazı yanıtlama
Yok
Korunmayla ilgili ipuçları
Hesabınızla ilişkili doğru erişim jetonunu ilettiğinizden emin olun. Bazen yenileme jetonları ve yetkilendirme kodlarıyla karıştırılır. Bir yönetici hesabı altındaki tüm müşteri hesaplarına erişebilen bir kimlik bilgisi almak istiyorsanız yönetici hesabının yenileme jetonunu aldığınızdan emin olun. Kullanıcı kimlik doğrulama kılavuzunu inceleyin.
Google Cloud projesinde yalnızca test erişimi vardır ve üretim hesaplarına erişmek için kullanılamaz.
Genel nedenler
Test erişim düzeyine sahip bir Google Cloud projesi, test dışı (üretim) bir Google Ads hesabına karşı istekte bulunmak için kullanıldı. (API'nin v24 ve önceki sürümlerinde bu koşul AuthorizationError.ACTION_NOT_PERMITTED değerini döndürür.)
Müşteri hesabı etkin durumda olmadığından erişilemiyor.
Genel nedenler
Bu durum, müşteri hesabı kaydolma işlemini tamamlamadığında veya devre dışı bırakıldığında ortaya çıkar.
İtirazı yanıtlama
Google Ads kullanıcı arayüzünde oturum açın ve bu hesap için kaydolma işlemini tamamladığınızdan emin olun. Devre dışı bırakılan hesaplar için İptal edilmiş Google Ads hesabını yeniden etkinleştirme başlıklı makaleyi inceleyin.
Korunmayla ilgili ipuçları
Müşteri hesabının devre dışı bırakılıp bırakılmadığını CANCELLED (İPTAL EDİLDİ) durumunu kontrol ederek proaktif bir şekilde öğrenebilirsiniz.
USER_PERMISSION_DENIED
Özet
Yetkili müşterinin, işlem yapan müşteriye erişimi yok.
Genel nedenler
Bir yönetici hesabına erişimi olan bir kullanıcı olarak kimlik doğrulama ancak istekte login-customer-id belirtilmiyor.
İtirazı yanıtlama
Yok
Korunmayla ilgili ipuçları
login-customer-id değerini, tire içermeyen yönetici hesabı kimliği (-) olarak belirtin. İstemci kitaplıklarında bu özellik için yerleşik destek bulunur.
Bir kampanya ekleniyor veya yeniden adlandırılıyor ancak ad başka bir kampanya tarafından kullanılıyor.
Genel nedenler
Mevcut etkin veya duraklatılmış bir kampanyanın adıyla yeni bir kampanya oluşturma
İtirazı yanıtlama
Hatayı günlüğe kaydedin ve kullanıcıya bir hata mesajı gösterin. İsteğe bağlı olarak benzersiz bir kampanya adı önerebilir veya kullanılan adların listesini gösterebilirsiniz.
Korunmayla ilgili ipuçları
Yok
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
Özet
AI Max'in etkin olduğu bir kampanyada kampanya düzeyindeki anahtar kelime eşleme türü ayarını değiştirmeye çalışıyorsanız.
Genel nedenler
AI Max etkinleştirildiğinde, tüm anahtar kelimeler varsayılan olarak geniş eşlemeli olarak değerlendirildiğinden kampanya düzeyinde geniş eşleme ayarları kullanımdan kaldırılır. Bu alanı ayarlamaya veya değiştirmeye çalışmak hataya neden olur.
İtirazı yanıtlama
Kullanıcıya, kampanya düzeyinde geniş eşleme ayarlamak yerine reklam grubu düzeyinde `disable_search_term_matching` parametresini kullanmasını önerin.
Korunmayla ilgili ipuçları
`ai_max_setting.enable_ai_max` değeri `true` olarak ayarlanmışsa kampanyada `keyword_match_type` değerini `BROAD` (veya başka bir değer) olarak ayarlamayın. `disable_search_term_matching` kullanarak arama terimi eşleştirmeyi reklam grubu düzeyinde etkinleştirin veya devre dışı bırakın.
Yeniden denemeler için eksponansiyel geri yükleme planı kullanarak bu hatayla başarısız olan tüm istekleri yeniden deneyin.
Korunmayla ilgili ipuçları
Yok
TRANSIENT_ERROR
Özet
Geçici bir dahili hata oluştu ve yeniden deneme yapılmalıdır.
Genel nedenler
Bu hata, API dahili olarak geçici bir sorunla karşılaştığında oluşur.
İtirazı yanıtlama
Yeniden denemeler için eksponansiyel geri yükleme planı kullanarak bu hatayla başarısız olan tüm istekleri yeniden deneyin.
Korunmayla ilgili ipuçları
Yok
InvalidGrantError
invalid_grant (malformed auth code)
Özet
OAuth jetonları için değiş tokuş yapılan yetkilendirme kodu hatalıydı.
Genel nedenler
Bu durum, istekte bulunan uygulamaya erişim izni verilmiş bir kullanıcı için yenileme jetonu oluşturulmaya çalışıldığında meydana gelir. Örneğin, bu durum aynı OAuth istemci kimlik bilgileri ve yetkilendirme kullanıcısı için Generate User credentials example (Kullanıcı kimlik bilgileri oluşturma örneği) birden fazla kez çalıştırıldığında ortaya çıkabilir.
İtirazı yanıtlama
Belirli bir yetkilendirme kullanıcısı ve OAuth istemci kimlik bilgileri kombinasyonu için yenileme jetonu yeniden oluşturmak üzere mevcut bir yenileme jetonunu iptal edin. Bir jetonun iptal edilmesi, jetonun Google Ads API erişimi için kullanılamaz hale gelmesine ve yenileme jetonunun oluşturmak için kullanıldığı tüm erişim jetonlarının geçersiz kılınmasına neden olur.
Korunmayla ilgili ipuçları
Yenileme jetonunuzu yeniden oluşturmanız gerekmemesi için güvenli bir yerde sakladığınızdan emin olun.
İstek, mevcut olmayan veya kaldırılmış bir kaynağı değiştirmeye ya da başka bir şekilde referans vermeye çalıştı. Alternatif olarak, kaynak için verilen kaynak adı hatalı olabilir.
İtirazı yanıtlama
Bir değiştirme isteği göndermeden önce mevcut bir kaynağın kaynak adını almak için arama isteği kullanın. Desteklenen her dilde geçerli kaynak adlarının nasıl oluşturulacağıyla ilgili belgeleri içeren istemci kitaplığı kılavuzlarımızı inceleyin.
Korunmayla ilgili ipuçları
Kaynak adlarını manuel olarak oluşturmayın. İstemci kitaplıklarımız tarafından sunulan yardımcı yöntemlerden birini kullanın.
İstek, bu kaynakların toplam sayısının belirtilen sınırı aşmasına neden olacak bir kaynak oluşturmaya çalışıyor.
Genel nedenler
Belirli bağlamlarda bulunabilecek kaynak sayısıyla ilgili birden fazla sınır vardır.
İtirazı yanıtlama
Sistem sınırları'nı inceleyerek karşılaşılan sınırı belirleyin. Mevcut bir kaynağı yeniden kullanın veya yeni kaynaklar için yer açmak üzere kaynakları kaldırın.
Korunmayla ilgili ipuçları
Sınırlamaları olan kaynakların sayısını izlemek için arama sorgularını kullanın.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2026-09-29 UTC."],[],[]]
