このページは Cloud Translation API によって翻訳されました。

よくある質問

reCAPTCHA Enterprise を使用する必要がありますか？

reCAPTCHA Enterprise は、1 か月あたり 100 万回の評価を無料で、追加機能でご利用いただけます。ほとんどのデベロッパーは、リアルタイム解析などの他の機能から始めるのが最適です。こちらから無料でお試しいただけます。

reCAPTCHA はサードパーティのソリューションで使用できますか？

はい。reCAPTCHA（非 Enterprise バージョン）と reCAPTCHA Enterprise の両方を使用できます。通常、サードパーティソリューションは公開鍵と、秘密鍵または API キーのいずれかを要求します。秘密鍵と API キーは、信頼できるサードパーティにのみ提供してください。

v2 または v3 から reCAPTCHA Enterprise に移行するには？

移行プロセスが完了するまでに 5 ～ 10 分かかります。コードを変更する必要はありません。

reCAPTCHA v2 と v3 のどちらを使用すべきですか？

reCAPTCHA v3 は、トラフィックに関するデータがさらに必要なサイト所有者向けです。詳細については、reCAPTCHA v3 デベロッパーガイドをご覧ください。

v2 ではセキュリティとユーザビリティがサポートされています。

reCAPTCHA v2 と v3 の違いについて詳しくは、バージョンの比較をご覧ください。

reCAPTCHA v2 と v3 を同じページで使用できますか？

そのためには、ドキュメントにあるように v3 サイトキーを読み込み、grecaptcha.render を使用して v2 を明示的にレンダリングします。

<html>
  <head>
    <title>reCAPTCHA demo: Running both v2 and v3</title>
    <script src="https://www.google.com/recaptcha/api.js?render=v3_site_key"></script>
    <script>
      grecaptcha.ready(() => {
        grecaptcha.render('html_element', {
           'sitekey' : 'v2_site_key'
        });
      });
    </script>
    <script>
      function onSubmit() {
        grecaptcha.ready(() => {
            grecaptcha.execute('v3_site_key', {action: 'homepage'}).then((token) => {
               ...
            });
        });
      }
    </script>
  </head>
</html>

reCAPTCHA は Cookie を使用しますか？

reCAPTCHA は、リスク分析を行うために、実行時に必要な Cookie（_GRECAPTCHA）を設定します。 www.google.com ドメインを使用して他の Cookie を設定したくない場合は、代わりに www.recaptcha.net を使用できます。

reCAPTCHA の使用に QPS や 1 日あたりの上限はありますか？

1 秒あたり 1,000 回または 1 か月あたり 1000,000 回を超える呼び出しを行う場合は、 reCAPTCHA Enterprise を使用するか、こちらのフォームに記入して例外の承認を待つ必要があります。サイトキーが 1, 000 QPS を超えると、一部のリクエストが処理されない場合があります。v3 サイトキーが 1 か月の割り当てを超えると、その月の残りの期間、site_verify が静的スコア 0.9 とエラーメッセージ「Over free quota.」を返してフェイルオープンする場合があります。v3 サイトの割り当て量が超過しても、ユーザーに表示されることはありません。 v2 サイトキーが 1 か月の割り当てを超えると、その月の残りの期間、reCAPTCHA ウィジェットに「このサイトは reCAPTCHA の割り当てを超過しています」というメッセージまたは同様のメッセージが表示されます。割り当てが適用される前に、サイト所有者にはメールで 3 回通知され、reCAPTCHA Enterprise に移行するための少なくとも 90 日間の猶予が与えられます。いずれかのドメインで 1 か月あたり 1,000,000 回を超える呼び出しが使用されている場合、サイトキーは割り当てを超過しているとみなされます。これには、このボリュームが同じドメインの複数のキーに分散している場合も含まれます。

reCAPTCHA バッジを非表示にします。どうすればよいですか？

ユーザーフローに reCAPTCHA のブランドを視覚的に表示している限り、バッジを非表示にできます。次のテキストを含めてください。

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.

次に例を示します。

注: バッジを非表示にする場合は、

.grecaptcha-badge { visibility: hidden; }

を使用してください。

reCAPTCHA を使用して自動テストを行いたい。必要な対策

reCAPTCHA v3 の場合は、テスト環境用に別のキーを作成します。reCAPTCHA v3 は実際のトラフィックの確認に依存しているため、スコアが正確でない可能性があります。

reCAPTCHA v2 の場合は、次のテストキーを使用します。常に CAPTCHA が表示されず、確認リクエストはすべてパスします。

サイトキー: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
秘密鍵: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

reCAPTCHA ウィジェットには、本番環境のトラフィックに使用されていないことを確認する警告メッセージが表示されます。

ウェブサイトのトラフィックの詳細を確認するにはどうすればよいですか？

reCAPTCHA は、管理コンソールに reCAPTCHA の日次統計を報告します。

reCAPTCHA は世界中で使用できますか？

はい。「www.google.com」にアクセスできない場合は、コードで「www.recaptcha.net」を使用してください。

まず、<script src="https://www.google.com/recaptcha/api.js"></script> を <script src="https://www.recaptcha.net/recaptcha/api.js"></script> に置き換えます。
その後、サイトで「www.google.com/recaptcha/」を使用するすべての場所に同じ方法を適用します。

reCAPTCHA のウィジェットまたはバッジをカスタマイズできますか？

はい。reCAPTCHA には、以下に示すように、ライトモードとダークモードの 2 つのテーマが用意されています。テーマを選択するには、grecaptcha.render パラメータに data-theme 属性を設定します。

ライトモード

ダークモード:

reCAPTCHA v3 をカスタマイズするにはどうすればよいですか？

Invisible reCAPTCHA で利用可能な JavaScript API は v3 でも機能します。JavaScript API を使用して v3 のサイトキーで reCAPTCHA を明示的にレンダリングすると、バッジの位置やテーマの変更などのオプションにアクセスできます。

このメソッドで reCAPTCHA v3 をレンダリングする場合は、必ず size パラメータを 'invisible' に設定し、grecaptcha.execute を呼び出すときにサイトキーの代わりに grecaptcha.render から返されるクライアント ID を使用してください。

最近、reCAPTCHA ウィジェットに「無効なサイトキー」と表示されるようになりました。いまどうしてる？

このエラーが表示された場合は、reCAPTCHA サイトキーが無効になっています。有効にするには、新しいキーを登録し、そのページの手順に沿って操作してください。

捕捉されない SecurityError: オリジン「https://www.google.com」のフレームが、オリジン「&ltyour domain&gt」のフレームにアクセスできないようにブロックされました。必要な対策

これは通常、エンドユーザーがチェックボックスをクリックした後に、reCAPTCHA ウィジェットの HTML 要素がプログラムで削除された場合に発生します。JavaScript 関数 grecaptcha.reset() を使用して reCAPTCHA ウィジェットをリセットすることをおすすめします。

ウェブサイトで Content-Security-Policy（CSP）を使用しています。reCAPTCHA と連携するように構成するにはどうすればよいですか？

CSP3 に記載されているノンスベースのアプローチを使用することをおすすめします。reCAPTCHA の api.js スクリプトタグにノンスを含めてください。後は Google が処理します。

注: reCAPTCHA は、対応しているブラウザでは 'strict-dynamic' を指定しても動作します。

または、ディレクティブに次の値を追加してください。

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 はサポートされているドメインのリストにありません」というエラーが表示されます。必要な対策

localhost ドメインは、デフォルトではサポートされていません。引き続き開発をサポートするには、サイトキーでサポートされているドメインのリストにドメインを追加してください。必要に応じて reCAPTCHA Enterprise コンソールまたは reCAPTCHA コンソールに移動して、サポートされているドメインのリストを更新します。開発環境と本番環境では別々のキーを使用し、開発サイトキーでは localhost のみを許可することをおすすめします。

iOS 10 でのみ、ユーザーがチャレンジを完了すると、ページが一番下までスクロールしますか？

これは Apple 側に焦点を当てたバグであり、すでに Apple に報告済みです。iOS 10 と一部のサイトのユーザーのみに影響します。その場合は、reCAPTCHA ウィジェットをページの上下に移動するか、reCAPTCHA v3 を使用してください。

コンピュータまたはネットワークから自動クエリが送信されている可能性はありますか？

reCAPTCHA ウィジェットからこのページにリダイレクトされた場合は、「申し訳ありません。ご利用のパソコンまたはネットワークから自動クエリが送信されている可能性があります。ユーザーを保護するため、現在お客様のリクエストを処理することはできません。」

優良なユーザーにとっては、残念ながら次のような理由でこのようなことが起こる可能性があります。

不正使用されている共有ネットワークに接続している可能性があります
最近、インターネットサービスプロバイダから不審な IP アドレスが割り当てられた可能性があります
アクセスしようとしているサイトは、現在大規模な攻撃を受けている可能性があります

これらの問題のトラブルシューティングを行うには、通常とは異なるトラフィックに関するヘルプページを確認するか、しばらくしてからもう一度お試しください。

有効なアクション名

アクションに使用できるのは英数字、スラッシュ、アンダースコアのみです。アクションはユーザー固有のものであってはなりません。