ในบางกรณี คุณอาจทำการเรียกไปยัง Address Validation API สำหรับที่อยู่เดียว ตัวอย่างเช่น ลูกค้าอาจ เปลี่ยนที่อยู่หลังจากเห็นผลลัพธ์ การตรวจสอบความถูกต้อง จากนั้นคุณดำเนินการตรวจสอบความถูกต้องครั้งที่สองกับที่อยู่ที่อัปเดตแล้ว
เอกสารฉบับนี้อธิบายการดำเนินการหลัก 2 อย่างที่คุณจะทำได้เมื่อเผยแพร่ชุดคู่มือ คำขอสำหรับที่อยู่เดียวกันไปยัง Address Validation API การดำเนินการเหล่านี้ ไม่ใช่ข้อกำหนดการใช้งานที่เข้มงวด แต่เป็นการดำเนินการที่จะเป็นประโยชน์ในส่วนของคุณ คุณภาพของข้อมูลและการตอบสนองของระบบโดยรวม
- ส่งคำขอไปยังปลายทาง
provideValidationFeedback
- ตั้งค่าช่อง
previousResponseID
ส่งคำขอเกี่ยวกับ provideValidationFeedback
ในตอนท้ายของการตรวจสอบความถูกต้อง Google ขอแนะนำให้โทรไปที่ ระบุ API ฟีดแบ็กสำหรับการตรวจสอบเพื่อระบุผลลัพธ์สุดท้ายของ การตรวจสอบความถูกต้องทั้งหมด คำขอจะกำหนดฟิลด์สองฟิลด์:
conclusion
— ระบุเวอร์ชันการตรวจสอบที่คุณใช้ในบริการ ว่าเป็นข้อความที่ผู้ใช้ระบุ หรือเป็นข้อความที่ส่งคืนจาก API การตรวจสอบที่อยู่responseId
— ระบุรหัสการตอบสนองของคำตอบแรกจาก API การตรวจสอบที่อยู่ โปรดดูหัวข้อตั้งค่าช่อง beforeResponseId ที่ด้านล่าง
ใช้ provideValidationFeedback method (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 APIUSER_VERSION_USED
: เวอร์ชันต้นฉบับที่ผู้ใช้ระบุUNVALIDATED_VERSION_USED
: เวอร์ชันที่เป็นผลมาจากข้อความแจ้งให้ ผู้ใช้ แต่ไม่ได้ตรวจสอบความถูกต้องอีกครั้งด้วย Address Validation APIUNUSED
: ยกเลิกธุรกรรม
โปรดดูสรุปการตรวจสอบในคู่มืออ้างอิง |
- ช่อง
responseId
จะระบุผลลัพธ์การตรวจสอบที่อยู่ที่คุณดำเนินการ ในการแสดงความคิดเห็น ค่านี้ต้องเหมือนกับresponseId
ค่าที่ส่งคืนจากการเรียกแรกไปยังฟังก์ชัน เมธอด validateAddress
โปรดดูเนื้อหาคำขอในคู่มืออ้างอิงความคิดเห็นเกี่ยวกับการตรวจสอบ |
ตั้งค่าช่อง previousResponseID
เมื่อส่งคำขอติดตามผล Address Validation API สำหรับที่อยู่ที่ระบุ ให้ตั้งค่า
ฟิลด์ previousResponseId
- สำหรับค่าของ
previousResponseId
ให้ใช้ค่าจากresponseId
API แสดงผลหลังจากคำขอตรวจสอบครั้งแรก - ใช้ค่าเดียวกันนี้สำหรับคำขอติดตามผลทั้งหมดจนถึงชุดข้อมูล เสร็จสมบูรณ์
แผนภาพลำดับนี้จะแสดงขั้นตอนที่ต้องการ