In diesem Dokument erfahren Sie, wie Sie von der v1beta1
-Version zur v1
-Version der reCAPTCHA Enterprise API migrieren.
Wenn Sie v1beta1
zum Erstellen und Annotieren von Bewertungen verwenden, empfehlen wir die Verwendung von v1
, da die neuen Features wie reCAPTCHA Enterprise Account Defender nur für v1
verfügbar sind. v1
unterstützt sowohl die Authentifizierung eines API-Schlüssels als auch eines Dienstkontos.
So migrieren Sie Ihre Bewertungsaufrufe von v1beta1
zu v1
:
Ersetzen Sie Aufrufe, um Bewertungen zu erstellen.
Ersetzen Sie
https://recaptchaenterprise.googleapis.com/v1beta1/projects/PROJECT_ID/assessments?key=API_KEY
durchhttps://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments?key=API_KEY
.Machen Sie sich mit den Änderungen in der JSON-Antwort der Bewertung vertraut:
Wenn Sie
v1
verwenden, werden die Felderreasons
undscore
in der Antwort inriskAnalysis
gekapselt. Wenn Siev1beta1
verwenden, werden die Felderreasons
undscore
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) } }
Aktualisieren Sie Ihre Umgebung so, dass die Felder
reasons
undscore
aus der JSON-Antwort fürv1
verwendet werden.Der folgende Beispielcode zeigt die Felder, die aus der Antwort von
v1
undv1beta1
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) ) .... ....
Ersetzen Sie Aufrufe, um Bewertungen zu annotieren.
Ersetzen Sie
https://recaptchaenterprise.googleapis.com/v1beta1/projects/PROJECT_ID/assessments}:annotate
durchhttps://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments}:annotate
.Wenn Sie die API-Aufrufe
create
undannotate
derzeit mit Audit-Logging protokollieren, empfehlen wir die Verwendung von Plattform-Logging (nur fürv1
verfügbar).