Yaygın Hatalar

Bu sayfada, sık karşılaşılan hatalar listelenmekte ve bunları önleme ve ele alma konusunda ipuçları sağlanmaktadır. Hataların tam listesi için hata referanslarını inceleyin. Daha fazla destek almak için forumumuzu ziyaret edin.

google.auth.exceptions.RefreshError

invalid_grant

Özet Jetonun süresi dolmuş veya iptal edilmiş. Genel nedenler Harici bir kullanıcı türü için yapılandırılmış OAuth izin ekranı ve Testing yayınlama durumuna sahip bir Google Cloud Platform projesine, geçerlilik süresi 7 gün içinde dolacak olan bir yenileme jetonu verilir. Nasıl kullanılır? Google projenizin yayınlanma durumu Testing olduğundan, yenileme jetonunun süresi 7 günde bir doluyor ve invalid_grant hatası alıyor. Google API Konsolu'na ve OAuth izin ekranına gidin. Ardından, yenileme jetonunun 7 gün içinde sona ermesini önlemek için bu talimatları uygulayarak yayınlanma durumunu In production olarak değiştirin. Korunmayla ilgili ipuçları Doğrulanmamış uygulamalar konusuna bakın.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Özet Bu operatör, Reklam alt sınıfıyla kullanılamaz. Genel nedenler Reklamın status dışındaki özellikler değiştirilmeye çalışılıyor. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Reklam oluşturulduktan sonra değiştirilemez. Reklamı değiştirmek isterseniz yeni bir reklam oluşturmanız ve ardından eskisini kaldırmanız gerekir. Ancak, reklamın status değeri MutateAdGroupAds kullanılarak değiştirilebilir.
INVALID_INPUT	Özet Reklamdaki alanlardan birinde geçersiz karakterler var. Genel nedenler URL'lerde özel karakterler kullanma. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları API isteğinde bulunmadan önce uygulamanızdaki URL'leri doğrulayın.
LINE_TOO_WIDE	Özet Bir reklamdaki alanlardan biri, izin verilen maksimum uzunluğu aşıyor. Metin reklamlar hakkında başlıklı makaleyi inceleyin. Genel nedenler Bir metin satırı çok uzun. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları API isteğinde bulunmadan önce satırın uzunluğunu doğrulayın.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Özet Bu etiket, reklamların bazılarıyla zaten ilişkili. Genel nedenler Etiket, önceden ilişkilendirilmiş reklamlarla ilişkilendirilmeye çalışılıyor. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları İlk olarak, eklenecek etiketin reklamlarla ilişkilendirilmiş olup olmadığını kontrol edin.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Özet Bir işlem, kaldırılmış bir reklamı güncellemeye çalıştı. Genel nedenler Bir reklam kaldırıldıktan sonra, durumundaki değişiklikler de dahil olmak üzere artık güncellenemez. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Kodunuzun kaldırılan reklamları güncellemeye çalışmadığından emin olun.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	Özet Anahtar kelime metni geçersiz karakterler içeriyor. Anahtar kelime ekleme konusuna bakın. Genel nedenler Anahtar kelime metni geçersiz karakterler içeriyor. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları API'ye istekte bulunmadan önce uygulamanızdaki anahtar kelime metnini doğrulayın.

AdGroupError

DUPLICATE_ADGROUP_NAME

Özet Bir reklam grubu ekleniyor veya yeniden adlandırılıyor ancak bu ad zaten başka bir reklam grubu tarafından kullanılıyor. Genel nedenler Mevcut bir etkin veya duraklatılmış reklam grubunun adıyla yeni bir reklam grubu oluşturma. Nasıl kullanılır? Hatayı günlüğe kaydedin ve kullanıcıya bir hata mesajı gösterin. İsteğe bağlı olarak benzersiz bir reklam grubu adı önerin veya kullanılan adların listesini gösterin. Korunmayla ilgili ipuçları Hiçbiri

AssetError
DUPLICATE_ASSET	Özet Tek bir istekteki iki işlem, aynı ikili veriye sahip bir öğe için oluşturma işlemi içerir. Genel nedenler Aynı ikili program verilerini içeren yinelenen oluşturma işlemleri içeren bir değiştirme isteği. Nasıl kullanılır? Öğeyi ayrı bir istekte oluşturup sonraki istekte bu öğeye bağlayın veya aynı istekte geçici bir kimlik kullanın. Korunmayla ilgili ipuçları Hiçbiri

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Özet Müşterinin müşteri kimliği bir numara değil. Genel nedenler Hatalı bir müşteri müşteri kimliği kullanma Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları 123-456-7890, 1234567890 olmalıdır. Ayrıntılar için Başlarken bölümüne bakın.
CLIENT_CUSTOMER_ID_IS_REQUIRED	Özet İstemci müşteri kimliği HTTP üstbilgisinde belirtilmedi. Genel nedenler HTTP üstbilgisinde istemci müşteri kimliği belirtilmemelidir. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları İstemci müşteri kimliği tüm çağrılar için gerekli olduğundan, HTTP başlığında bunu belirttiğinizden emin olun. Bu işlemi sizin yerinize 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 Hesap arka uçta oluşturulmadan önce oluşturulan bir hesaba erişmeye çalışılıyor. Nasıl kullanılır? İlk beş dakika bekleyin, ardından her 30 saniyede bir tekrar deneyin. Korunmayla ilgili ipuçları Hesap için istek göndermeden önce, hesap oluşturulduktan sonra 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 kullanılır? 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 yeniden kullanabilirsiniz.
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 karşılık geliyor. Nasıl kullanılı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 giderek ve ardından Google hesabı e-posta adresini ekleyerek Google hesabını mevcut bir Google Ads hesabına erişmeye davet edebilirsiniz. Korunmayla ilgili ipuçları Hiçbiri
OAUTH_TOKEN_INVALID	Özet Başlıktaki OAuth erişim jetonu geçerli değil. Genel nedenler HTTP üstbilgisiyle iletilen erişim jetonunuz doğru değil. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Hesabınızla ilişkilendirilmiş doğru erişim jetonunu ilettiğinizden emin olun. Yenileme jetonları ve yetkilendirme kodlarıyla bazen karıştırılır. Bir yönetici hesabındaki tüm müşteri hesaplarına erişebilen bir kimlik bilgisi almak isterseniz yönetici hesabı için yenileme jetonunu aldığınızdan emin olun. Daha fazla bilgi edinmek için erişim jetonu ve yenileme jetonu ile OAuth2 hakkındaki kılavuzumuza göz atın.

AuthorizationError
CUSTOMER_NOT_ENABLED	Özet Müşteri hesabına, etkin durumda olmadığı için 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 kullanılı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ı Bir müşteri hesabının devre dışı bırakılıp bırakılmadığını proaktif bir şekilde kontrol etmek için İPTAL EDİLDİ durumunu kontrol edebilirsiniz.
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şmeye çalışılmıştır. Genel nedenler Test dışı bir hesaba erişmek için bir test geliştirici jetonu kullanıldı. Nasıl kullanılır? Test dışı bir hesaba erişmek istediğinizden emin olun. Öyleyse geliştirici jetonunuzun Standart veya Temel erişime yükseltilmesi için başvuruda bulunmanız gerekir. Korunmayla ilgili ipuçları Hiçbiri
DEVELOPER_TOKEN_PROHIBITED	Özet İstekte gönderilen projeyle geliştirici jetonuna izin verilmiyor. Genel nedenler Her Google API Konsolu projesi, yalnızca bir yönetici hesabındaki geliştirici jetonuyla ilişkilendirilebilir. Bir Google Ads API isteğinde bulunduğunuzda, geliştirici simgesi Google API Konsolu projesiyle kalıcı olarak eşlenir. Yeni bir Google API Konsolu projesi kullanmıyorsanız istekte bulunurken DEVELOPER_TOKEN_PROHIBITED hatası alırsınız. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Yeni bir yönetici hesabı altında bir geliştirici jetonuna geçiyorsanı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, çalışan müşteriye erişimi yok. Genel nedenler Yönetici hesabına erişimi olan bir kullanıcı olarak kimlik doğrulanıyor, ancak istekte login-customer-id belirtilmiyor. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Yönetici hesabı kimliği olarak login-customer-id değerini tire olmadan (-) belirtin. İstemci kitaplıklarında bu özellik için yerleşik destek bulunmaktadır.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Özet Teklif değeri, hesabın para biriminin minimum biriminin tam katı değil. Örneğin, 0,015 ABD doları (mikro olarak 15000) geçerli bir teklif değildir. Genel nedenler Hiçbiri Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Tekliflerin, hesabın para biriminde minimum birimin katları olduğunu doğrulayın.
BID_TOO_BIG	Özet Teklif, kampanya bütçesi dahilinde olmasına rağmen hata döndürülür. Genel nedenler Hiçbiri Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Hesabın Google Reklam Bağışları'na katılıp katılmadığını kontrol edin. Bu durumda TBM tekliflerini program tarafından belirlenen maksimum tutar ile sınırlandırın.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Özet Bütçe tutarı çok küçük. Genel nedenler Hiçbiri Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Bütçe tutarının, hesabın para birimi için minimum birimden büyük veya buna eşit olduğunu doğrulayın.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Özet Bütçe tutarı, mikro tutardan hesabın para birimindeki bir tutara dönüştürüldüğünde çok fazla sayıda önemli ondalık basamak içerir. Genel nedenler Hiçbiri Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Bütçe tutarının hesabın para birimi için minimum birime bölünebildiğini doğrulayın.

CampaignError

DUPLICATE_CAMPAIGN_NAME

Özet Bir kampanya ekleniyor veya yeniden adlandırılıyor ancak bu ad zaten başka bir kampanya tarafından kullanılıyor. Genel nedenler Mevcut etkin veya duraklatılmış bir kampanyanın adıyla yeni bir kampanya oluşturma. Nasıl kullanılır? Hatayı günlüğe kaydedin ve kullanıcıya bir hata mesajı sunun. İsteğe bağlı olarak benzersiz bir kampanya adı önerebilir veya kullanılan adların listesini gösterebilirsiniz. Korunmayla ilgili ipuçları Hiçbiri

CriterionError
KEYWORD_HAS_INVALID_CHARS	Özet Geçersiz karakterler içeren anahtar kelimeler ekleme veya düzenleme. Genel nedenler Anahtar kelimelerde ! @ % * gibi özel karakterler kullanın. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Anahtar kelimelerde izin verilmeyen karakterler kullanmadığınızdan emin olun. Anahtar kelime ekleme konusuna bakın.

DistinctError
DUPLICATE_ELEMENT	Özet İstek, aynı ve gereksiz olan iki parametre içeriyor. Genel nedenler Hiçbiri Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları İstekte bulunmadan önce kopyaları (işlemler, parametreler, liste öğeleri) kaldırın. DistinctElements kısıtlamasının bulunduğu alanları bulun.

InternalError
DEADLINE_EXCEEDED	Özet İstek zaman aşımına uğradı ve bir yanıt döndürecek kadar hızlı bir şekilde tamamlanamadı. Genel nedenler Çok büyük bir yanıt oluşturan bir arama isteği gönderildi veya değiştirme isteği işlenemeyecek kadar büyük. Nasıl kullanılır? Yaklaşık 30 saniye bekleyip isteği yeniden deneyin. Hata devam ederse isteği daha hızlı bir şekilde tamamlanabilecek daha küçük isteklere bölmeyi deneyin. Korunmayla ilgili ipuçları Bir yanıtın boyutunu nasıl etkileyebileceğini anlamak için Segmentasyon konusunu inceleyin. gRPC aktarım katmanı sınırlamalarına dikkat edin.
INTERNAL_ERROR	Özet İstek işlenirken beklenmeyen bir hata oluştu. Genel nedenler API bir hata nedeniyle düzgün çalışmıyor. Nasıl kullanılır? Yeniden denemeler için eksponansiyel geri yükleme planını kullanarak bu hatayla başarısız olan tüm istekleri yeniden deneyin. Korunmayla ilgili ipuçları Hiçbiri
TRANSIENT_ERROR	Özet Geçici bir dahili hata oluştu. Yeniden deneme yapılması gerekiyor. Genel nedenler Bu hata, API dahili olarak geçici bir sorunla karşılaştığında oluşur. Nasıl kullanılır? Yeniden denemeler için eksponansiyel geri yükleme planını kullanarak bu hatayla başarısız olan tüm istekleri yeniden deneyin. Korunmayla ilgili ipuçları Hiçbiri

InvalidGrantError

invalid_grant (malformed auth code)

Özet OAuth jetonları ile değiştirilen yetkilendirme kodu hatalı biçimlendirilmiş. Genel nedenler İstekte bulunan uygulamaya erişim izni olan bir kullanıcı için yenileme jetonu oluşturmaya çalışırken bu durumla karşılaşılır. Örneğin, bu durum, Kullanıcı kimlik bilgileri örneği aynı OAuth istemci kimlik bilgileri için birden fazla kez çalıştırıldığında ve kullanıcıyı yetkilendirirken yaşanabilir. Nasıl kullanılır? Kullanıcı ve OAuth istemcisi kimlik bilgilerini yetkilendirmenin belirli bir kombinasyonu için yenileme jetonunu yeniden oluşturmak istiyorsanız mevcut bir yenileme jetonunu iptal edin. Bir jetonu iptal ettiğinizde jetonun Google Ads API erişimi için kullanılamayacağını ve yenileme jetonunun oluşturmak için kullanılan tüm erişim jetonlarının geçersiz kılınacağını unutmayın. Korunmayla ilgili ipuçları Yeniden oluşturma ihtiyacını önlemek için yenileme jetonunuzu güvenli bir yerde sakladığınızdan emin olun.

MutateError

RESOURCE_NOT_FOUND

Özet İstek, bulunamayan bir kaynağa başvuruda bulundu. Genel nedenler İstek, var olmayan veya kaldırılmış bir kaynağı değiştirmeye çalıştı ya da böyle bir kaynağa referans verdi. Kaynak için belirtilen kaynak adı bozuk olabilir. Nasıl kullanılır? Değişim isteği göndermeden önce mevcut bir kaynağın kaynak adını almak için arama isteğini kullanın. Desteklenen her dilde geçerli kaynak adlarının nasıl oluşturulacağıyla ilgili belgelerin yer aldığı istemci kitaplığı kılavuzlarımızı inceleyin. Korunmayla ilgili ipuçları Kaynak adlarını manuel olarak oluşturmayın. İstemci kitaplıklarımız tarafından sunulan yardımcı yöntemlerden birini kullanın.

NotEmptyError
EMPTY_LIST	Özet Gerekli bir liste boş. Genel nedenler Boş bir işlem listesini bir mutate yöntemine geçirin. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Hiçbiri

QuotaError
RESOURCE_EXHAUSTED	Özet Bir sistem sıklık sınırı aşıldı. Genel nedenler Hiçbiri Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları İstekler arasında kısa gecikmeler ayarlayın veya daha az istekte daha fazla işlemi birleştirin.

RangeError
TOO_LOW	Özet Bir değer, izin verilen minimum değerden düşük. Genel nedenler Bir kimlik belirtmenin unutulması. Bu durumda 0 değerinin geçirilmesi. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları API referansında belirtilen tüm aralık sınırlamalarına dikkat edin.

RequestError
INVALID_INPUT	Özet İstek hatalı biçimlendirilmiş. Genel nedenler İsteğin URL'si veya içeriği bozuk. Nasıl kullanılır? Hiçbiri Korunmayla ilgili ipuçları Hiçbiri
REQUIRED_FIELD_MISSING	Özet İstekte gerekli bilgiler eksik. Genel nedenler Varlık eklemeye çalışırken gerekli alanlar eksik. Nasıl kullanılır? Hatayı günlüğe kaydedin ve kullanıcıya bir hata mesajı gösterin. Hatanın fieldPath özelliği, hangi alanın eksik olduğunu belirtir. Korunmayla ilgili ipuçları Hangi alanların zorunlu olduğunu öğrenmek için API referansına bakın.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Özet İstek, bu kaynakların toplam sayısının belirtilen sınırı aşmasına neden olacak bir kaynak oluşturmaya çalışıyor. Genel nedenler Belirli bağlamlarda bulunabilecek kaynak sayısına ilişkin birden fazla sınır vardır. Nasıl kullanılır? Sistem sınırları bölümünü inceleyerek karşılaşılan sınırı belirleyin. Mevcut bir kaynağı yeniden kullanın veya yenilerine yer açmak için kaynakları kaldırın. Korunmayla ilgili ipuçları Sınırlanan kaynakların sayısını izlemek için arama sorgularını kullanın.

StringLengthError
TOO_LONG	Özet Belirtilen alana atanan dize, sınırdan uzun. Genel nedenler Reklam başlıkları veya açıklamaları çok fazla metin içeriyor. Nasıl kullanılır? Karşılaşılan sınırı belirleyin, dizeyi buna göre değiştirin ve isteği yeniden gönderin. Korunmayla ilgili ipuçları Dize uzunluğu sınırlarına dikkat edin.