Zur v1 API migrieren

In diesem Dokument erfahren Sie, wie Sie von der Version v1beta1 zur Version v1 der reCAPTCHA Enterprise API migrieren.

So migrieren Sie Ihre Bewertungsanfragen von v1beta1 zu v1:

  1. Ersetzen Sie Aufrufe, um Bewertungen zu erstellen.

    Ersetzen Sie https://recaptchaenterprise.googleapis.com/v1beta1/projects/PROJECT_ID/assessments?key=API_KEY durch https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments?key=API_KEY.

  2. Änderungen in der JSON-Antwort der Bewertung:

    Wenn Sie v1 verwenden, werden die Felder reasons und score in der Antwort in riskAnalysis gekapselt. Wenn Sie v1beta1 verwenden, werden die Felder reasons und score nicht in der Antwort gekapselt.

    v1

    {
"event":{
  "expectedAction":"EXPECTED_ACTION",
  "hashedAccountId":"ACCOUNT_ID",
  "siteKey":"KEY_ID",
  "token":"TOKEN",
  "userAgent":"(USER-PROVIDED STRING)",
  "userIpAddress":"USER_PROVIDED_IP_ADDRESS"
},
"name":"ASSESSMENT_ID",
 "riskAnalysis":{
  "reasons":[],
  "score":"SCORE
},
"tokenProperties":{
  "action":"USER_INTERACTION",
  "createTime":"TIMESTAMP",
  "hostname":"HOSTNAME",
  "invalidReason":"(ENUM)",
  "valid":(BOOLEAN)
}
}

    v1beta1

    {
"event":{
  "expectedAction":"EXPECTED_ACTION",
  "hashedAccountId":"ACCOUNT_ID",
  "siteKey":"KEY_ID",
  "token":"TOKEN",
  "userAgent":"(USER-PROVIDED STRING)",
  "userIpAddress":"USER_PROVIDED_IP_ADDRESS"
},
"name":"ASSESSMENT_ID",
"reasons":[],
"score":"SCORE",

"tokenProperties":{
  "action":"USER_INTERACTION",
  "createTime":"TIMESTAMP",
  "hostname":"HOSTNAME",
  "invalidReason":"(ENUM)",
  "valid":(BOOLEAN)
}
}

  3. Aktualisieren Sie Ihre Umgebung, damit die Felder reasons und score aus der JSON-Antwort für v1 verwendet werden.

    Im folgenden Beispielcode sind die Felder zu sehen, die aus der Antwort von v1 und v1beta1 verwendet werden:

    v1

    .....
.....
# Get the risk score and the reason(s)
for reason in response.risk_analysis.reasons:
    print(reason)
print(
    "The reCAPTCHA score for this token is: "
    + str(response.risk_analysis.score)
)
....
....

    v1beta1

    .....
.....
# Get the risk score and the reason(s)
for reason in response.reasons:
    print(reason)
print(
    "The reCAPTCHA score for this token is: "
    + str(response.score)
)
....
....

  4. Ersetzen Sie Aufrufe, um Bewertungen zu kommentieren.

    Ersetzen Sie https://recaptchaenterprise.googleapis.com/v1beta1/projects/PROJECT_ID/assessments}:annotate durch https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments}:annotate.

  5. Wenn Sie Ihre create- und annotate-API-Aufrufe derzeit mithilfe von Audit-Logs erfassen, sollten Sie stattdessen Plattform-Logs verwenden (nur für v1 verfügbar).

Nächste Schritte