Yaygın Hatalar
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.
|
|---|
| Korunmayla ilgili ipuçları |
Doğrulanmamış uygulamalar başlıklı makaleyi inceleyin.
|
|---|
|
|
CLIENT_CUSTOMER_ID_INVALID |
| Özet | Müşteri kimliği sayı değil. |
|---|
| Genel nedenler |
Uygun olmayan bir istemci müşteri kimliği kullanıyorsanız.
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
123-456-7890, 1234567890 olmalıdır. Ayrıntılar için Başlangıç başlıklı makaleyi inceleyin.
|
|---|
|
CLIENT_CUSTOMER_ID_IS_REQUIRED |
| Özet | İstemci müşteri kimliği, HTTP üstbilgisinde belirtilmedi. |
|---|
| Genel nedenler |
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.
|
|---|
| Korunmayla ilgili ipuçları |
Yok
|
|---|
|
|
CUSTOMER_NOT_ENABLED |
| Özet | 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 |
|
DEVELOPER_TOKEN_PROHIBITED |
| Özet | 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.
|
|---|
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-31 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,[]]
