จัดการที่อยู่ที่อัปเดต

ในบางกรณี คุณอาจเรียกใช้ Address Validation API หลายครั้งสําหรับที่อยู่เดียว เช่น ลูกค้าอาจเปลี่ยนแปลงที่อยู่หลังจากเห็นผลลัพธ์ของการตรวจสอบครั้งแรก จากนั้นให้ทำการตรวจสอบครั้งที่ 2 ในที่อยู่ที่คุณอัปเดต

เอกสารนี้จะอธิบายการดำเนินการสำคัญ 2 อย่างที่คุณทำได้เมื่อส่งคำขอที่อยู่เดียวกันไปยัง Address Validation API การดำเนินการเหล่านี้ไม่ใช่ข้อกำหนดการใช้งานที่เข้มงวด แต่เป็นสิ่งที่คุณควรทำเพื่อปรับปรุงคุณภาพของข้อมูลโดยรวมและการตอบสนองของระบบ

• ส่งคำขอไปยังปลายทาง provideValidationFeedback
• ตั้งค่าช่อง previousResponseID

ส่งคำขอ provideValidationFeedback

เมื่อการยืนยันชุดหนึ่งๆ เสร็จสิ้น Google ขอแนะนำให้เรียกใช้ Provide Validation Feedback API เพื่อระบุผลลัพธ์สุดท้ายของการตรวจสอบทั้งหมด คำขอจะตั้งค่า 2 ช่อง ได้แก่

• conclusion — ระบุเวอร์ชันการตรวจสอบที่คุณใช้ในบริการ ไม่ว่าจะเป็นเวอร์ชันที่ผู้ใช้ระบุหรือเวอร์ชันที่แสดงผลจาก Address Validation API
• responseId — ระบุรหัสคำตอบของคำตอบแรกจาก Address Validation API ดูตั้งค่าช่อง previousResponseId ด้านล่าง

ใช้เมธอด provideValidationFeedback (REST) หรือ ProvideValidationFeedback (gRPC)

ตัวอย่างต่อไปนี้ส่งเนื้อหา JSON ไปยังคําขอที่กําหนดสรุป

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"

• ช่อง conclusion จะระบุการดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้จากฝั่งคุณ
  • VALIDATED_VERSION_USED: ที่อยู่เวอร์ชันที่ตรวจสอบแล้วจาก Address Validation API
  • USER_VERSION_USED: เวอร์ชันต้นฉบับที่ผู้ใช้ระบุ
  • UNVALIDATED_VERSION_USED: เวอร์ชันที่เกิดจากการแจ้งให้ผู้ใช้ทราบ แต่ไม่ได้ตรวจสอบกับ Address Validation API อีกครั้ง
  • UNUSED: ยกเลิกธุรกรรม

โปรดดูสรุปการตรวจสอบในคู่มืออ้างอิง

• ช่อง responseId จะระบุผลการยืนยันที่อยู่ที่คุณส่งความคิดเห็น ค่านี้ต้องเหมือนกับresponseIdค่าที่แสดงผลจากการเรียกครั้งแรกไปยังเมธอด validateAddress

โปรดดูเนื้อหาคำขอในคู่มืออ้างอิงสำหรับความคิดเห็นเกี่ยวกับการให้สิทธิ์

ตั้งค่าช่อง previousResponseID

เมื่อส่งคําขอติดตามผล Address Validation API สําหรับที่อยู่หนึ่งๆ ให้ตั้งค่าช่อง previousResponseId

• สำหรับค่าของ previousResponseId ให้ใช้ค่าจาก responseId ที่ API แสดงผลหลังจากคําขอตรวจสอบครั้งแรก
• ใช้ค่าเดียวกันนี้กับคำขอติดตามผลทั้งหมดจนกว่าชุดคำขอจะเสร็จสมบูรณ์

แผนภาพลำดับนี้แสดงขั้นตอนที่แนะนำ