Yaygın Hatalar

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 doluyor ve invalid_grant hatası alınıyor. 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.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Özet Bu operatör, Ad sınıfının bir alt sınıfıyla kullanılamaz. Genel nedenler Reklamın status dışındaki özellikleri değiştirmeye çalışıyorsunuz. Nasıl ele alınır? Yok Korunmayla ilgili ipuçları Reklam oluşturulduktan sonra değiştirilemez. Reklamı değiştirmek istiyorsanız yeni bir reklam oluşturup eski reklamı kaldırmanız gerekir. Ancak reklamın status, MutateAdGroupAds kullanılarak değiştirilebilir.
INVALID_INPUT	Özet Bir reklamdaki alanlardan birinde geçersiz karakterler var. Genel nedenler URL'lerde özel karakterler kullanma Nasıl ele alınır? Yok 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şıyordu. Metin reklamlar hakkında başlıklı makaleyi inceleyin. Genel nedenler Çok uzun bir metin satırı kullanma Nasıl ele alınır? Yok 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 Etiketi, daha önce ilişkilendirilmiş reklamlarla ilişkilendirmeye çalışıyorsunuz. Nasıl ele alınır? Yok Korunmayla ilgili ipuçları Öncelikle, eklenecek etiketin reklamlarla ilişkilendirilip ilişkilendirilmediğini kontrol edin.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Özet Kaldırılan bir reklam güncellenmeye çalışıldı. Genel nedenler Kaldırılan reklamlar artık güncellenemez (durumunda yapılan değişiklikler dahil). Nasıl ele alınır? Yok 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 başlıklı makaleyi inceleyin. Genel nedenler Anahtar kelime metni geçersiz karakterler içeriyor. Nasıl ele alınır? Yok 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 kullanılıyor. Genel nedenler Mevcut etkin veya duraklatılmış bir reklam grubunun adıyla yeni bir reklam grubu oluşturma. Nasıl ele alını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ı önerebilir veya kullanılan adların listesini gösterebilirsiniz. Korunmayla ilgili ipuçları Yok

AssetError
DUPLICATE_ASSET	Özet Tek bir istekteki iki işlem, aynı ikili verileri içeren bir öğe için oluşturma işlemi içeriyor. Genel nedenler Aynı ikili verileri içeren yinelenen oluşturma işlemleriyle bir değiştirme isteği. Nasıl ele alınır? Öğeyi ayrı bir istekte oluşturun, ardından sonraki istekte bu öğeye bağlantı verin veya aynı istekte geçici bir kimlik kullanın. Korunmayla ilgili ipuçları Yok

AuthenticationError
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ının yenileme jetonunu 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

AuthorizationError
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	Özet Geliştirici jetonu yalnızca test hesaplarıyla kullanım için onaylanmıştır ve test dışı bir hesaba erişilmeye çalışılmıştır. Genel nedenler Test dışı bir hesaba erişmek için test geliştirici jetonu kullanıldı. Nasıl ele alınır? Gerçekten bir test hesabı olmayan bir hesaba erişmek istediğinizden emin olun. Bu durumda, geliştirici jetonunuzun Standart veya Temel erişime yükseltilmesi için başvuruda bulunmanız gerekir. Korunmayla ilgili ipuçları Yok
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.

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ı (15000 cinsinden) geçerli bir teklif değildir. Genel nedenler Yok Nasıl ele alınır? Yok Korunmayla ilgili ipuçları Tekliflerin, hesabın para birimi için minimum birimin katları olduğunu doğrulayın.
BID_TOO_BIG	Özet Teklif, kampanya bütçesi içinde olmasına rağmen hata döndürülüyor. Genel nedenler Yok Nasıl ele alınır? Yok 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 değerle sınırlayın.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Özet Bütçe tutarı çok düşük. Genel nedenler Yok Nasıl ele alınır? Yok Korunmayla ilgili ipuçları Bütçe tutarının, hesabın para birimi için minimum birimden büyük veya bu birime eşit olduğunu doğrulayın.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Özet Bütçe tutarı, mikro tutardan hesap para birimindeki tutara dönüştürüldüğünde çok fazla anlamlı ondalık basamak içerir. Genel nedenler Yok Nasıl ele alınır? Yok 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 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 ele alınır? Hatayı günlüğe kaydedin ve kullanıcıya bir hata mesajı gösterin. İsteğe bağlı olarak benzersiz bir kampanya adı önerebilir veya kullanımda olan adların listesini gösterebilirsiniz. Korunmayla ilgili ipuçları Yok

CriterionError
KEYWORD_HAS_INVALID_CHARS	Özet Geçersiz karakterler içeren anahtar kelimeler ekleme veya düzenleme Genel nedenler Anahtar kelimelerde ! @ % * gibi özel karakterler kullanma. Nasıl ele alınır? Yok Korunmayla ilgili ipuçları Anahtar kelimelerde izin verilmeyen karakterler kullanmadığınızdan emin olun. Anahtar kelime ekleme başlıklı makaleyi inceleyin.

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

InternalError
DEADLINE_EXCEEDED	Özet İstek zaman aşımına uğradı ve yanıt döndürmek için yeterince hızlı tamamlanamadı. Genel nedenler Çok büyük bir yanıt oluşturan bir arama isteği gönderildi veya bir 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'u 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 ele alınır? Yeniden denemeler için eksponansiyel geri yükleme planı kullanarak bu hatayla başarısız olan tüm istekleri yeniden deneyin. Korunmayla ilgili ipuçları Yok
TRANSIENT_ERROR	Özet Geçici bir dahili hata oluştu ve yeniden deneme yapılmalıdır. Genel nedenler Bu hata, API dahili olarak geçici bir sorunla karşılaştığında oluşur. Nasıl ele alınır? Yeniden denemeler için eksponansiyel geri yükleme planı kullanarak bu hatayla başarısız olan tüm istekleri yeniden deneyin. Korunmayla ilgili ipuçları Yok

InvalidGrantError

invalid_grant (malformed auth code)

Özet OAuth jetonları için değiştirilen yetkilendirme kodu hatalı biçimlendirilmiş. Genel nedenler Bu durum, istekte bulunan uygulamaya erişim izni verilmiş bir kullanıcı için yenileme jetonu oluşturulmaya çalışıldığında meydana gelir. Örneğin, Generate User credentials example (Kullanıcı kimlik bilgileri oluşturma örneği) aynı OAuth istemci kimlik bilgileri ve yetkilendirme kullanıcısı için birden fazla kez çalıştırıldığında bu durum oluşabilir. Nasıl ele alınır? Yetkilendiren kullanıcı ve OAuth istemci kimlik bilgilerinin belirli bir kombinasyonu için yenileme jetonu yeniden oluşturmak üzere mevcut bir yenileme jetonunu iptal edin. Bir jetonun iptal edilmesi, jetonun Google Ads API erişimi için kullanılamaz hale gelmesine ve yenileme jetonunun oluşturmak için kullanıldığı tüm erişim jetonlarının geçersiz kılınmasına neden olur. Korunmayla ilgili ipuçları Yenileme jetonunuzu yeniden oluşturmanız gerekmemesi için güvenli bir yerde sakladığınızdan emin olun.

MutateError

RESOURCE_NOT_FOUND

Özet İstek, bulunamayan bir kaynağa yönlendirildi. Genel nedenler İstek, mevcut olmayan veya kaldırılmış bir kaynağı değiştirmeye ya da başka bir şekilde referans vermeye çalıştı. Alternatif olarak, kaynak için verilen kaynak adı hatalı olabilir. Nasıl ele alınır? Bir mutate 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 belgeleri içeren 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 Zorunlu bir liste boş. Genel nedenler mutate yöntemine boş bir işlem listesi iletme. Nasıl ele alınır? Yok Korunmayla ilgili ipuçları Yok

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

RangeError
TOO_LOW	Özet Bir değer, izin verilen minimum değerden düşüktü. Genel nedenler Kimlik belirtmeyi unutma (bu durumda 0 değeri iletilir). Nasıl ele alınır? Yok Korunmayla ilgili ipuçları API referansında belirtilen aralık sınırlamalarına dikkat edin.

RequestError
INVALID_INPUT	Özet İstek yanlış biçimlendirilmiş. Genel nedenler İsteğin URL'si veya içeriği hatalı biçimlendirilmiş. Nasıl ele alınır? Yok Korunmayla ilgili ipuçları Yok
REQUIRED_FIELD_MISSING	Özet İstek gerekli bilgileri içermiyor. Genel nedenler Bir öğe eklenmeye çalışılırken zorunlu alanların eksik olması. 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 bulunabilecek kaynak sayısıyla ilgili birden fazla sınır vardır. Nasıl ele alınır? Sistem sınırları'nı inceleyerek karşılaşılan sınırı belirleyin. Mevcut bir kaynağı yeniden kullanın veya yeni kaynaklar için yer açmak üzere kaynakları kaldırın. 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ırı aşıyor. Genel nedenler Reklam 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 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.