Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, sık karşılaşılan hatalar listelenmiş ve bunların önlenmesi ve ele alınmasıyla ilgili ipuçları verilmiştir. Hataların tam listesi için hata referanslarını inceleyin. Daha fazla destek için forumumuzu ziyaret edin.
google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
Özet
OAuth 2.0 erişim jetonunda gerekli kapsamlar yok.
Genel nedenler
Sağlanan erişim jetonu Google Ads API OAuth 2.0 kapsamını içermediği için istek reddedildi.
Nasıl ele alınır?
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 kapsamları içeren 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 kapsamlarla 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 izinleri uygulamanız gerekebilir.
google.auth.exceptions.RefreshError
invalid_grant
Özet
Jetonun süresi dolmuş veya jeton iptal edilmiş.
Genel nedenler
Harici bir kullanıcı türü için yapılandırılmış bir OAuth kullanıcı rızası ekranı ve Testing yayın durumu olan bir Google Cloud Platform projesine 7 gün içinde süresi dolacak bir yenileme jetonu verilir.
Nasıl ele alınır?
Google projenizin yayınlama durumu Testing olduğundan yenileme jetonunun süresi 7 günde bir dolar ve invalid_grant hatası alırsınız. 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 bu talimatları uygulayarak yayınlama durumunu In production olarak değiştirin.
Reklamın status özelliği dışındaki özellikleri değiştirmeye çalışma
Nasıl ele alınır?
Yok
Korunmayla ilgili ipuçları
Oluşturulan reklamlar değiştirilemez. Reklamda değişiklik yapmak istiyorsanız yeni bir reklam oluşturmanız ve eskisini 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 kullanılması
Nasıl ele alınır?
Yok
Korunmayla ilgili ipuçları
API isteğini göndermeden önce uygulamanızdaki URL'leri doğrulayın.
LINE_TOO_WIDE
Özet
Reklamdaki alanlardan biri izin verilen maksimum uzunluktan uzundu. Metin reklamlar hakkında başlıklı makaleyi inceleyin.
Genel nedenler
Metin satırının çok uzun olması.
Nasıl ele alınır?
Yok
Korunmayla ilgili ipuçları
API isteğini göndermeden önce satırın uzunluğunu doğrulayın.
Bir reklam grubu eklenirken veya yeniden adlandırılırken ad başka bir reklam grubu tarafından zaten kullanılıyor.
Genel nedenler
Mevcut etkin veya duraklatılmış bir reklam grubunun adıyla yeni bir reklam grubu oluşturma.
Nasıl ele alınır?
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ılan adların listesini gösterin.
İstemci müşteri kimliği tüm çağrılar için gereklidir. Bu nedenle, HTTP başlığında bir müşteri kimliği belirttiğinizden emin olun. Bu işlemi sizin için yapan istemci kitaplıklarımızı kullanabilirsiniz.
CUSTOMER_NOT_FOUND
Özet
Başlıkta sağlanan müşteri kimliği için hesap bulunamadı.
Genel nedenler
Hesap arka uçta oluşturulmadan önce yeni oluşturulan bir hesaba erişmeye çalışmak.
Nasıl ele alınır?
İlk olarak beş dakika bekleyin, ardından 30 saniyede bir tekrar deneyin.
Korunmayla ilgili ipuçları
Hesap oluşturulduktan sonra, ilgili hesap için istek göndermeden önce birkaç dakika bekleyin.
GOOGLE_ACCOUNT_COOKIE_INVALID
Özet
İstek üstbilgisindeki erişim jetonu geçersiz veya süresi dolmuş.
Genel nedenler
Erişim jetonu geçersiz hale geldi.
Nasıl ele alınır?
Yeni bir jeton isteyin. İstemci kitaplıklarımızdan birini kullanıyorsanız jetonun nasıl yenileneceğine dair dokümanlara bakın.
Korunmayla ilgili ipuçları
Erişim jetonlarını, geçerlilik süreleri dolana kadar depolayı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şkili değil.
Genel nedenler
Sağladığınız giriş bilgileri, Google Ads'in etkin olmadığı bir Google Hesabı'na karşılık geliyor.
Nasıl ele alınır?
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çarak, söz konusu müşteri veya yönetici hesabını seçerek, Tools and Settings > Access and security'e giderek ve ardından Google Hesabı e-posta adresini ekleyerek de 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 üst bilgisiyle iletilen erişim jetonunuz doğru değildi.
Nasıl ele alınır?
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şebilecek bir kimlik bilgisi edinmek istiyorsanız yönetici hesabı için yeniden yenileme jetonunu aldığınızdan emin olun. Daha fazla bilgi için erişim jetonu ve yenileme jetonu ile OAuth2 ile ilgili kılavuzumuza göz atın.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
Özet
Geliştirici jetonu zaten bir Google Cloud kuruluşuyla ilişkilendirilmiş olduğundan başka bir kuruluşla ilişkilendirilemez.
Genel nedenler
Geliştirici jetonu, ilk olarak istek yapmak için kullanılan Google Cloud projesiyle aynı Google Cloud kuruluşundaki bir Google Cloud projesiyle ilişkili değil.
Nasıl ele alınır?
Geliştirici jetonuyla API istekleri gönderdiyseniz OAuth istemci kimliğinin, aynı Google Cloud kuruluşundaki Google Cloud projeleriyle ilişkilendirildiğinden emin olun.
Korunmayla ilgili ipuçları
Tüm Google Cloud projelerinizin aynı Google Cloud kuruluşuyla ilişkili olduğundan emin olun. Bir Google Cloud projesi yalnızca bir geliştirici jetonuyla ilişkilendirilebilir ancak bir geliştirici jetonu kuruluştaki birden fazla projeyle ilişkilendirilebilir.
Etkin durumda olmadığı için müşteri hesabına erişilemez.
Genel nedenler
Bu durum, müşteri hesabı kayıt işlemini tamamlamamışsa veya devre dışı bırakılmışsa ortaya çıkar.
Nasıl ele alınır?
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ılmış hesaplar için İptal edilmiş Google Ads hesabını yeniden etkinleştirme başlıklı makaleyi inceleyin.
Korunmayla ilgili ipuçları
Bir müşteri hesabının devre dışı bırakılıp bırakılmadığını proaktif olarak kontrol etmek için İPTAL EDİLDİ durumunu kontrol edebilirsiniz.
DEVELOPER_TOKEN_NOT_APPROVED
Özet
Geliştirici jetonu yalnızca test hesaplarıyla kullanılmak üzere onaylanmıştır ve test dışı bir hesaba erişmeye çalışılmıştır.
Genel nedenler
Test dışı bir hesaba erişmek için test geliştirici jetonu kullanıldı.
İstekte gönderilen projede geliştirici jetonuna izin verilmiyor.
Genel nedenler
Her Google API Konsolu projesi, yalnızca bir yönetici hesabından alınan geliştirici jetonuyla ilişkilendirilebilir. Google Ads API isteği gönderdiğinizde geliştirici jetonu, Google API Konsolu projesiyle kalıcı olarak eşlenir. Yeni bir Google API Konsolu projesi kullanmıyorsanız istek gönderirken DEVELOPER_TOKEN_PROHIBITED hatası alırsınız.
Nasıl ele alınır?
Yok
Korunmayla ilgili ipuçları
Yeni bir yönetici hesabı altında geliştirici jetonuna geçiş yapıyorsanız yeni yöneticinin jetonunu kullanan Google Ads API istekleri için yeni bir Google API Konsolu projesi oluşturmanız gerekir.
Yönetici hesabına erişimi olan bir kullanıcı olarak kimlik doğrulama ancak istekte login-customer-id belirtilmemesi.
Nasıl ele alınır?
Yok
Korunmayla ilgili ipuçları
Yönetici hesabı kimliği olarak login-customer-id değerini kısa çizgi olmadan (-) belirtin. İstemci kitaplıklarında bu işlem için yerleşik destek vardır.
Bir kampanya ekleniyor veya yeniden adlandırılıyor ancak ad başka bir kampanya tarafından zaten kullanılıyor.
Genel nedenler
Mevcut etkin veya duraklatılmış bir kampanyanın adıyla yeni bir kampanya oluşturma.
Nasıl ele alınır?
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ılan adların listesini gösterin.
Yeniden denemeler için üstel geri yükleme programı 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ılması gerekiyor.
Genel nedenler
Bu hata, API dahili olarak geçici bir sorunla karşılaştığında ortaya çıkar.
Nasıl ele alınır?
Yeniden denemeler için üstel geri yükleme programı 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ıyla değiştirilen yetkilendirme kodu hatalı biçimlendirilmiş.
Genel nedenler
Bu durum, istek gönderen uygulamaya erişimi zaten verilmiş bir kullanıcı için yenileme jetonu oluşturmaya çalışırken ortaya çıkar. Örneğin, bu durum Kullanıcı kimlik bilgileri oluşturma örneği aynı OAuth istemci kimlik bilgileri ve yetki veren kullanıcı için birden fazla kez çalıştırıldığında ortaya çıkabilir.
Nasıl ele alınır?
Belirli bir yetkilendiren kullanıcı ve OAuth istemci kimlik bilgisi kombinasyonu için yenileme jetonunu 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şturulması için kullanılan tüm erişim jetonlarının geçersiz kılınmasına neden olur.
Korunmayla ilgili ipuçları
Yeniden oluşturma ihtiyacını önlemek için yenileme jetonunuzu 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.
Nasıl ele alınır?
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 dokümanları 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 bir 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.
Nasıl ele alınır?
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ırlı sayıda kaynağı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: 2025-06-04 UTC."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]