OAuth 2.0 erişim jetonu gerekli kapsamlara sahip değil.
Genel nedenler
Sağlanan erişim jetonu Google Ads API OAuth 2.0 kapsamını içermediğinden istek reddedildi.
İtirazı yanıtlama
Erişim jetonunun gerekli kapsamlara sahip olduğundan 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 kapsamlara sahip yeni bir erişim jetonunun nasıl oluşturulacağına dair bir örnek için OAuth yetkilendirme parametreleri bölümüne bakın.
Korunmayla ilgili ipuçları
Erişim jetonunun gerekli kapsamlara sahip olduğundan 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ız birden fazla OAuth kapsamı kullanıyorsa ayrıntılı OAuth izinlerini 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 durumu olan bir Google Cloud Platform projesine, 7 gün içinde süresi dolacak bir yenileme jetonu verilir.
İtirazı yanıtlama
Google projenizin yayınlama durumu Testing olduğundan yenileme jetonunun süresi her 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 geçerliliğini yitirmesini önlemek için yayınlama durumunu In production olarak değiştirin.
Bu operatör, Ad'in bir alt sınıfıyla kullanılamaz.
Genel nedenler
Reklamın status dışındaki özelliklerini değiştirmeye çalışıyorsunuz.
İtirazı yanıtlama
Yok
Korunmayla ilgili ipuçları
Reklam oluşturulduktan sonra değiştirilemez. Reklamı değiştirmek istiyorsanız yeni bir reklam oluşturup eski reklamı kaldırmanız gerekir. Ancak reklamın status alanı, 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şıyor. 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ğini göndermeden ö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 kullanılıyor.
Genel nedenler
Mevcut etkin veya duraklatılmış 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ı önerin veya kullanımda olan adların listesini gösterin.
Tek bir istekteki iki işlem, aynı ikili verilere sahip bir öğe için oluşturma işlemi içeriyor.
Genel nedenler
Aynı ikili verileri içeren yinelenen oluşturma işlemlerine sahip bir değişiklik isteği.
İtirazı yanıtlama
Öğeyi ayrı bir istekte oluşturup sonraki istekte öğeye bağlantı verin veya aynı istekte geçici ID kullanın.
Korunmayla ilgili ipuçları
Yok
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE
Özet
İş ortağı promosyon kodu, hesabın promosyon entegrasyonunun kabul etmediği bir oneof varyantı (int_value veya string_value) kullanıyor.
Genel nedenler
Müşterinin kullanım entegrasyonu string_value varyantını gerektirdiğinde promotion_asset.external_redeem_info.partner_promotion_id.int_value alanını ayarlama veya entegrasyon int_value varyantını gerektirdiğinde string_value alanını ayarlama.
İtirazı yanıtlama
Oluşturma isteğini, hesabın promosyon entegrasyonu tarafından kabul edilen ExternalPartnerId varyantını (int_value veya string_value) dolduracak şekilde güncelleyin. Ayrıntılar için Harici promosyon kullanımlarını izleme başlıklı makaleyi inceleyin.
Korunmayla ilgili ipuçları
external_redeem_info alanını içeren bir PromotionAsset mesajı oluşturmadan önce satış noktası (POS) kullanım entegrasyonunuzun hangi promosyon tanımlayıcı biçimini (int_value veya string_value) kullandığını onaylayın.
Müşteri kimliği tüm çağrılar için gereklidir. Bu nedenle, HTTP üstbilgisinde bir müşteri kimliği belirttiğinizden emin olun. Bu işlemi sizin yerinize gerçekleştiren istemci kitaplıklarımızı kullanabilirsiniz.
CUSTOMER_NOT_FOUND
Özet
Başlıkta belirtilen müşteri kimliği için hesap bulunamadı.
Genel nedenler
Yeni oluşturulan bir hesaba, hesap arka uçta oluşturulmadan önce erişmeye çalışmak.
İtirazı yanıtlama
İlk olarak 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 jetonun süresi dolmuş.
Genel nedenler
Erişim jetonu geçersiz kılındı.
İtirazı yanıtlama
Yeni bir jeton isteyin. İstemci kitaplıklarımızdan birini kullanıyorsanız jetonun nasıl yenileneceğiyle ilgili belgeleri inceleyin.
Korunmayla ilgili ipuçları
Erişim jetonlarını, geçerlilik süreleri dolana kadar saklayıp tekrar kullanın.
NOT_ADS_USER
Özet
Erişim jetonunu oluşturmak için kullanılan Google Hesabı, herhangi bir Google Ads hesabıyla ilişkili değil.
Genel nedenler
Sağlanan giriş bilgileri, Google Ads'in etkinleştirilmediği bir Google Hesabı'na ait.
İ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. Ayrıca, 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
Üstbilgideki 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ının 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 projesinin yalnızca test erişimi vardır ve üretim hesaplarına erişmek için kullanılamaz.
Genel nedenler
Test amaçlı olmayan (üretim) bir Google Ads hesabına istek göndermek için test erişim düzeyine sahip bir Google Cloud projesi kullanıldı. (API'nin v24 ve önceki sürümlerinde bu koşul AuthorizationError.ACTION_NOT_PERMITTED değerini döndürür.)
Etkin durumda olmadığı için müşteri hesabına erişilemiyor.
Genel nedenler
Bu durum, müşteri hesabı kaydı tamamlanmadığı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 kayıt 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ı
CANCELLED durumunu kontrol ederek bir müşteri hesabının devre dışı bırakılıp bırakılmadığını proaktif olarak kontrol edebilirsiniz.
USER_PERMISSION_DENIED
Özet
Yetkili müşterinin, işlem yapan müşteriye erişimi yok.
Genel nedenler
Yönetici hesabına erişimi olan bir kullanıcı olarak kimlik doğrulaması yapılıyor ancak istekte login-customer-id belirtilmiyor.
İtirazı yanıtlama
Yok
Korunmayla ilgili ipuçları
login-customer-id değerini, kısa çizgi (-) olmadan yönetici hesabı kimliği olarak belirtin. İstemci kitaplıklarında bunun 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ı önerin veya kullanımda olan adların listesini gösterin.
Korunmayla ilgili ipuçları
Yok
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
Özet
Maksimum Yapay Zeka'nın etkin olduğu bir kampanyada kampanya düzeyindeki anahtar kelime eşleme türü ayarı değiştirilmeye çalışılıyor.
Genel nedenler
Maksimum Yapay Zeka etkinleştirildiğinde, tüm anahtar kelimeler varsayılan olarak geniş eşleme olarak değerlendirildiğinden kampanya düzeyindeki geniş eşleme ayarları kullanımdan kaldırılır. Bu alanı ayarlamaya veya değiştirmeye çalışmak hatayı tetikler.
İ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 reklam grubu düzeyinde arama terimi eşleştirmeyi açın veya kapatın.
Taşınan bir Talep Yaratma kampanyası, orijinal kampanya kaldırılmadan veya aynı orijinal kampanya için taşınan başka bir kampanya etkin durumdayken etkinleştirilemez.
Genel nedenler
Taşınan bir Talep Yaratma kampanyasının status değerini ENABLED olarak güncellemek için orijinal kaynak kampanyanın kaldırılmamış olması veya aynı orijinal kampanyadan taşınan başka bir Talep Yaratma kampanyasının zaten ENABLED olması gerekir. API'nin v25 ve önceki sürümlerinde bu koşul RequestError.UNKNOWN değerini döndürür.
İtirazı yanıtlama
Taşınan Talep Yaratma kampanyasını etkinleştirmeden önce CampaignOperation.remove kullanarak orijinal kaynak kampanyayı kaldırın (önceden veya aynı değişiklik isteğinde) ve aynı orijinal kampanyadan taşınan başka bir Talep Yaratma kampanyasının etkin olmadığından emin olun. Ayrıntılar için Taşınan kampanyaları etkinleştirme bölümüne bakın.
Korunmayla ilgili ipuçları
Orijinal kaynak kampanyalarınızın ve taşınan Talep Yaratma kampanyalarının kimliklerini izliyorsanız taşınan bir kampanyada status değerini ENABLED olarak ayarlamadan önce campaign.status sorgusu yapın veya aynı değişiklik isteğine orijinal kampanya için CampaignOperation.remove değerini ekleyin.
Bu hatayla başarısız olan istekleri, yeniden denemeler için eksponansiyel geri yükleme planı kullanarak tekrar deneyin.
Korunmayla ilgili ipuçları
Yok
TRANSIENT_ERROR
Özet
Geçici bir dahili hata oluştu ve yeniden deneme yapılması gerekiyor.
Genel nedenler
Bu hata, API'de geçici bir sorun oluştuğunda ortaya çıkar.
İtirazı yanıtlama
Bu hatayla başarısız olan istekleri, yeniden denemeler için eksponansiyel geri yükleme planı kullanarak tekrar deneyin.
Korunmayla ilgili ipuçları
Yok
InvalidGrantError
invalid_grant (malformed auth code)
Özet
OAuth jetonları için değiştirilen yetkilendirme kodu hatalı biçimlendirilmiş.
Genel nedenler
Bu durum, istekte bulunan uygulamaya erişim izni verilmiş bir kullanıcı için yenileme jetonu oluşturmaya çalışıldığında meydana gelir. Örneğin, aynı OAuth istemci kimlik bilgileri ve yetkilendirme kullanıcısı için Kullanıcı kimlik bilgileri oluşturma örneği birden fazla kez çalıştırıldığında bu durum ortaya çıkabilir.
İtirazı yanıtlama
Belirli bir yetkilendirme kullanıcısı ve OAuth istemci kimlik bilgileri kombinasyonu için yenileme jetonunu yeniden oluşturmak üzere mevcut bir yenileme jetonunu iptal edin. Bir jetonun iptal edilmesi, 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 güvenli bir yerde saklayarak yeniden oluşturma ihtiyacını ortadan kaldırın.
İstek, mevcut olmayan veya kaldırılmış bir kaynağı değiştirmeye ya da başka bir şekilde referans vermeye çalıştı. Alternatif olarak, kaynağın kaynak adı hatalı biçimlendirilmiş olabilir.
İtirazı yanıtlama
Değişiklik isteği göndermeden önce mevcut bir kaynağın 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, toplam kaynak 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 kaynaklara yer açmak için 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-10-30 UTC."],[],[]]
