Menangani alamat yang diperbarui

Dalam beberapa kasus, Anda dapat melakukan beberapa panggilan ke Address Validation API untuk satu alamat. Misalnya, pelanggan mungkin membuat perubahan pada alamatnya setelah melihat hasil validasi pertama. Anda kemudian melakukan validasi kedua pada alamat yang diperbarui.

Dokumen ini menjelaskan dua tindakan utama yang dapat Anda lakukan saat mengeluarkan serangkaian permintaan untuk alamat yang sama ke Address Validation API. Tindakan ini bukan persyaratan penggunaan yang ketat, tetapi tindakan yang bermanfaat dari Anda untuk meningkatkan kualitas data dan respons sistem secara keseluruhan.

  • Mengirim permintaan ke endpoint provideValidationFeedback
  • Menetapkan kolom previousResponseID

Kirim permintaan provideValidationFeedback

Di akhir serangkaian validasi, Google merekomendasikan untuk melakukan panggilan ke Provide Validation Feedback API untuk menunjukkan hasil akhir semua validasi. Permintaan menetapkan dua kolom:

  • conclusion — Menunjukkan versi validasi yang Anda gunakan di layanan, baik yang disediakan oleh pengguna, maupun yang ditampilkan dari Address Validation API.
  • responseId — Menunjukkan ID respons respons pertama dari Address Validation API. Lihat Menetapkan kolom previousResponseId di bawah.

Gunakan metode provideValidationFeedback (REST) atau ProvideValidationFeedback (gRPC).

Contoh berikut meneruskan isi JSON ke permintaan yang menentukan kesimpulan:

curl -X POST -d '{
  "conclusion": "VALIDATED_VERSION_USED",
  "responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=API_KEY"
  • Kolom conclusion mengidentifikasi salah satu tindakan berikut dari sisi Anda:
    • VALIDATED_VERSION_USED: versi alamat yang divalidasi dari Address Validation API.
    • USER_VERSION_USED: versi asli yang diberikan oleh pengguna.
    • UNVALIDATED_VERSION_USED: versi yang merupakan hasil dari perintah kepada pengguna, tetapi tidak memvalidasinya kembali dengan Address Validation API.
    • UNUSED: membatalkan transaksi.
Lihat Kesimpulan Validasi dalam panduan referensi.
  • Kolom responseId menentukan hasil validasi alamat yang Anda berikan masukannya. Nilai ini harus sama dengan nilai responseId yang ditampilkan oleh panggilan pertama ke metode validateAddress.
Lihat Isi Permintaan di panduan referensi masukan validasi.

Menetapkan kolom previousResponseID

Saat mengeluarkan permintaan lanjutan Address Validation API untuk alamat tertentu, tetapkan kolom previousResponseId.

  • Untuk nilai previousResponseId, gunakan nilai dari responseId yang ditampilkan oleh API setelah permintaan validasi pertama.
  • Gunakan nilai yang sama ini untuk semua permintaan tindak lanjut hingga rangkaian selesai.

Diagram urutan ini menunjukkan alur yang diinginkan:

Gunakan ID respons untuk memvalidasi alamat.