-
reCAPTCHA Enterprise kullanmalı mıyım?
-
reCAPTCHA Enterprise,ayda 10.000'e kadar ücretsiz değerlendirme sunar ve ek özellikler sağlar. Diğer özellikler (ör. gerçek zamanlı analizler) çoğu geliştirici için başlamak üzere en iyi yeri sağlar. Buradan başlayın.
-
reCAPTCHA'yı üçüncü taraf çözümleriyle kullanabilir miyim?
-
Evet, hem reCAPTCHA'yı (Enterprise olmayan sürüm) hem de reCAPTCHA Enterprise'ı kullanabilirsiniz. Genellikle üçüncü taraf çözümü, herkese açık anahtarınızı ve gizli anahtarınızı ya da API anahtarınızı ister. Gizli anahtarınızı ve API anahtarınızı yalnızca güvenilir üçüncü taraflarla paylaştığınızdan emin olun.
-
v2 veya v3'ten reCAPTCHA Enterprise'a nasıl geçilir?
-
Taşıma işlemi 5-10 dakika sürer ve kod değişikliği gerektirmez.
-
reCAPTCHA v2 mi yoksa v3 mü kullanmalıyım?
-
reCAPTCHA v3, trafiği hakkında daha fazla veri edinmek isteyen site sahipleri için uygundur. Daha fazla bilgi için reCAPTCHA v3 geliştirici kılavuzuna bakın.
v2 için güvenlik ve kullanılabilirlik desteği sunuyoruz.
reCAPTCHA v2 ve v3 arasındaki farklar hakkında daha fazla bilgi için sürüm karşılaştırması bölümüne bakın.
- reCAPTCHA, risk analizini sağlamak amacıyla yürütüldüğünde gerekli bir çerez (_GRECAPTCHA) ayarlar. Diğer çerezlerin ayarlanmış olabileceği www.google.com alanını kullanmak istemiyorsanız bunun yerine www.recaptcha.net alanını kullanabilirsiniz.
-
reCAPTCHA kullanımımda herhangi bir QPS veya günlük sınır var mı?
- Saniyede 1.000'den fazla veya ayda 1.000.000'dan fazla arama yapmak istiyorsanız reCAPTCHA Enterprise'ı kullanmanız ya da bu formu doldurup istisna onayını beklemeniz gerekir. Bir site anahtarı 1.000 sorgu/sn sınırını aşarsa bazı istekler işlenmeyebilir. Bir v3 site anahtarı aylık kotasını aşarsa site_verify, ayın geri kalanında 0,9 statik puanı ve "Over free quota." ("Ücretsiz kota aşıldı") hata mesajını döndürerek açık başarısız olabilir. v3 siteleri kotayı aştığında kullanıcıların görebileceği herhangi bir gösterge yoktur. Bir v2 site anahtarı aylık kotasını aşarsa ayın geri kalanında reCAPTCHA widget'ında kullanıcılara aşağıdaki veya benzer bir mesaj gösterilebilir: "Bu site reCAPTCHA kotasını aşıyor." Kota uygulanmadan önce site sahiplerine e-postayla üç kez bildirim gönderilir ve reCAPTCHA Enterprise'a geçiş için en az 90 gün süre verilir. Herhangi bir alan için ayda 1.000.000'dan fazla çağrı kullanılıyorsa site anahtarları kota aşımı olarak kabul edilir. Bu, aynı alan adındaki birden fazla anahtara yayılan hacimler için de geçerlidir.
-
reCAPTCHA rozetini gizlemek istiyorum. Nelere izin verilir?
-
Kullanıcı akışında reCAPTCHA markasını görünür şekilde eklediğiniz sürece rozeti gizleyebilirsiniz. Lütfen aşağıdaki metni ekleyin:
This site is protected by reCAPTCHA and the Google <a href="https://policies.google.com/privacy">Privacy Policy</a> and <a href="https://policies.google.com/terms">Terms of Service</a> apply.
Örneğin:
Not: Rozeti gizlemeyi seçerseniz lütfen
.grecaptcha-badge { visibility: hidden; }
-
reCAPTCHA ile otomatik testler çalıştırmak istiyorum. Ne yapmalıyım?
-
reCAPTCHA v3 için test ortamları için ayrı bir anahtar oluşturun. reCAPTCHA v3 gerçek trafiği görmeye dayandığı için puanlar doğru olmayabilir.
reCAPTCHA v2 için aşağıdaki test anahtarlarını kullanın. Her zaman CAPTCHA ile karşılaşmazsınız ve tüm doğrulama istekleri başarılı olur.
- Site anahtarı: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
- Gizli anahtar: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe
reCAPTCHA widget'ı, üretim trafiği için kullanılmadığından emin olmak amacıyla bir uyarı mesajı gösterir.
-
Sitemde hata ayıklama yaparken reCAPTCHA koduna girmeyi nasıl önleyebilirim?
-
Sitenizdeki diğer JavaScript'leri ayıklarken reCAPTCHA koduna girmemek için reCAPTCHA komut dosyasını
/recaptcha__.+\.js$
tarayıcınızın yoksayma listesine ekleyin. Chrome'la ilgili talimatlar için Özel komut dosyası listesini yoksayma başlıklı makaleyi inceleyin. Diğer tarayıcılarda da benzer özellikler bulunur. -
Web sitemin trafiği hakkında daha fazla bilgiyi nasıl görebilirim?
-
reCAPTCHA, yönetici konsolunda günlük istatistikler bildirir.
-
reCAPTCHA'yı dünya genelinde kullanabilir miyim?
-
Evet, "www.google.com" adresine erişilemediği durumlarda lütfen kodunuzda "www.recaptcha.net"i kullanın.
- İlk olarak <script src="https://www.google.com/recaptcha/api.js"></script> ifadesini <script src="https://www.recaptcha.net/recaptcha/api.js"></script> ile değiştirin.
- Ardından, sitenizde "www.google.com/recaptcha/" kullanılan diğer her yere aynı işlemi uygulayın.
-
reCAPTCHA widget'ını veya rozetini özelleştirebilir miyim?
-
Evet. reCAPTCHA, aşağıda gösterildiği gibi açık ve koyu olmak üzere iki tema sunar. Tema seçmek için grecaptcha.render parametresinde data-theme özelliğini ayarlamanız yeterlidir.
Açık tema:
Koyu tema:
-
reCAPTCHA v3'ü nasıl özelleştirebilirim?
-
Görünmez reCAPTCHA için kullanılabilen JavaScript API, v3 için de çalışır. Rozeti yeniden konumlandırma veya temayı değiştirme gibi seçeneklere erişmek için JavaScript API'yi kullanarak reCAPTCHA'yı açıkça bir v3 site anahtarıyla oluşturmanız yeterlidir.
reCAPTCHA v3'ü bu yöntemle oluştururken
size
parametresini'invisible'
olarak ayarlamayı vegrecaptcha.execute
işlevini çağırırken site anahtarı yerinegrecaptcha.render
tarafından döndürülen istemci kimliğini kullanmayı unutmayın. -
Son zamanlarda reCAPTCHA widget'ımda "Geçersiz site anahtarı" mesajı gösterilmeye başladı. Neler oluyor?
-
Bu hatayı görüyorsanız reCAPTCHA site anahtarınız artık geçerli değildir. Etkinleştirmek için lütfen yeni bir anahtar kaydedin ve ilgili sayfadaki talimatları uygulayın.
-
Uncaught SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "<your domain>" hatası alıyorum. Ne yapmalıyım?
-
Bu durum genellikle, son kullanıcı onay kutusunu tıkladıktan sonra reCAPTCHA widget'ı HTML öğesi programatik olarak kaldırılırsa ortaya çıkar. reCAPTCHA widget'ını sıfırlamak için grecaptcha.reset() JavaScript işlevini kullanmanızı öneririz.
-
Web sitemde İçerik Güvenliği Politikası (İGP) kullanıyorum. reCAPTCHA ile çalışacak şekilde nasıl yapılandırabilirim?
-
CSP3 ile belgelenen nonce tabanlı yaklaşımı kullanmanızı öneririz. Nonce'unuzu reCAPTCHA api.js komut dosyası etiketine eklediğinizden emin olun. Gerisini biz hallederiz.
Not: reCAPTCHA, destekleyen tarayıcılarda "strict-dynamic" ile de çalışır.
Alternatif olarak, lütfen aşağıdaki değerleri yönergelere ekleyin:
- script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
- frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
- connect-src https://www.google.com/recaptcha/
-
"Localhost, desteklenen alanlar listesinde yok" hatası alıyorum. Ne yapmalıyım?
-
localhost alanları varsayılan olarak desteklenmez. Geliştirme için bu alanları desteklemeye devam etmek istiyorsanız bunları site anahtarınızın desteklenen alanlar listesine ekleyebilirsiniz. Desteklenen alanlar listenizi güncellemek için reCAPTCHA Enterprise konsoluna veya uygun şekilde reCAPTCHA konsoluna gidin. Geliştirme ve üretim için ayrı anahtarlar kullanmanızı ve geliştirme sitenizin anahtarında yalnızca localhost'a izin vermenizi öneririz.
-
Yalnızca iOS 10'da, kullanıcı mücadeleyi tamamladığında sayfa en alta kaydırılıyor mu?
-
Bu, Apple tarafında bulunan ve kendilerine bildirdiğimiz bir odaklanma hatasıdır. Bu durum yalnızca iOS 10'daki kullanıcıları ve yalnızca bazı sitelerde etkiler. Bu durumdan etkileniyorsanız reCAPTCHA widget'ını sayfada daha yukarıya veya aşağıya taşıyabilir ya da reCAPTCHA v3'ü kullanabilirsiniz.
-
Bilgisayarım veya ağım otomatik sorgular gönderiyor olabilir mi?
-
Bu sayfaya reCAPTCHA widget'ından yönlendirildiyseniz "Üzgünüz, ancak bilgisayarınız veya ağınız otomatik sorgular gönderiyor olabilir. Kullanıcılarımızı korumak amacıyla isteğinizi şu anda işleme alamıyoruz."
Bu durum, maalesef birkaç nedenden dolayı iyi kullanıcıların başına gelebilir:
- Kötüye kullanılan ortak bir ağda olabilirsiniz.
- İnternet servis sağlayıcınız size yakın zamanda şüpheli bir IP adresi atamış olabilir.
- Erişmeye çalıştığınız site şu anda yoğun bir saldırı altında olabilir.
Bu sorunları gidermek için lütfen olağan dışı trafik yardım sayfasına göz atın veya daha sonra tekrar deneyin.
-
Hangi işlem adları geçerlidir?
-
İşlemler yalnızca alfanümerik karakterler, eğik çizgiler ve alt çizgiler içerebilir. İşlemler kullanıcıya özel olmamalıdır.
Sık Sorulan Sorular
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: 2025-09-18 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-09-18 UTC."],[[["\u003cp\u003ereCAPTCHA Enterprise offers a free tier with 10,000 assessments per month and advanced features like real-time analytics.\u003c/p\u003e\n"],["\u003cp\u003eYou can migrate to reCAPTCHA Enterprise from v2 or v3 in 5-10 minutes without code changes.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA v3 provides website traffic insights while v2 focuses on security and usability.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA sets a necessary cookie but you can use www.recaptcha.net instead of www.google.com to avoid other potential Google cookies.\u003c/p\u003e\n"],["\u003cp\u003eTo hide the reCAPTCHA badge, ensure the reCAPTCHA branding is visible in the user flow with the provided text snippet.\u003c/p\u003e\n"]]],["reCAPTCHA offers Enterprise and non-Enterprise versions, with the former providing 10,000 free assessments monthly and features like real-time analytics. Migration to Enterprise is quick and doesn't require code changes. reCAPTCHA v3 provides more traffic data than v2. Both versions are compatible with third-party solutions, using public and secret/API keys. reCAPTCHA sets a necessary cookie, but an alternative domain is available. There are rate and volume limits; exceeding them may cause errors. You can hide the badge with specific text included, set testing keys, and use multiple ways to customize its behaviour.\n"],null,[]]