Dokumen ini menunjukkan cara melakukan migrasi dari versi v1beta1
ke reCAPTCHA Enterprise API versi v1
.
Jika Anda menggunakan v1beta1
untuk membuat dan menganotasi penilaian, sebaiknya gunakan v1
karena fitur baru, seperti pelindung akun reCAPTCHA Enterprise, hanya tersedia di v1
. v1
mendukung autentikasi kunci API dan
akun layanan.
Untuk memigrasikan panggilan penilaian dari v1beta1
ke v1
, lakukan tindakan berikut:
Ganti panggilan untuk membuat penilaian.
Mengganti
https://recaptchaenterprise.googleapis.com/v1beta1/projects/PROJECT_ID/assessments?key=API_KEY
denganhttps://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments?key=API_KEY
Pahami perubahan dalam respons JSON penilaian:
Saat Anda menggunakan
v1
, kolomreasons
danscore
dienkapsulasi dalamriskAnalysis
dalam respons, dan saat Anda menggunakanv1beta1
, kolomreasons
danscore
tidak dienkapsulasi dalam respons.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) } }
Perbarui lingkungan Anda agar dapat menggunakan kolom
reasons
danscore
dari respons JSON untukv1
.Kode contoh berikut menunjukkan kolom yang digunakan dari respons
v1
danv1beta1
: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) ) .... ....
Ganti panggilan untuk membuat anotasi penilaian.
Mengganti
https://recaptchaenterprise.googleapis.com/v1beta1/projects/PROJECT_ID/assessments}:annotate
denganhttps://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments}:annotate
Jika saat ini Anda mencatat panggilan API
create
danannotate
ke dalam log menggunakan logging audit, sebaiknya gunakan logging platform (hanya tersedia untukv1
).