Bewertung erstellen

Auf dieser Seite erfahren Sie, wie Sie das reCAPTCHA-Antworttoken eines Nutzers im Back-End Ihrer Anwendung bewerten.

Für Webnutzer können Sie das Antworttoken des Nutzers auf eine der folgenden Arten abrufen:

  • Der aufgelöste Wert, der durch den Aufruf von grecaptcha.enterprise.execute zurückgegeben wird
  • g-recaptcha-response POST Parameter, wenn der Benutzer das Formular auf Ihrer Website sendet
  • Als Stringargument für Ihre Callback-Funktion, wenn data-callback entweder im g-recaptcha-Tagattribut oder im Callback-Parameter in der Methode grecaptcha.enterprise.render angegeben ist

Jedes reCAPTCHA-Antworttoken eines Nutzers von kann nur einmal bewertet werden. Wenn Sie eine nachfolgende Aktion bewerten müssen, die der Nutzer auf Ihrer Website ausführt, oder wenn ein Token abläuft, bevor eine Bewertung erstellt werden kann, müssen Sie grecaptcha.enterprise.execute() noch einmal aufrufen, um ein neues Token zu generieren.

API-Anfrage

Erstellen Sie eine Bewertung mit der Methode projects.assessments.create.

Ersetzen Sie diese Werte in den folgenden Anweisungen:

  • project-id: ID Ihres GCP-Projekts
  • token: vom Aufruf grecaptcha.enterprise.execute() zurückgegebenes Token
  • keykey: reCAPTCHA Schlüssel, der der Website/App zugeordnet ist

HTTP-Methode und URL:

POST https://recaptchaenterprise.googleapis.com/v1/projects/project-id/assessments

JSON-Text der Anfrage:

{
  "event": {
    "token": "token",
    "siteKey": "key"
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://recaptchaenterprise.googleapis.com/v1/projects/project-id/assessments

PowerShell

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/project-id/assessments" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "tokenProperties": {
    "valid": true,
    "hostname": "www.google.com",
    "action": "homepage",
    "createTime": "2019-03-28T12:24:17.894Z"
   },
  "riskAnalysis": {
    "score": 0.1,
    "reasons": ["AUTOMATION"]
  },
  "event": {
    "token": "token",
    "siteKey": "key"
   },
  "name": "projects/project-id/assessments/b6ac310000000000"
}

Nächste Schritte