Dalam beberapa kasus, Anda dapat melakukan beberapa panggilan ke Address Validation API untuk satu alamat. Misalnya, pelanggan mungkin mengubah alamat mereka 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 mengajukan serangkaian permintaan untuk alamat yang sama ke Address Validation API. Tindakan ini 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 melakukan panggilan ke Provide Validation Feedback API guna menunjukkan hasil akhir dari semua validasi. Permintaan ini menetapkan dua kolom:
conclusion
— Menunjukkan versi validasi yang Anda gunakan dalam layanan, baik yang disediakan oleh pengguna, atau yang ditampilkan dari Address Validation API.responseId
— Menunjukkan ID respons respons pertama dari Address Validation API. Lihat bagian Menetapkan kolom previousResponseId di bawah.
Gunakan metode provideValidationFeedback (REST) atau metode 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 disediakan oleh pengguna.UNVALIDATED_VERSION_USED
: versi yang merupakan hasil dari perintah kepada pengguna, tetapi tidak memvalidasi ulang dengan Address Validation API.UNUSED
: mengabaikan transaksi.
Lihat Kesimpulan Validasi di panduan referensi. |
- Kolom
responseId
menentukan hasil validasi alamat yang masukannya Anda berikan. Nilai ini harus sama dengan nilairesponseId
yang ditampilkan oleh panggilan pertama ke metode validateAddress.
Lihat Isi Permintaan di panduan referensi masukan validasi. |
Tetapkan kolom previousResponseID
Saat mengajukan permintaan tindak lanjut, Address Validation API untuk alamat tertentu, tetapkan
kolom previousResponseId
.
- Untuk nilai
previousResponseId
, gunakan nilai dariresponseId
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: