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

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

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

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

ส่งคำขอprovideValidationFeedback

ในตอนท้ายของชุดการตรวจสอบ Google ขอแนะนำให้เรียกใช้ 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 แสดงผลหลังจากคำขอตรวจสอบแรก
• ใช้ค่าเดียวกันนี้สำหรับคำขอติดตามผลทุกรายการจนกว่าชุดหนังสือจะอ่านจบ

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