Yaygın Hatalar

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

google.auth.exceptions.RefreshError

invalid_grant

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

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Özet Bu operatör, bir Reklam alt sınıfıyla kullanılamaz. Genel nedenler Reklamın status dışındaki özellikleri değiştirilmeye çalışılıyor. Nasıl ele alınır? Hiçbiri Korunmayla ilgili ipuçları Bir 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 özelliği MutateAdGroupAds kullanılarak değiştirilebilir.
INVALID_INPUT	Özet Reklamdaki alanlardan biri geçersiz karakterler içeriyor. Genel nedenler URL'lerde özel karakterler kullanma. Nasıl ele alını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 uzunluktan daha uzun. Metin reklamlar hakkında bölümünü inceleyin. Genel nedenler Metin satırı çok uzun. Nasıl ele alını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, zaten ilişkilendirilmiş reklamlarla ilişkilendirilmeye çalışılıyor. Nasıl ele alınır? Hiçbiri Korunmayla ilgili ipuçları Öncelikle, eklenecek etiketin zaten reklamlarla ilişkili olup olmadığını kontrol edin.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Özet Bir işlem, kaldırılan 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 ele alını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 bölümünü inceleyin. Genel nedenler Anahtar kelime metni geçersiz karakterler içeriyor. Nasıl ele alını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 ad başka bir reklam grubu tarafından zaten kullanılıyor. Genel nedenler Mevcut etkin veya duraklatılmış bir reklam grubunun adıyla yeni bir reklam grubu oluşturarak. Nasıl ele alınır? Hatayı kaydedin ve kullanıcıya, isteğe bağlı olarak benzersiz bir reklam grubu adı önererek veya kullanılan adların listesini gösteren bir hata mesajı sunun. Korunmayla ilgili ipuçları Hiçbiri

AssetError
DUPLICATE_ASSET	Özet Tek bir istekteki iki işlem, aynı ikili verilere sahip bir öğe için bir oluşturma işlemi içeriyor. Genel nedenler Aynı ikili verileri içeren yinelenen oluşturma işlemlerine sahip bir değişiklik isteği. Nasıl ele alınır? Öğeyi ayrı bir istekte oluşturun, ardından sonraki istekte öğeye bağlayın veya aynı istek içinde geçici bir kimlik kullanın. Korunmayla ilgili ipuçları Hiçbiri

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Özet İstemci müşteri kimliği bir sayı değil. Genel nedenler Hatalı bir istemci müşteri kimliği kullanma. Nasıl ele alını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 başlığında belirtilmemiş. Genel nedenler HTTP başlığında istemci müşteri kimliği belirtilmedi. Nasıl ele alınır? Hiçbiri Korunmayla ilgili ipuçları Tüm çağrılar için istemci müşteri kimliği gerekir. Bu nedenle, HTTP başlığında bir müşteri kimliği belirttiğinizden emin olun. Bu işlemi sizin için yapan istemci kitaplıklarımızı kullanabilirsiniz.
CUSTOMER_NOT_FOUND	Özet Başlıkta sağlanan 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 ele alınır? İlk beş dakika bekledikten sonra 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 jetonun süresi dolmuş. Genel nedenler Erişim jetonu geçersiz kılındı. Nasıl ele alınır? Yeni bir jeton isteyin. İstemci kitaplıklarımızdan birini kullanıyorsanız jetonun yenilenmesiyle ilgili dokümanlarına bakın. Korunmayla ilgili ipuçları Erişim jetonlarını süreleri dolana kadar saklayıp yeniden kullanın.
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 ait. 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 ilgili müşteri veya yönetici hesabını seçerek, Tools and Settings > Access and security adresine 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 başlığıyla iletilen erişim jetonunuz doğru değildi. Nasıl ele alınır? Hiçbiri 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ı için yenileme jetonunu aldığınızdan emin olun. Daha ayrıntılı bilgi için erişim jetonu ve yenileme jetonu ve OAuth2 ile ilgili kılavuzumuza bakın.

AuthorizationError
CUSTOMER_NOT_ENABLED	Özet Etkin durumda olmadığı için müşteri hesabına 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ı İPTAL EDİLDİ durumunu kontrol ederek müşteri hesabının devre dışı bırakılıp bırakılmadığını önceden kontrol edebilirsiniz.
DEVELOPER_TOKEN_NOT_APPROVED	Özet Geliştirici jetonu yalnızca test hesaplarıyla kullanım için onaylanmıştır ve test hesabı olmayan bir hesaba erişmeye çalışılır. Genel nedenler Test dışı bir hesaba erişmek için test geliştirici jetonu kullanıldı. Nasıl ele alını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şvurmanız gerekir. Korunmayla ilgili ipuçları Hiçbiri
DEVELOPER_TOKEN_PROHIBITED	Özet İstekte gönderilen projede geliştirici jetonuna 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ği gönderdiğinizde, geliştirici jetonu 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 ele alınır? Hiçbiri Korunmayla ilgili ipuçları Yeni bir yönetici hesabı altında bir 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 gerekecektir.
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ğrulama ancak istekte login-customer-id belirtmeme. Nasıl ele alınır? Hiçbiri Korunmayla ilgili ipuçları Yönetici hesabı kimliği olarak login-customer-id değerini tire (-) olmadan belirtin. Müşteri kitaplıkları bunun için yerleşik olarak 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 TL (mikro olarak 15000) geçerli bir teklif değildir. Genel nedenler Hiçbiri Nasıl ele alınır? Hiçbiri Korunmayla ilgili ipuçları Tekliflerin, hesabın para birimi için minimum birimin katı 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 ele alını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 belirtilen maksimum tutarla 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 ele alınır? Hiçbiri Korunmayla ilgili ipuçları Bütçe tutarının, hesabın para biriminin minimum biriminden yüksek veya bu tutara 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 sayıda önemli ondalık basamak içerecek. Genel nedenler Hiçbiri Nasıl ele alınır? Hiçbiri Korunmayla ilgili ipuçları Bütçe tutarının, hesabın para biriminin minimum birimine bölünebildiğini doğrulayın.

CampaignError

DUPLICATE_CAMPAIGN_NAME

Özet Bir kampanya ekleniyor veya yeniden adlandırılıyor, ancak ad zaten başka bir kampanya tarafından kullanılıyor. Genel nedenler Etkin veya duraklatılmış mevcut bir kampanyanın adıyla yeni bir kampanya oluşturmak. Nasıl ele alınır? Hatayı kaydedin ve kullanıcıya, isteğe bağlı olarak benzersiz bir kampanya adı önererek veya kullanılan adların listesini gösteren bir hata mesajı sunun. 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 ele alınır? Hiçbiri Korunmayla ilgili ipuçları Anahtar kelimelerde izin verilmeyen karakterler kullanmadığınızdan emin olun. Anahtar kelime ekleme bölümünü inceleyin.

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

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

InvalidGrantError

invalid_grant (malformed auth code)

Özet OAuth jetonları karşılığında gönderilen yetkilendirme kodu bozuktu. Genel nedenler Bu durum, istekte bulunan uygulamaya erişim izni olan bir kullanıcı için yenileme jetonu oluşturmaya çalışırken meydana gelir. Örneğin bu durum, aynı OAuth istemcisi kimlik bilgileri için Kullanıcı kimlik bilgileri oluşturma örneğini birden fazla kez çalıştırırken ve kullanıcıyı yetkilendirirken ortaya çıkabilir. Nasıl ele alınır? Belirli bir yetkilendirme kullanıcı ve OAuth istemci kimlik bilgisi kombinasyonu için yenileme jetonunu yeniden oluşturmak istiyorsanız mevcut yenileme jetonunu iptal edin. Bir jetonun iptal edilmesi, jetonun Google Ads API erişimi için kullanılamaz hale gelmesini sağlar ve yenileme jetonunun oluşturmak için kullanılan tüm erişim jetonlarını geçersiz kılar. 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, mevcut olmayan veya kaldırılmış bir kaynağa ulaşmaya veya başka bir şekilde başvuruda bulunmaya çalıştı. Ya da kaynak için belirtilen kaynak adı bozuk. Nasıl ele alınır? Değişim isteği göndermeden önce mevcut bir kaynağın kaynak adını almak için arama isteği kullanın. Desteklenen her dilde geçerli kaynak adlarının nasıl oluşturulacağıyla ilgili belgelerin bulunduğu müşteri 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 Zorunlu liste boş. Genel nedenler Boş bir işlem listesini mutate yöntemine iletme. Nasıl ele alınır? Hiçbiri Korunmayla ilgili ipuçları Hiçbiri

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

RangeError
TOO_LOW	Özet Bir değer, izin verilen minimum değerden düşük. Genel nedenler Bir kimlik belirtmeyi unutma. Bu durum, 0 değerinin aktarılmasına neden olur. Nasıl ele alınır? Hiçbiri Korunmayla ilgili ipuçları API referansında belirtilen tüm aralık sınırlamalarını göz önünde bulundurun.

RequestError
INVALID_INPUT	Özet İstek hatalı biçimlendirilmiş. Genel nedenler İsteğin URL'si veya içeriği hatalı biçimlendirilmiş. Nasıl ele alınır? Hiçbiri Korunmayla ilgili ipuçları Hiçbiri
REQUIRED_FIELD_MISSING	Özet İstekte gerekli bilgiler eksik. Genel nedenler Varlık eklemeye çalışırken zorunlu alanlar eksik. Nasıl ele alını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 gösterir. 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 var olabilecek kaynak sayısına yönelik birden çok sınır vardır. Nasıl ele alınır? Karşılaşılan sınırı belirlemek için Sistem sınırları bölümünü inceleyin. Mevcut bir kaynağı yeniden kullanabilir veya yeni kaynaklara yer açmak için mevcut kaynakları kaldırabilirsiniz. Korunmayla ilgili ipuçları Sınırlamaları olan kaynakların sayısını izlemek için arama sorgularını kullanın.

StringLengthError
TOO_LONG	Özet Belirtilen alana atanan dize, sınırdan daha uzun. Genel nedenler Reklamların başlıkları veya açıklamaları çok fazla metin içeriyor. Nasıl ele alınır? Karşılaşılan sınırı belirleyin, dizeyi uygun şekilde değiştirin ve isteği yeniden gönderin. Korunmayla ilgili ipuçları Dize uzunluğu sınırlarını göz önünde bulundurun.