Yaygın görülen hatalar

Bu kılavuzda, 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. Sorularınız varsa destek ekibiyle iletişime geçin veya tartışmalara katılmak için Google Ads Discord sunucusuna katılın.

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

Özet 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, süresi 7 gün içinde 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 gidin ve 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. Korunmayla ilgili ipuçları Doğrulanmamış uygulamalar başlıklı makaleyi inceleyin.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Özet Müşteri kimliği sayı değil. Genel nedenler Uygun olmayan bir müşteri kimliği kullanma. İtirazı yanıtlama Yok Korunmayla ilgili ipuçları 123-456-7890, 1234567890 olmalıdır. Ayrıntılar için Başlangıç bölümüne bakın.
CLIENT_CUSTOMER_ID_IS_REQUIRED	Özet Müşteri kimliği, HTTP üstbilgisinde belirtilmedi. Genel nedenler HTTP üstbilgisinde müşteri kimliği belirtilmemesi. İtirazı yanıtlama Yok Korunmayla ilgili ipuçları Tüm çağrılar için müşteri kimliği 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 Üstbilgide belirtilen 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. İ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ı 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	Özet 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 24 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 bir test hesabını hedeflediğinden emin olun. Üretim amaçlı bir 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, Temel veya Standart erişime yükseltin. Korunmayla ilgili ipuçları Yok
CUSTOMER_NOT_ENABLED	Özet Müşteri hesabı etkin durumda olmadığından hesaba 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 (İPTAL EDİLDİ) 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 içermeyen yönetici hesabı kimliği (-) olarak belirtin. İstemci kitaplıklarında bu özellik için yerleşik destek bulunur.