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

ในบางกรณี คุณอาจเรียกใช้ 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 ค่าที่ส่งคืนโดยการเรียก first ไปยังเมธอด validateAddress

ตั้งค่าฟิลด์ previousResponseID

เมื่อส่งคำขอติดตามผลไปยัง Address Validation API สำหรับที่อยู่ที่ระบุ ให้ตั้งค่าฟิลด์ previousResponseId

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

แผนภาพลำดับนี้แสดงโฟลว์ที่ต้องการ