Yaygın Hatalar
Bu sayfada, sık karşılaşılan hatalar listelenmiş ve bunların önlenmesi ve ele alınmasıyla ilgili ipuçları verilmiştir.
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 iptal edilmiş. |
|---|
| Genel nedenler |
Harici bir kullanıcı türü için yapılandırılmış bir OAuth kullanıcı rızası ekranı ve Testing yayın 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ınlama 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 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 aşağıdaki talimatları uygulayarak yayınlama durumunu In production olarak değiştirin.
|
|---|
| Korunmayla ilgili ipuçları |
Doğrulanmamış uygulamalar başlıklı makaleyi inceleyin.
|
|---|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
| Özet | Bu operatör, reklamın alt sınıfıyla kullanılamaz. |
|---|
| Genel nedenler |
Reklamın status özelliği dışındaki özellikleri değiştirmeye çalışma
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
Oluşturulan reklamlar değiştirilemez. Reklamda değişiklik yapmak istiyorsanız yeni bir reklam oluşturmanız ve eskisini kaldırmanız gerekir. Ancak reklamın status, MutateAdGroupAds kullanılarak değiştirilebilir.
|
|---|
|
INVALID_INPUT |
| Özet | Reklamdaki alanlardan biri geçersiz karakterler içeriyor. |
|---|
| Genel nedenler |
URL'lerde özel karakterler kullanılması
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
API isteğini göndermeden önce uygulamanızdaki URL'leri doğrulayın.
|
|---|
|
LINE_TOO_WIDE |
| Özet | Reklamdaki alanlardan biri izin verilen maksimum uzunluktan daha uzundu. Metin reklamlar hakkında başlıklı makaleyi inceleyin. |
|---|
| Genel nedenler |
Metin satırının çok uzun olması.
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
API isteğini göndermeden önce satırın uzunluğunu doğrulayın.
|
|---|
|
|
AD_GROUP_AD_LABEL_ALREADY_EXISTS |
| Özet | Bu etiket, reklamların bazılarıyla zaten ilişkilidir. |
|---|
| Genel nedenler |
Etiketi, daha önce ilişkilendirilmiş reklamlarla ilişkilendirmeye çalışıyorsanız.
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
Öncelikle, eklenecek etiketin reklamlarla ilişkilendirilmiş olup olmadığını kontrol edin.
|
|---|
|
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD |
| Özet | Kaldırılan bir reklamı güncellemeye yönelik bir işlem gerçekleştirilmeye çalışıldı. |
|---|
| Genel nedenler |
Kaldırılan reklamlar artık güncellenemez (durumu değiştirilemez).
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
Kodunuzun, kaldırılan reklamları güncellemeye çalışmadığından emin olun.
|
|---|
|
|
INVALID_KEYWORD_TEXT |
| Özet | Anahtar kelime metni geçersiz karakterler içeriyor. Anahtar kelime ekleme bölümüne bakın. |
|---|
| Genel nedenler |
Anahtar kelime metni geçersiz karakterler içeriyor.
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
API'ye istek göndermeden önce uygulamanızdaki anahtar kelime metnini doğrulayın.
|
|---|
|
|
DUPLICATE_ADGROUP_NAME |
| Özet | Bir reklam grubu eklenirken veya yeniden adlandırılırken 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ş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ı önerin veya kullanılan adların listesini gösterin.
|
|---|
| Korunmayla ilgili ipuçları |
Yok
|
|---|
|
|
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şlemleri içeren bir değiştirme isteği.
|
|---|
| Nasıl ele alınır? |
Öğeyi ayrı bir istekle oluşturun, ardından sonraki istekte öğeye bağlantı verin veya aynı istek içinde geçici kimlik kullanın.
|
|---|
| Korunmayla ilgili ipuçları |
Yok
|
|---|
|
|
CLIENT_CUSTOMER_ID_INVALID |
| Özet | İstemci müşteri kimliği bir sayı değil. |
|---|
| Genel nedenler |
Yanlış istemci müşteri kimliği kullanılması.
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
123-456-7890, 1234567890 olmalıdır. Ayrıntılar için Başlayın 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 belirtilmemiş.
|
|---|
| 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 başlığında bir istemci 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 yeni oluşturulan bir hesaba erişmeye çalışmak.
|
|---|
| Nasıl ele alınır? |
İlk olarak beş dakika bekleyin, ardından 30 saniyede bir tekrar deneyin.
|
|---|
| Korunmayla ilgili ipuçları |
Hesap oluşturulduktan sonra, ilgili hesap için 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 hale geldi.
|
|---|
| Nasıl ele alınır? |
Yeni bir jeton isteyin. İstemci kitaplıklarımızdan birini kullanıyorsanız jetonun nasıl yenileneceğine dair dokümanlara bakın.
|
|---|
| Korunmayla ilgili ipuçları |
Erişim jetonlarını, geçerlilik süreleri dolana kadar depolayı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şkili değil. |
|---|
| Genel nedenler |
Sağladığınız giriş bilgileri, Google Ads'in etkin olmadığı 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. Yönetici hesabınızda oturum açarak, söz konusu 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ı |
Yok
|
|---|
|
OAUTH_TOKEN_INVALID |
| Özet | Üstbilgideki OAuth erişim jetonu geçerli değil. |
|---|
| Genel nedenler |
HTTP üst bilgisiyle 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. Bazen yenileme jetonları ve yetkilendirme kodlarıyla karıştırılır. Bir yönetici hesabının altındaki tüm müşteri hesaplarına erişebilecek bir kimlik bilgisi edinmek istiyorsanız yönetici hesabı için yeniden yenileme jetonunu aldığınızdan emin olun. Daha fazla bilgi için erişim jetonu ve yenileme jetonu ile OAuth2 ile ilgili kılavuzumuza göz atın.
|
|---|
|
|
CUSTOMER_NOT_ENABLED |
| Özet | Etkin durumda olmadığı için müşteri hesabına erişilemez. |
|---|
| Genel nedenler |
Bu durum, müşteri hesabı kayıt işlemini tamamlamamışsa veya devre dışı bırakılmışsa 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ılmış 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ışı olup olmadığını proaktif olarak kontrol etmek için İPTAL EDİLDİ durumunu kontrol edebilirsiniz.
|
|---|
|
DEVELOPER_TOKEN_NOT_APPROVED |
|
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ından alınan 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 istek gönderirken 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ında 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şletmeci 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 belirtilmemesi.
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
Yönetici hesabı kimliği olarak login-customer-id değerini kısa çizgi olmadan (-) belirtin. İstemci kitaplıklarında bu işlem için yerleşik destek vardır.
|
|---|
|
|
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 cinsinden 15000) 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 katı olduğunu doğrulayın.
|
|---|
|
BID_TOO_BIG |
|
|
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 | Mikro tutardan hesabın para biriminde bir tutara dönüştürülen bütçe tutarında çok fazla ondalık basamak olur. |
|---|
| 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ünebilir olduğunu doğrulayın.
|
|---|
|
|
DUPLICATE_CAMPAIGN_NAME |
| Özet | Bir kampanya eklenirken veya yeniden adlandırılırken ad başka bir kampanya tarafından zaten 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ı önerin veya kullanılan adların listesini gösterin.
|
|---|
| Korunmayla ilgili ipuçları |
Yok
|
|---|
|
|
KEYWORD_HAS_INVALID_CHARS |
| Özet | Geçersiz karakterler içeren anahtar kelimeler ekleme veya düzenleme |
|---|
| Genel nedenler |
Anahtar kelimelerde ! @ % * gibi özel karakterler kullanmak
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
Anahtar kelimelerde izin verilmeyen karakterler kullanmadığınızdan emin olun. Anahtar kelime ekleme bölümüne bakın.
|
|---|
|
|
DUPLICATE_ELEMENT |
| Özet | İstek, aynı ve gereksiz iki parametre içeriyor. |
|---|
| Genel nedenler |
Yok
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
İsteği göndermeden önce yinelenenleri (işlemler, parametreler, liste öğeleri) kaldırın. DistinctElements kısıtlaması olan alanları arayın.
|
|---|
|
|
DEADLINE_EXCEEDED |
| Özet | İstek zaman aşımına uğradı ve yanıt döndürecek kadar hızlı tamamlanamadı. |
|---|
| Genel nedenler |
Çok büyük bir yanıt oluşturan bir arama isteği gönderildi veya çok büyük bir değiştirme isteği gönderildi.
|
|---|
| 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 ayırmayı deneyin.
|
|---|
| Korunmayla ilgili ipuçları |
Segmentasyon'un yanıt boyutunu nasıl etkileyebileceğini anlamak için bu konuyu inceleyin. gRPC aktarım katmanı sınırlamalarına dikkat edin.
|
|---|
|
INTERNAL_ERROR |
| Özet | İstek işlenirken beklenmedik bir durum oluştu. |
|---|
| Genel nedenler |
API, bir hata nedeniyle düzgün çalışmıyor.
|
|---|
| Nasıl ele alınır? |
Yeniden denemeler için üstel geri yükleme programı 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ılması gerekiyor. |
|---|
| Genel nedenler |
Bu hata, API'de dahili olarak geçici bir sorunla karşılaşıldığında ortaya çıkar.
|
|---|
| Nasıl ele alınır? |
Yeniden denemeler için üstel geri yükleme programı 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ıyla değiştirilen yetkilendirme kodu hatalı biçimlendirilmiş. |
|---|
| Genel nedenler |
Bu durum, istek gönderen uygulamaya erişimi zaten verilmiş bir kullanıcı için yenileme jetonu oluşturulmaya çalışılırken ortaya çıkar. Örneğin, bu durum Kullanıcı kimlik bilgileri oluşturma örneği aynı OAuth istemci kimlik bilgileri ve yetki veren kullanıcı için birden fazla kez çalıştırıldığında ortaya çıkabilir.
|
|---|
| Nasıl ele alınır? |
Belirli bir yetkilendirme kullanıcısı ve OAuth istemci kimlik bilgisi kombinasyonu için yenileme jetonunu 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şturulması için kullanılan tüm erişim jetonlarının geçersiz kılınmasına neden olur.
|
|---|
| Korunmayla ilgili ipuçları |
Yeniden oluşturma ihtiyacını önlemek için yenileme jetonunuzu güvenli bir yerde sakladığınızdan emin olun.
|
|---|
|
|
RESOURCE_NOT_FOUND |
| Özet | İstek, bulunamayan bir kaynağı referans alıyordu. |
|---|
| 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? |
Değiştirme 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 dokümanları 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.
|
|---|
|
|
EMPTY_LIST |
| Özet | Zorunlu bir liste boş. |
|---|
| Genel nedenler |
mutate yöntemine boş bir işlem listesi gönderme.
|
|---|
| Nasıl ele alınır? |
Yok
|
|---|
| Korunmayla ilgili ipuçları |
Yok
|
|---|
|
|
RESOURCE_EXHAUSTED |
| Özet | Sistem frekansı 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 az sayıda istekle daha fazla işlem birleştirin.
|
|---|
|
|
TOO_LOW |
| Özet | Bir değer, izin verilen minimum değerden düşüktü. |
|---|
| Genel nedenler |
Kimlik belirtmeyi unutursanız 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.
|
|---|
|
|
INVALID_INPUT |
| Özet | İsteğin biçimi bozuk. |
|---|
| 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 | İstekte gerekli bilgiler eksik. |
|---|
| Genel nedenler |
Varlık eklenmeye çalışılı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 belirtir.
|
|---|
| Korunmayla ilgili ipuçları |
Hangi alanların zorunlu olduğunu öğrenmek için API referansına bakın.
|
|---|
|
|
RESOURCE_LIMIT |
| Özet | İstek, bu kaynakların toplam sayısının belirtilen bir 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ırlı sayıda kaynağın sayısını izlemek için arama sorgularını kullanın.
|
|---|
|
|
TOO_LONG |
| Özet | Belirtilen alana atanan dize sınırı aşıyor. |
|---|
| 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 buna göre değiştirin ve isteği yeniden gönderin.
|
|---|
| Korunmayla ilgili ipuçları |
Dize uzunluğu sınırlamalarına dikkat edin.
|
|---|
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-12-02 UTC.
[null,null,["Son güncelleme tarihi: 2024-12-02 UTC."],[[["This document provides solutions to common errors encountered when using the Google Ads API, focusing on issues related to authentication, authorization, and various Google Ads components."],["Many errors stem from invalid inputs, missing information, or exceeding limits, requiring careful validation of requests and adherence to API guidelines."],["Authentication and authorization errors often involve incorrect credentials, token expiration, or insufficient permissions, necessitating project setup adjustments and access verification."],["Several errors can be mitigated by ensuring unique names, validating inputs, and respecting resource limits, preventing duplication and exceeding system constraints."],["Server-side and transient errors might require retries with exponential backoff, while quota issues necessitate request throttling or combining operations to reduce frequency."]]],[]]
