-
reCAPTCHA Enterprise'ı kullanmalı mıyım?
-
reCAPTCHA Enterprise,ayda 10.000'e kadar ücretsiz değerlendirme ve ek özellikler sunar. Anlık analiz gibi diğer özellikler, çoğu geliştirici için en iyi başlangıç noktasıdır. 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. Üçüncü taraf çözümü genellikle ortak 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 s2'yi mi yoksa v3'ü mü kullanmalıyım?
-
reCAPTCHA s3, trafiği hakkında daha fazla veri isteyen site sahipleri içindir. Daha fazla bilgi için reCAPTCHA s3 geliştirici kılavuzuna bakın.
2. sürüm için güvenlik ve kullanılabilirliği destekliyoruz.
reCAPTCHA s2 ve v3 arasındaki farklar hakkında daha fazla bilgi için sürümlerin karşılaştırması bölümüne bakın.
- reCAPTCHA, risk analizini sağlamak amacıyla yürütüldüğünde gerekli bir çerezi (_GRECAPTCHA) ayarlar. Başka çerezlerin ayarlanmış olabileceği www.google.com alanını kullanmak istemiyorsanız bunun yerine www.recaptcha.net adresini kullanabilirsiniz.
-
reCAPTCHA kullanımımda saniye başına sorgu sayısı (QPS) veya günlük sınırlar var mı?
- Saniyede 1.000'den fazla veya ayda 1.000.000'dan fazla çağrı yapmak istiyorsanız reCAPTCHA Enterprise'ı kullanmanız veya bu formu doldurup istisna onayını beklemeniz gerekir. Bir site anahtarı 1.000 QPS'yi aşarsa bazı istekler işlenmeyebilir. Bir v3 site anahtarı aylık kotasını aşarsa `site_verify` başarısız olabilir ve ayın geri kalanı için 0, 9 statik puanı ile `"Ücretsiz kota aşıldı."` hata mesajı döndürebilir. v3 siteleri kotayı aştığında kullanıcıya gösterilen bir uyarı yoktur. Bir v2 site anahtarı aylık kotasını aşarsa ayın geri kalanında kullanıcılara reCAPTCHA widget'ında aşağıdaki veya benzer bir mesaj gösterilebilir: "Bu site reCAPTCHA kotasını aşıyor." Kota uygulanmadan önce site sahipleri e-posta yoluyla üç kez bilgilendirilir ve reCAPTCHA Enterprise'a geçiş yapmaları için en az 90 gün süre tanınır. Herhangi bir alan için ayda 1.000.000'dan fazla çağrı kullanılıyorsa site anahtarlarının kotayı aştığı kabul edilir. Bu hacim, aynı alan adındaki birden fazla anahtara yayılmışsa da bu durum geçerlidir.
-
reCAPTCHA rozetini gizlemek istiyorum. Nelere izin verilir?
-
reCAPTCHA markasını kullanıcı işlemleri akışında görünür bir şekilde eklediğiniz sürece rozeti gizleyebilirsiniz. Lütfen aşağıdaki metni ekleyin:
This site is protected by reCAPTCHA.
Ö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 s3 için test ortamlarına yönelik ayrı bir anahtar oluşturun. reCAPTCHA s3 gerçek trafiği görmeye dayandığından puanlar doğru olmayabilir.
reCAPTCHA v2 için aşağıdaki test anahtarlarını kullanın. Her zaman CAPTCHA'sız sonuç alırsı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'lerde hata ayıklarken reCAPTCHA koduna girmemek için reCAPTCHA komut dosyasını
/recaptcha__.+\.js$tarayıcınızın yoksayılanlar listesine ekleyin. Chrome ile ilgili talimatlar için Özel komut dosyası listesini yoksayma başlıklı makaleyi inceleyin. Diğer tarayıcılarda da benzer özellikler mevcuttur. -
Web sitemin trafiği hakkında daha fazla bilgiyi nasıl görebilirim?
-
reCAPTCHA, Yönetici Konsolu'nda günlük istatistikleri raporlar.
-
reCAPTCHA'yı dünya genelinde kullanabilir miyim?
-
Evet, "www.google.com" adresine erişilemediği durumlarda lütfen kodunuzda "www.recaptcha.net" adresini kullanın.
- İlk olarak, <script src="https://www.google.com/recaptcha/api.js"></script> kodunu <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 s3'ü 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ı v3 site anahtarıyla açıkça oluşturmanız yeterlidir.
reCAPTCHA v3'ü bu yöntemle oluştururken
sizeparametresini'invisible'olarak ayarlamayı vegrecaptcha.executeçağrısı yaparken site anahtarı yerinegrecaptcha.rendertarafından döndürülen istemci kimliğini kullanmayı unutmayın. -
Son zamanlarda reCAPTCHA widget'ım "Geçersiz site anahtarı" hatası vermeye 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 '<alan adınız>'" hatası alıyorum. Ne yapmalıyım?
-
Bu durum genellikle, son kullanıcı onay kutusunu tıkladıktan bir süre 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 tek seferlik rastgele sayı tabanlı yaklaşımı kullanmanızı öneririz. Tek seferlik rastgele sayınızı 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 yönergelere aşağıdaki değerleri 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 değil" hatası alıyorum. Ne yapmalıyım?
-
localhost alanları varsayılan olarak desteklenmez. Geliştirme için bunları desteklemeye devam etmek istiyorsanız site anahtarınızın desteklenen alanlar listesine ekleyebilirsiniz. Desteklenen alan adları listenizi güncellemek için reCAPTCHA Enterprise konsoluna veya reCAPTCHA konsoluna gidin. Geliştirme ve üretim için ayrı anahtarlar kullanmanızı ve geliştirme sitesi anahtarınızda yalnızca localhost'a izin vermenizi öneririz.
-
Yalnızca iOS 10'da, kullanıcı testi tamamladığında sayfa en alta kaydırılıyor mu?
-
Bu, Apple tarafında odaklanmayla ilgili bir hatadır ve kendilerine bildirilmiştir. Yalnızca iOS 10'daki kullanıcıları ve yalnızca bazı siteleri etkiler. Bu durumdan etkilendiyseniz geçici bir çözüm olarak reCAPTCHA widget'ını sayfada daha yukarı veya aşağı taşıyabilir ya da reCAPTCHA s3'ü kullanabilirsiniz.
-
Bilgisayarım veya ağım otomatik sorgular gönderiyor olabilir mi?
-
Bu sayfaya reCAPTCHA widget'ından yönlendirildiyseniz "Maalesef bilgisayarınız veya ağınız otomatik sorgular gönderiyor olabilir. Kullanıcılarımızı korumak için isteğinizi şu anda işleme alamıyoruz."
Bu durum, iyi niyetli kullanıcıların da başına gelebilir. Bunun birkaç nedeni vardır:
- Kötüye kullanılan ortak bir ağda olabilirsiniz.
- İnternet servis sağlayıcınız yakın zamanda size şü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 bakı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: 2026-11-05 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: 2026-11-05 UTC."],[],["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"]]