Bermigrasi ke API v1

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:

  1. Ganti panggilan untuk membuat penilaian.

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

  2. Pahami perubahan dalam respons JSON penilaian:

    Saat Anda menggunakan v1, kolom reasons dan score dienkapsulasi dalam riskAnalysis dalam respons, dan saat Anda menggunakan v1beta1, kolom reasons dan score 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)
    }
    }

  3. Perbarui lingkungan Anda agar dapat menggunakan kolom reasons dan score dari respons JSON untuk v1.

    Kode contoh berikut menunjukkan kolom yang digunakan dari respons v1 dan 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. Ganti panggilan untuk membuat anotasi penilaian.

    Mengganti https://recaptchaenterprise.googleapis.com/v1beta1/projects/PROJECT_ID/assessments}:annotate dengan https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments}:annotate

  5. Jika saat ini Anda mencatat panggilan API create dan annotate ke dalam log menggunakan logging audit, sebaiknya gunakan logging platform (hanya tersedia untuk v1).

Langkah selanjutnya