Menangani alamat yang diperbarui

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

Dokumen ini menjelaskan dua tindakan utama yang dapat Anda ambil saat menerbitkan serangkaian untuk alamat yang sama ke Address Validation API. Tindakan ini adalah bukan persyaratan penggunaan yang ketat, tetapi tindakan yang berguna di pihak Anda untuk meningkatkan kualitas data dan respons sistem secara keseluruhan.

  • Mengirim permintaan ke endpoint provideValidationFeedback
  • Tetapkan kolom previousResponseID

Kirim permintaan provideValidationFeedback

Di akhir serangkaian validasi, Google merekomendasikan untuk menghubungi Memberikan Validation Feedback API untuk menunjukkan hasil akhir dari semua validasi. Permintaan ini menetapkan dua kolom:

  • conclusion — Menunjukkan versi validasi yang digunakan di layanan, apakah itu yang disediakan oleh pengguna, atau yang ditampilkan dari Address Validation API.
  • responseId — Menunjukkan ID respons respons pertama dari Address Validation API. Lihat Menetapkan kolom previousResponseId di bawah ini.

Gunakan 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:
    • VALIDATED_VERSION_USED: versi alamat yang divalidasi dari Address Validation API.
    • USER_VERSION_USED: versi asli yang disediakan oleh pengguna.
    • UNVALIDATED_VERSION_USED: versi yang merupakan hasil dari prompt untuk pengguna, tetapi tidak memvalidasi ulang dengan Address Validation API.
    • UNUSED: mengabaikan transaksi.
Lihat Kesimpulan Validasi di panduan referensi.
  • Kolom responseId menentukan hasil validasi alamat tempat Anda berikan masukan. Nilai ini harus sama dengan responseId nilai yang ditampilkan oleh panggilan pertama ke metode metode validateAddress.
Lihat Isi Permintaan di panduan referensi masukan validasi.

Tetapkan kolom previousResponseID

Saat mengajukan permintaan tindak lanjut, Address Validation API untuk alamat yang diberikan, tetapkan kolom previousResponseId.

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

Diagram urutan ini menunjukkan alur yang disukai:

Gunakan ID respons untuk memvalidasi alamat.