Najczęstsze pytania
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
-
Czy mam korzystać z reCAPTCHA Enterprise?
-
reCAPTCHA Enterprise oferuje do 10 tys. testów miesięcznie bez opłat
a także dodatkowe funkcje.
Inne funkcje
np. analityka w czasie rzeczywistym to dobry punkt wyjścia dla większości deweloperów.
Rozpocznij tutaj.
-
Czy mogę używać reCAPTCHA z rozwiązaniami innych firm?
-
Tak, możesz używać zarówno reCAPTCHA (wersja inna niż Enterprise), jak i reCAPTCHA
Dla firm. Zwykle rozwiązanie innej firmy prosi o klucz publiczny
i tajny klucz albo klucz interfejsu API. Pamiętaj, aby podać tylko
tajny klucz i klucz interfejsu API do zaufanych firm zewnętrznych.
-
Jak przejść na reCAPTCHA Enterprise z wersji 2 lub 3?
-
proces migracji
Zajmie to 5–10 minut i nie wymaga żadnych zmian w kodzie.
-
Używam reCAPTCHA w wersji 2 czy 3?
-
reCAPTCHA w wersji 3 jest przeznaczona dla właścicieli witryn, którzy chcą uzyskać więcej danych o ruchu.
Więcej informacji znajdziesz w przewodniku dla programistów reCAPTCHA w wersji 3.
Dbamy o bezpieczeństwo i łatwość obsługi wersji 2.
Więcej informacji o różnicach między reCAPTCHA w wersjach 2 i 3 znajdziesz w sekcji Porównanie wersji.
-
Czy reCAPTCHA używa plików cookie?
-
Podczas wykonywania reCAPTCHA ustawia niezbędny plik cookie (_GRECAPTCHA) na potrzeby analizy ryzyka.
Jeśli nie chcesz używać domeny www.google.com, w której mogą być ustawione inne pliki cookie, możesz użyć www.recaptcha.net.
-
Czy podczas korzystania z reCAPTCHA obowiązują jakieś limity zapytań na sekundę lub limity dzienne?
-
Jeśli chcesz wykonywać więcej niż 1000 połączeń na sekundę lub 1000000 połączeń miesięcznie, musisz użyć funkcji
reCAPTCHA Enterprise lub wypełnij
ten formularz i zaczekać na zatwierdzenie wyjątku.
Jeśli klucz witryny przekracza 1000 zapytań na sekundę, niektóre żądania mogą nie zostać przetworzone.
Jeśli klucz witryny w wersji 3 przekracza limit miesięczny, może się nie udać otworzyć witryna site_verify
zwracając statyczny wynik 0,9 i wyświetlając komunikat o błędzie „Przekroczono limit”.
do końca miesiąca. Nie ma żadnych informacji widocznych dla użytkowników,
Witryny w wersji 3 przekraczają limit.
Jeśli klucz witryny w wersji 2 przekracza limit miesięczny, to:
wiadomość może być wyświetlana użytkownikom w widżecie reCAPTCHA do końca
dnia miesiąca: „Ta witryna przekracza limit reCAPTCHA”.
Przed wyegzekwowaniem limitów właściciele witryn 3 razy dostaną e-maila z powiadomieniem
i masz co najmniej 90 dni na migrację do reCAPTCHA Enterprise.
Klucze witryny są uznawane za przekroczone, jeśli zostanie wykonane ponad 1 000 000 wywołań miesięcznie
dla dowolnej domeny. Bierzemy pod uwagę, że wielkość sprzedaży jest rozłożona w wielu
w tej samej domenie.
-
Chcę ukryć plakietkę reCAPTCHA. Co jest dozwolone?
-
Możesz ukryć plakietkę, o ile w widocznym miejscu w ścieżce użytkownika znajduje się wyraźnie widoczna marka reCAPTCHA. Podaj ten tekst:
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.
Na przykład:
Uwaga: jeśli chcesz ukryć plakietkę, użyj przycisku
.grecaptcha-badge { visibility: hidden; }
-
Chcę przeprowadzać automatyczne testy za pomocą reCAPTCHA. Co mam zrobić?
-
W przypadku reCAPTCHA w wersji 3 utwórz oddzielny klucz dla środowisk testowych. Wyniki mogą nie być dokładne, ponieważ reCAPTCHA w wersji 3 wymaga śledzenia rzeczywistego ruchu.
W przypadku reCAPTCHA w wersji 2 użyj poniższych kluczy testowych. Zawsze wyświetli się Brak CAPTCHA, a wszystkie żądania weryfikacji zostaną zaakceptowane.
- Klucz witryny: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
- Tajny klucz: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe
Widżet reCAPTCHA będzie wyświetlać ostrzeżenie, aby sprawdzić, czy nie jest on używany w ruchu produkcyjnym.
-
Jak uniknąć logowania się w kodzie reCAPTCHA podczas debugowania witryny?
-
Aby uniknąć wchodzenia w kod reCAPTCHA podczas debugowania innego kodu JavaScript w witrynie, dodaj skrypt reCAPTCHA /recaptcha__.+\.js$ do listy ignorowanych fragmentów przeglądarki. Instrukcje dotyczące Chrome znajdziesz w artykule Ignorowanie niestandardowej listy skryptów. Podobne funkcje są dostępne w innych przeglądarkach.
-
Jak mogę uzyskać więcej informacji o ruchu w mojej witrynie?
-
reCAPTCHA raportuje dzienne statystyki w konsoli administracyjnej.
-
Czy mogę używać reCAPTCHA globalnie?
-
Tak, użyj adresu „www.recaptcha.net” w kodzie w przypadku, gdy adres „www.google.com” jest niedostępny.
- Najpierw zastąp <script src="https://www.google.com/recaptcha/api.js"></script> z <script src="https://www.recaptcha.net/recaptcha/api.js"></script>
- Następnie zastosuj go na wszystkich urządzeniach, które korzystają z adresu „www.google.com/recaptcha/” w Twojej witrynie.
-
-
Tak. reCAPTCHA oferuje 2 motywy: jasny i ciemny, jak pokazano poniżej. Aby wybrać motyw,
ustaw atrybut data-theme w grecaptcha.render
.
Jasny motyw:
Ciemny motyw:
-
Jak dostosować reCAPTCHA w wersji 3?
-
Interfejs JavaScript API dostępny w przypadku Invisible reCAPTCHA działa również w wersji 3. Wystarczy, że użyjesz interfejsu JavaScript API, aby bezpośrednio wyrenderować reCAPTCHA za pomocą klucza witryny w wersji 3, aby uzyskać dostęp do opcji takich jak zmiana położenia plakietki czy zmiana motywu.
Podczas renderowania reCAPTCHA w wersji 3 za pomocą tej metody pamiętaj, aby ustawić parametr size na 'invisible' i użyć identyfikatora klienta zwróconego przez grecaptcha.render przy wywoływaniu funkcji grecaptcha.execute zamiast klucza witryny.
-
-
Jeśli widzisz ten błąd, oznacza to, że klucz witryny reCAPTCHA nie jest już prawidłowy. Aby aktywować,
zarejestruj nowy klucz i postępuj zgodnie z instrukcjami na tej stronie.
-
Pojawia się nieprzechwycony błąd SecurityError: ramka o źródle „https://www.google.com” została zablokowana dostępu do ramki z punktem początkowym „<twoja domena>”. Co mam zrobić?
-
Dzieje się tak zwykle wtedy, gdy element HTML widżetu reCAPTCHA zostanie automatycznie usunięty jakiś czas po kliknięciu tego pola przez użytkownika. Do zresetowania widżetu reCAPTCHA zalecamy użycie funkcji JavaScript grecaptcha.reset().
-
W swojej witrynie używam Content-Security-Policy (CSP). Jak mogę skonfigurować tę usługę pod kątem współpracy z reCAPTCHA?
-
Zalecamy stosowanie metody opartej na liczbie jednorazowej udokumentowanej w CSP3.
Pamiętaj, aby uwzględnić identyfikator jednorazowy w tagu skryptu reCAPTCHA api.js, a my zajmiemy się resztą.
Uwaga: reCAPTCHA działa też z parametrem 'strict-dynamic' w przeglądarkach, które go obsługują.
Możesz też dodać te wartości do dyrektyw:
- script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
- frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
-
Pojawia się błąd „Localhost nie znajduje się na liście obsługiwanych domen”. Co mam zrobić?
-
domeny localhost nie są domyślnie obsługiwane. Jeśli chcesz kontynuować wsparcie dla
możesz dodać je do listy obsługiwanych domen dla Twojego klucza witryny. Przejdź do
Konsola reCAPTCHA Enterprise
lub w konsoli reCAPTCHA.
aby zaktualizować listę obsługiwanych domen. Zalecamy używanie oddzielnych kluczy do programowania
w środowisku produkcyjnym i zezwolenie na hostowanie lokalne tylko w kluczu witryny programowania.
-
Tylko w systemie iOS 10 strona przewija się w dół, gdy użytkownik wykonuje zadanie?
-
Jest to błąd skupiony na stronie firmy Apple, który mu zawiadomiliśmy. Dotyczy to tylko użytkowników urządzeń z systemem iOS 10 i tylko w niektórych witrynach. W tym przypadku możesz obejść ten problem, przenosząc widżet reCAPTCHA wyżej lub niżej na stronie albo używając funkcji reCAPTCHA v3.
-
Być może mój komputer lub sieć wysyła automatyczne zapytania?
-
Jeśli nastąpiło przekierowanie na tę stronę z widżetu reCAPTCHA, powinien wyświetlić się komunikat „Przepraszamy, ale Twój komputer lub sieć może wysyłać automatyczne zapytania. Aby chronić naszych użytkowników, nie możemy teraz przetworzyć Twojej prośby”.
Może się tak zdarzyć w przypadku dobrych użytkowników z kilku powodów:
- Być może korzystasz z sieci współdzielonej, która jest nadużywana.
- Twój dostawca usług internetowych mógł ostatnio przypisać Ci podejrzany adres IP
- Strona, do której próbujesz uzyskać dostęp, może być obecnie atakowana intensywnie
Aby rozwiązać te problemy, przeczytaj informacje na stronie pomocy dotyczącej nietypowego ruchu lub spróbuj ponownie później.
-
Które nazwy działań są prawidłowe?
-
Działania mogą zawierać tylko znaki alfanumeryczne, ukośniki i podkreślenia.
Działania nie mogą być związane z konkretnymi użytkownikami.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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."]]
