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.
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.
[[["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."],[],[]]
