Yaygın görülen hatalar

Bu rehberde, yaygın API hataları listelenmekte ve bu hataları önleme ve ele alma stratejileri sunulmaktadır.

Tüm hata türlerinin kapsamlı bir listesi için Google Ads API hata referansına bakın. Daha fazla yardıma ihtiyacınız olursa Google Ads API forumunda soru sorabilirsiniz.

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT
ÖzetOAuth 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.
İtirazı yanıtlama 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ğına dair örnek için OAuth yetkilendirme parametreleri bölümüne bakın.
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ızda birden fazla OAuth kapsamı kullanılıyorsa ayrıntılı OAuth izinleri uygulamanız gerekebilir.

google.auth.exceptions.RefreshError

invalid_grant
ÖzetJetonun 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 durumuna sahip bir Google Cloud Platform projesine, 7 gün içinde sona erecek bir yenileme jetonu verilir.
İtirazı yanıtlama 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 kullanıcı rızası ekranı'na gidin. Ardından, yenileme jetonunun 7 gün içinde süresinin dolmasını önlemek için yayınlama durumunu In production olarak değiştirin.
Korunmayla ilgili ipuçları Doğrulanmamış uygulamalar başlıklı makaleye göz atın.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
Özetİstemci müşteri kimliği sayı değil.
Genel nedenler Uygun olmayan bir müşteri kimliği kullanıyorsanız.
İtirazı yanıtlama 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 başlığında belirtilmedi.
Genel nedenler HTTP başlığında bir müşteri müşteri kimliği belirtilmiyor.
İtirazı yanıtlama 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 yapacak olan istemci kitaplıklarımızı kullanabilirsiniz.
CUSTOMER_NOT_FOUND
ÖzetBaşlıkta belirtilen müşteri kimliğiyle ilişkili hesap bulunamadı.
Genel nedenler Arka uçta hesap oluşturulmadan hemen önce yeni oluşturulan bir hesaba erişmeye çalışmak
İtirazı yanıtlama Ö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.
Özetİstek başlığındaki erişim jetonu geçersiz veya süresi dolmuş.
Genel nedenler Erişim jetonu geçersiz kılınmıştır.
İtirazı yanıtlama Yeni bir jeton isteyin. İstemci kitaplıklarımızdan birini kullanıyorsanız jetonu nasıl yenileyeceğinizle ilgili dokümanına bakın.
Korunmayla ilgili ipuçları Erişim jetonlarını geçerlilik süreleri dolana kadar saklayıp yeniden kullanın.
NOT_ADS_USER
ÖzetEriş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.
İ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. 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
ÖzetBaşlıktaki 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ı 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.

AuthorizationError

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
ÖzetGoogle Cloud projesinde yalnızca test erişimi vardır ve üretim hesaplarına erişmek için kullanılamaz.
Genel nedenler Test erişim düzeyine sahip bir Google Cloud projesi, test dışı (üretim) bir Google Ads hesabına karşı istekte bulunmak için kullanıldı. (API'nin v24 ve önceki sürümlerinde bu koşul AuthorizationError.ACTION_NOT_PERMITTED değerini döndürür.)
İtirazı yanıtlama Test yapıyorsanız isteğinizin test hesabını hedeflediğinden emin olun. Bir üretim Google Ads hesabına erişmek istiyorsanız Google Ads API'ye Genel Bakış sayfasında Google Cloud projenizin erişim düzeyini kontrol edin ve projenizin erişim düzeyini Explorer, Basic veya Standard erişime yükseltin.
Korunmayla ilgili ipuçları Yok
CUSTOMER_NOT_ENABLED
ÖzetMüşteri hesabı etkin durumda olmadığından erişilemiyor.
Genel nedenler Bu durum, müşteri hesabı kaydolma işlemini tamamlamadığı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 kaydolma 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.
USER_PERMISSION_DENIED
ÖzetYetkili 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.
İtirazı yanıtlama Yok
Korunmayla ilgili ipuçları login-customer-id değerini, tire içermeyen yönetici hesabı kimliği (-) olarak belirtin. İstemci kitaplıklarında bu özellik için yerleşik destek bulunur.