Migrer vers API v1

Ce document explique comment migrer de la version v1beta1 vers la v1 version de l'API reCAPTCHA Enterprise.

Pour migrer vos appels d'évaluation de v1beta1 vers v1, procédez comme suit :

  1. Remplacez les appels pour créer des évaluations.

    Remplacez https://recaptchaenterprise.googleapis.com/v1beta1/projects/PROJECT_ID/assessments?key=API_KEY par https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments?key=API_KEY.

  2. Comprenez les modifications apportées à la réponse JSON de l'évaluation :

    Lorsque vous utilisez v1, les champs reasons et score sont encapsulés dans riskAnalysis dans la réponse. Lorsque vous utilisez v1beta1, les champsreasons et score ne sont pas encapsulés dans la réponse.

    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. Mettez à jour votre environnement pour utiliser les champs reasons et score de la réponse JSON pour v1.

    L'exemple de code suivant montre les champs utilisés à partir de la réponse de v1 et v1beta1 :

    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. Remplacez les appels pour annoter les évaluations.

    Remplacez https://recaptchaenterprise.googleapis.com/v1beta1/projects/PROJECT_ID/assessments}:annotate par https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments}:annotate.

  5. Si vous enregistrez actuellement vos appels d'API create et annotate à l'aide de la journalisation d'audit, nous vous recommandons d'utiliser la journalisation de la plate-forme (disponible uniquement pour v1).

Étape suivante