Sık Sorulan Sorular
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
-
reCAPTCHA Enterprise'ı kullanmalı mıyım?
-
reCAPTCHA Enterprise ayda 10.000'e kadar ücretsiz değerlendirme sunar
ve ek özellikler de sunar.
Diğer özellikler
gibi gerçek zamanlı analizler, ç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 dışı sürüm) hem de reCAPTCHA'yı kullanabilirsiniz
Kurumsal. Genellikle üçüncü taraf çözümü ortak anahtarınızı ister
gizli anahtarınız veya API anahtarınız. Yalnızca
güvenilir üçüncü taraflara için gizli anahtar ve API anahtarı sunar.
-
v2 veya v3'ten reCAPTCHA Enterprise'a nasıl geçiş yapılır?
-
taşıma süreci
Bu anketin tamamlanması 5-10 dakika sürer ve kod değişikliği gerektirmez.
-
reCAPTCHA v2 mi v3 mü kullanmalıyım?
-
reCAPTCHA v3, trafikleri hakkında daha fazla veri isteyen site sahipleri için tasarlanmıştır.
Daha fazla bilgi için reCAPTCHA v3 geliştirici kılavuzunu inceleyin.
v2'de güvenlik ve kullanılabilirliği destekliyoruz.
reCAPTCHA v2 ve v3 farklılıkları hakkında daha fazla bilgi için sürüm karşılaştırmasına bakın.
-
reCAPTCHA çerez kullanır mı?
- .
reCAPTCHA, risk analizini sağlamak amacıyla yürütüldüğünde gerekli bir çerezi (_GRECAPTCHA) ayarlar.
Başka çerezlerin ayarlandığı www.google.com alanını kullanmak istemiyorsanız bunun yerine www.recaptcha.net adresini kullanabilirsiniz.
-
reCAPTCHA'yı kullanımımda QPS veya günlük sınırlar var mı?
- .
Saniyede 1.000'den veya ayda 1.000.000'den fazla çağrı yapmak istiyorsanız şunu kullanmanız gerekir:
reCAPTCHA Enterprise'ı doldurun veya
bu formu doldurun ve istisna onayını bekleyin.
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 açılamayabilir
0,9 statik puanı ve "Ücretsiz kota aşımı" hata mesajı döndürerek.
kullanabilirsiniz. Kullanıcılar tarafından görülebilecekleri
v3 siteleri kotayı aştı.
Bir v2 site anahtarı aylık kotasını aşarsa aşağıdaki
Mesaj, reCAPTCHA widget'ında kullanıcılara gösterilebilir ve
of the month: "Bu site reCAPTCHA kotasını aşıyor."
Kota uygulanmadan önce, site sahipleri e-posta ile üç kez bilgilendirilir
ve reCAPTCHA Enterprise'a taşınması için en az 90 gün süre tanınmalıdır.
Ayda 1000.000'den fazla çağrı olduğunda site anahtarları kotanın aşıldığı kabul edilir
tüm alanlar için kullanılır. Bu, bu hacmin birden fazla veriye ve
aynı alan adında yer alır.
-
reCAPTCHA rozetini gizlemek istiyorum. Nelere izin verilir?
-
Kullanıcı işlemleri akışında reCAPTCHA markasına görsel olarak yer verdiğ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 tercih ederseniz lütfen şunu kullanın:
.grecaptcha-badge { visibility: hidden; }
-
reCAPTCHA ile otomatik testler yapmak istiyorum. Ne yapmalıyım?
-
reCAPTCHA v3 için test ortamlarına yönelik ayrı bir anahtar oluşturun. reCAPTCHA v3 gerçek trafiğin gösterilmesine dayandığından puanlar doğru olmayabilir.
reCAPTCHA v2 için aşağıdaki test anahtarlarını kullanın. Her zaman "CAPTCHA yok" mesajı 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 için bir uyarı mesajı gösterir.
-
Sitemde hata ayıklarken reCAPTCHA koduna girmekten nasıl kaçınabilirim?
-
Sitenizdeki diğer JavaScript kodlarında 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 bir komut dosyası listesini yoksayma başlıklı makaleyi inceleyin. Benzer özellikler başka tarayıcılarda da mevcuttur.
-
Web sitemin trafiği hakkında nasıl daha fazla bilgi edinebilirim?
-
reCAPTCHA, Yönetici Konsolu'nda günlük istatistikleri bildirir.
-
reCAPTCHA'yı dünya genelinde kullanabilir miyim?
-
Evet, lütfen "www.recaptcha.net" adresini kullanın. "www.google.com.tr" gibi belirli durumlarda erişilebilir değil.
- İlk olarak <script src="https://www.google.com/recaptcha/api.js"></script> <script src="https://www.recaptcha.net/recaptcha/api.js"></script> ile
- Ardından, "www.google.com/recaptcha/" adresini kullanan diğer her yerde aynı yöntemi uygulayın. hakkında bilgi edindiniz.
-
-
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 öğesinde data-theme özelliğini ayarlayın
parametresini kullanın.
Açık tema:
Koyu tema:
-
reCAPTCHA v3'ü nasıl özelleştirebilirim?
-
Görünmez reCAPTCHA için kullanılan JavaScript API'si v3'te de çalışır. Rozeti yeniden konumlandırma veya temayı değiştirme gibi seçeneklere erişmek üzere reCAPTCHA'yı v3 site anahtarıyla açıkça oluşturmak için JavaScript API'yi kullanmanız yeterlidir.
Bu yöntemle reCAPTCHA v3 oluştururken size parametresini 'invisible' olarak ayarlamayı ve site anahtarı yerine grecaptcha.execute çağrısı yaparken grecaptcha.render tarafından döndürülen istemci kimliğini kullanmayı unutmayın.
-
-
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 bu sayfadaki talimatları uygulayın.
-
Yakalanmamış bir SecurityError alıyorum: kaynağı "https://www.google.com" olan bir çerçeve engellendi "<alan adınız>" kökenli bir çerçeveye erişmesini engelleyebilirsiniz. Ne yapmalıyım?
-
Bu durum genellikle reCAPTCHA widget HTML öğesi, son kullanıcı onay kutusunu tıkladıktan bir süre sonra programlı 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. Bunu reCAPTCHA ile çalışacak şekilde nasıl yapılandırabilirim?
-
CSP3'te belgelenen rastgele olmayan yaklaşımı kullanmanızı öneririz.
Tek seferlik rastgele verilerinizi reCAPTCHA api.js komut dosyası etiketine eklediğinizden emin olun. Gerisini biz hallederiz.
Not: reCAPTCHA, onu 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/
-
"Localhost is the list of supported domains" (Yerel barındırıcı, desteklenen alanlar listesinde yok) hatası alıyorum. Ne yapmalıyım?
-
localhost alanları varsayılan olarak desteklenmez. Onlara destek vermeye devam etmek
bunu site anahtarınız için desteklenen alanlar listesine ekleyebilirsiniz. Şuraya gidin:
reCAPTCHA Enterprise konsolu
veya gerekirse reCAPTCHA konsoluna
seçeneğini tıklayarak desteklenen alanlar listenizi güncelleyin. Geliştirme ve kontrol süreçleri için ayrı anahtarlar
üretim sitesi anahtarınızda yalnızca localhost'a izin verin.
-
Yalnızca iOS 10'da kullanıcı sorgulamayı tamamladığında sayfa en alta mı kaydırılıyor?
-
Bu hata, Apple'a bildirdiğimiz konuyla ilgili olarak gündeme geliyor. Yalnızca iOS 10 sürümüne sahip kullanıcıları ve sadece bazı sitelerdeki kullanıcıları etkiler. Bu durumdan etkileniyorsanız reCAPTCHA widget'ını sayfada daha üst veya daha alta taşımak ya da reCAPTCHA v3'ü kullanmak geçici bir çözüm olabilir.
-
Bilgisayarım veya ağım otomatik sorgular gönderiyor olabilir.
-
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 amacıyla isteğinizi şu anda işleme alamıyoruz."
Maalesef bu durumun iyi bir kullanıcı olmasının birkaç nedeni olabilir:
- Kötüye kullanım amaçlı olarak kullanılan paylaşılan bir ağda olabilirsiniz
- İnternet servis sağlayıcınız kısa süre önce size şüpheli bir IP adresi atamış olabilir
- Erişmeye çalıştığınız site şu anda ağır saldırı altında olabilir
Bu sorunları gidermek için lütfen normal trafikle ilgili 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 çizgi ve alt çizgiler içerebilir.
İşlemler kullanıcıya özel olmamalıdır.
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-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 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,["# Frequently Asked Questions\n\n### Should I use reCAPTCHA Enterprise?\n\n\n:\n reCAPTCHA Enterprise offers up to 10,000 assessments per month at no cost\n and also provides additional features.\n [Other features](https://cloud.google.com/recaptcha-enterprise/docs/compare-versions)\n such as real time analytics provide the best place to start for most developers.\n [Get started here.](https://www.google.com/recaptcha/admin/enterprise)\n\n\n### Can I use reCAPTCHA with third party solutions?\n\n\n:\n Yes, you can use both reCAPTCHA (non-Enterprise version) and reCAPTCHA\n Enterprise. Typically the third party solution asks for your public key\n and either your secret key or your API key. Make sure to only provide your\n secret key and API key to trusted third parties.\n\n\n### How to migrate to reCAPTCHA Enterprise from v2 or v3?\n\n\n:\n The [migration process](http://cloud.google.com/recaptcha-enterprise/docs/migrate-recaptcha)\n takes 5-10 minutes to complete and requires no code changes.\n\n\n### Should I use reCAPTCHA v2 or v3?\n\n\n:\n reCAPTCHA v3 is for site owners who want more data about their traffic.\n For more information, see the [reCAPTCHA v3 developer guide](/recaptcha/docs/v3).\n\n We support security and usability for v2.\n\n\n For more information about reCAPTCHA v2 and v3 differences, see [versions comparison](/recaptcha/docs/versions).\n\n\n### Does reCAPTCHA use cookies?\n\n\n:\n reCAPTCHA sets a necessary cookie (_GRECAPTCHA) when executed for the purpose of providing its risk analysis.\n If you prefer to not use the www.google.com domain which may have other cookies set, you can use www.recaptcha.net instead.\n\n\n### Are there any QPS or daily limits on my use of reCAPTCHA?\n\n\n:\n If you wish to make more than 1000 calls per second or 1000000 calls per month, you must use\n [reCAPTCHA Enterprise](https://cloud.google.com/recaptcha-enterprise) or fill out\n [this form](https://forms.gle/caCX5Sgkz2N1maGa9) and wait for an exception approval.\n If a site key exceeds 1000 QPS, then some requests may not be processed.\n If a v3 site key exceeds its monthly quota, then site_verify may fail open\n by returning a static score 0.9 and an error message \\`\"Over free quota.\"\\`\n for the remainder of the month. There are no user-visible indications when\n v3 sites are over quota.\n If a v2 site key exceeds its monthly quota, then the following or a similar\n message may be displayed to users in the reCAPTCHA widget for the remainder\n of the month: \\`This site is exceeding reCAPTCHA quota.\\`\n Before quota is enforced, site owners will be notified by email three times\n and given at least 90 days to migrate to reCAPTCHA Enterprise.\n Site keys are considered over quota if more than 1000000 calls per month are\n used for any domain. This includes if this volume is spread across multiple\n keys on the same domain.\n\n\n### I'd like to hide the reCAPTCHA badge. What is allowed?\n\n\n: You are allowed to hide the badge as long as you include the reCAPTCHA branding visibly in the user flow. Please include the following text:\n\n ```html\n This site is protected by reCAPTCHA and the Google\n \u003ca href=\"https://policies.google.com/privacy\"\u003ePrivacy Policy\u003c/a\u003e and\n \u003ca href=\"https://policies.google.com/terms\"\u003eTerms of Service\u003c/a\u003e apply.\n ```\n\n For example:\n\n **Note:** if you choose to hide the badge, please use \n\n ```css\n .grecaptcha-badge { visibility: hidden; }\n ```\n\n \u003cbr /\u003e\n\n\n### I'd like to run automated tests with reCAPTCHA. What should I do?\n\n\n: For reCAPTCHA v3, create a separate key for testing environments. Scores may not be accurate as reCAPTCHA v3 relies on seeing real traffic.\n\n For reCAPTCHA v2, use the following test keys. You will always get No CAPTCHA and all verification requests will pass.\n\n - Site key: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI\n - Secret key: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe\n\n The reCAPTCHA widget will show a warning message to ensure it's not used for production traffic.\n\n\n### How can I avoid stepping into reCAPTCHA code when debugging my site?\n\n\n: To avoid stepping into the reCAPTCHA code while debugging other JavaScript on your site, add the reCAPTCHA script `/recaptcha__.+\\.js$` to your browser's ignore list. For instructions for Chrome, refer to [Ignore a custom list of scripts](https://developer.chrome.com/docs/devtools/settings/ignore-list). Similar features are available in other browsers.\n\n\n### How can I see more about my website's traffic?\n\n\n: reCAPTCHA reports daily stats in the [admin console](https://www.google.com/recaptcha/admin).\n\n\n### Can I use reCAPTCHA globally?\n\n\n: Yes, please use \"www.recaptcha.net\" in your code in circumstances when \"www.google.com\" is not accessible.\n\n - First, replace \\\u003cscript src=\"https://**www.google.com** /recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e with \\\u003cscript src=\"https://**www.recaptcha.net**/recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e\n - After that, apply the same to everywhere else that uses \"www.google.com/recaptcha/\" on your site.\n\n\n### Can I customize the reCAPTCHA widget or badge?\n\n\n: Yes. reCAPTCHA offers two themes, light and dark, as shown below. To choose a theme, simply\n set the data-theme attribute in the [grecaptcha.render\n parameter](/recaptcha/docs/display#render_param).\n\n Light theme:\n\n Dark theme:\n\n\n### How can I customize reCAPTCHA v3?\n\n\n: The [JavaScript API](/recaptcha/docs/invisible#js_api) available for Invisible reCAPTCHA also works for v3. Simply use the JavaScript API to explicitly render reCAPTCHA with a v3 site key to access options such as repositioning the badge or changing the theme.\n\n When rendering reCAPTCHA v3 with this method, remember to set the `size` parameter to `'invisible'` and use the client ID returned by `grecaptcha.render` when calling `grecaptcha.execute` instead of the site key.\n\n\n### Recently my reCAPTCHA widget started displaying \"Invalid site key\". What's happening?\n\n\n:\n\n If you are seeing this error, your reCAPTCHA site key is no longer valid. To activate, please\n [register a new key](https://www.google.com/recaptcha/admin) and follow the [instructions](/recaptcha/intro) on that page.\n\n\n### I'm getting an uncaught SecurityError: blocked a frame with origin \"https://www.google.com\" from accessing a frame with origin \"\\<your domain\\>\". What should I do?\n\n\n: This typically occurs if the reCAPTCHA widget HTML element is programmatically removed sometime after the end user clicks on the checkbox. We recommend using the [grecaptcha.reset()](/recaptcha/docs/display#js_api) javascript function to reset the reCAPTCHA widget.\n\n\n### I'm using Content-Security-Policy (CSP) on my website. How can I configure it to work with reCAPTCHA?\n\n\n: We recommend using the nonce-based approach documented with [CSP3](https://w3c.github.io/webappsec-csp/#framework-directive-source-list).\n Make sure to include your nonce in the reCAPTCHA [api.js](/recaptcha/docs/display#auto_render) script tag, and we'll handle the rest.\n\n Note: reCAPTCHA also works with ['strict-dynamic'](https://w3c.github.io/webappsec-csp/#strict-dynamic-usage) on browsers that support it.\n\n Alternatively, please add the following values to the directives:\n\n - **script-src** https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/\n - **frame-src** https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/\n\n\n### I'm getting an error \"Localhost is not in the list of supported domains\". What should I do?\n\n\n: localhost domains are not supported by default. If you wish to continue supporting them for\n development you can add them to the list of supported domains for your site key. Go to the\n [reCAPTCHA Enterprise console](https://console.cloud.google.com/security/recaptcha)\n or to the [reCAPTCHA console](https://www.google.com/recaptcha/admin), as appropriate,\n to update your list of supported domains. We advise to use separate keys for development and\n production, and to only allow localhost on your development site key.\n\n\n### Only on iOS 10, the page scrolls to the bottom when the user completes the challenge?\n\n\n: This is a focusing bug on Apple's side that we've reported to them. It affects users only on iOS 10 and only on some sites. If you are affected, a workaround is to move the reCAPTCHA widget higher or lower on the page, or use [reCAPTCHA v3](/recaptcha/docs/v3).\n\n\n### My computer or network may be sending automated queries?\n\n\n: If you were directed to this page from the reCAPTCHA widget, you would have seen a message that said \"We're sorry, but your computer or network may be sending automated queries. To protect our users, we can't process your request right now.\"\n\n This can unfortunately happen to good users for a few reasons:\n\n - You may be on a shared network that is being used abusively\n - Your internet service provider may have recently assigned you a suspicious IP address\n - The site you are trying to access may be currently under heavy attack\n\n To troubleshoot these issues, please look at the [unusual traffic help page](https://support.google.com/websearch/answer/86640), or try again later.\n\n\n### What action names are valid?\n\n\n: Actions might contain only alphanumeric characters, slashes, and underscores.\n Actions must not be user-specific."]]
