Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, sık karşılaşılan hatalar listelenmekte ve bu hataların önlenmesi ve ele alınmasıyla ilgili ipuçları verilmektedir.
Hataların tam listesi için hata referansları bölümü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 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ğıyla ilgili örnek için OAuth yetkilendirme parametreleri başlıklı makaleyi inceleyin.
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ız birden fazla OAuth kapsamı kullanıyorsa Ayrıntılı OAuth izinleri'ni 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 Google Cloud Platform projesine, 7 gün içinde sona erecek 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ınır. Google API Konsolu'na gidip OAuth izin 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.
HTTP üstbilgisinde bir müşteri kimliği belirtilmemesi.
Nasıl ele alınır?
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 yapan istemci kitaplıklarımızı kullanabilirsiniz.
CUSTOMER_NOT_FOUND
Özet
Başlıkta belirtilen müşteri kimliği için hesap bulunamadı.
Genel nedenler
Arka uçta hesap oluşturulmadan hemen önce yeni oluşturulan bir hesaba erişmeye çalışıyorsanız.
Nasıl ele alınır?
Ö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ındı.
Nasıl ele alınır?
Yeni bir jeton isteyin. Müşteri kitaplıklarımızdan birini kullanıyorsanız jetonu nasıl yenileyeceğinizle ilgili olarak ilgili kitaplığın belgelerine bakın.
Korunmayla ilgili ipuçları
Erişim jetonlarını geçerlilik süreleri dolana kadar saklayıp yeniden kullanabilirsiniz.
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.
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. 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
Üst bilgideki OAuth erişim jetonu geçerli değil.
Genel nedenler
HTTP üstbilgisiyle 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. Erişim jetonları 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ı için yenileme jetonu aldığınızdan emin olun. Daha fazla bilgi için Erişim jetonu ve yenileme jetonu ile OAuth2 hakkındaki kılavuzumuza göz atın.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
Özet
Geliştirici jetonu zaten bir Google Cloud kuruluşuyla ilişkilendirilmiştir ve başka bir kuruluşla ilişkilendirilemez.
Genel nedenler
Geliştirici jetonu, başlangıçta istek göndermek için kullanılan Google Cloud projesiyle aynı Google Cloud kuruluşundaki bir Google Cloud projesiyle ilişkilendirilmemiş.
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şkilendirildiğinden emin olun. Google Cloud projeleri yalnızca bir geliştirici jetonuyla ilişkilendirilebilir ancak geliştirici jetonları kuruluştaki birden fazla projeyle ilişkilendirilebilir.
DEVELOPER_TOKEN_INVALID
Özet
Geliştirici jetonu geçersiz.
Genel nedenler
Bu hatanın yaygın nedenleri arasında geliştirici jetonundaki yazım hataları veya geliştirici jetonunun farklı bir istek başlığında yanlış ayarlanması yer alır.
Nasıl ele alınır?
Yazım hatalarını önlemek için geliştirici jetonunu API merkezinden kopyaladığınızdan emin olun. API merkezini Google Ads yönetici hesabınızda bulabilirsiniz. Ayrıca, geliştirici jetonunu doğru başlığa ayarladığınızdan emin olun. Geliştirici jetonları bazen OAuth yenileme jetonları ve yetkilendirme kodlarıyla karıştırılır. Farklı istek başlıkları hakkında daha fazla bilgiyi burada bulabilirsiniz.
Müşteri hesabı etkin durumda olmadığından erişilemiyor.
Genel nedenler
Bu durum, müşteri hesabı kayıt işlemini tamamlamadığında veya devre dışı bırakıldığında 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ı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.
DEVELOPER_TOKEN_NOT_APPROVED
Özet
Geliştirici jetonu yalnızca test hesaplarıyla kullanım için onaylanmıştır ve test dışı bir hesaba erişilmeye çalışılmıştır.
Genel nedenler
Test dışı bir hesaba erişmek için test geliştirici jetonu kullanıldı.
Geliştirici jetonuna, istekte gönderilen projeyle izin verilmiyor.
Genel nedenler
Her Google API Konsolu projesi yalnızca bir yönetici hesabının geliştirici jetonuyla ilişkilendirilebilir. Google Ads API isteğinde bulunduğunuzda geliştirici jetonu, Google API Konsolu projesiyle kalıcı olarak eşlenir. Yeni bir Google API Konsolu projesi kullanmazsanız istekte bulunduğunuzda 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ındaki 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.
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.
Nasıl ele alınır?
Yok
Korunmayla ilgili ipuçları
Yönetici hesabı kimliği olarak login-customer-id değerini tire olmadan (-) belirtin. İstemci kitaplıklarında bu destek yerleşiktir.
[[["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-09-05 UTC."],[[["\u003cp\u003eThis page provides solutions and preventative measures for common Google Ads API errors.\u003c/p\u003e\n"],["\u003cp\u003eFor a comprehensive list of errors, refer to the dedicated error references section.\u003c/p\u003e\n"],["\u003cp\u003eAdditional assistance and community support can be found on the Google Ads API forum.\u003c/p\u003e\n"],["\u003cp\u003eUnderstanding and addressing these errors is crucial for successful API integration and campaign management.\u003c/p\u003e\n"]]],[],null,[]]
