reCAPTCHAサイトプロファイルを設定する

1. 1.

   ワークスペースを確認する

   タスクの作成に使用する API キーのワークスペースに、プロファイルを設定してください。別のワークスペースにプロファイルがあっても使用できません。コンソールに「続行するにはクレジットを追加」と表示された場合は、その案内に従ってから設定を続けてください。

2. 2.

   「サイトを追加」を開く

   「サイトプロファイル」で「サイトを追加」を選択します。「ページ URL」に対象の HTTPS ページを入力します。「reCAPTCHA の種類」では、ページに合わせて Enterprise v3 または Regular v3 を選択してください。

3. 3.

   キャプチャの入力項目を設定する

   「キャプチャアクション」は必須です。解決対象のアクションを指定してください。不明な場合は、先に reCAPTCHA アクションを確認してください。フォームには任意項目の「ナビゲーション URL」「サイトキー」「Referer 値」もあります。サイトキーは自動検出できます。

4. 4.

   フォームを送信する

   「サイトを追加」を選択します。レビュー済みのシステムプロファイルでは、ライブ取得を行わずに、既知のページ仕様とキャプチャアクションを入力できます。選択されたアクションについてはフォームに説明が表示されます。それ以外の送信では、キュー待ち、キャプチャ中、検証中、レビューのいずれかの状態になる場合があります。

作成されたプロファイルのステータスを確認してください。ACTIVE は active と表示され、解決にはこの状態が必要です。キャプチャに失敗した場合は、コンソールに理由が表示され、再試行できます。

このタスクの本文では、プロファイルのホスト名とアクションを使用しています。

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• site は「ページ URL」のホスト名で、スキームやパスは含めません。
• action は保護対象のリクエストのアクションです。使用するプロファイルと一致させてください。
• recaptchaType のデフォルトは enterprise-v3 です。Regular v3 のプロファイルでは、明示的に v3 を設定してください。
• プロキシのプレースホルダーを、対象リクエストでも使用する HTTP(S) プロキシに置き換えてください。

Python クイックスタートと Node.js クイックスタートでは、リクエストの送信方法と結果の使用方法を説明しています。

タスクで利用できるプロファイルがありません。

API キーに紐づくワークスペースとタスクのホスト名を、設定済みのプロファイルと照合してください。

試してみましょう： タスクを作成するワークスペースに、対象のサイトプロファイルを追加してください。タスクの作成を繰り返しても、未登録のプロファイルは作成されません。

プロファイルがキュー待ち、キャプチャ中、検証中、またはレビュー中です。

「サイトプロファイル」で現在の状態を確認してください。

試してみましょう： プロファイルが有効になってから解決をリクエストしてください。これらの状態では、有効なプロファイルの代わりにはなりません。

キャプチャに失敗しました。

コンソールに表示された失敗理由を確認してください。

試してみましょう： その理由で示された問題を修正し、キャプチャを再試行してください。

プロファイルは有効ですが、対象のアクションに対応するプロファイルを特定できません。

ホスト名、キャプチャアクション、reCAPTCHA の種類を照合してください。実行アクションが異なる場合は、キャプチャ対象が一意に定まるか確認してください。

試してみましょう： 既存のプロファイルを選択するためだけにタスクを無関係なアクションへ変更するのではなく、対象のホスト名、アクション、種類に一致するプロファイルを設定してください。