בחלק מהמקרים אפשר לבצע מספר קריאות ל-Address Validation API עבור כתובת אחת. לדוגמה, יכול להיות שהלקוח יבצע שינויים בכתובת אחרי שראה את התוצאות של האימות הראשון. לאחר מכן מבצעים אימות נוסף של הכתובת המעודכנת.
במסמך הזה מתוארות שתי פעולות עיקריות שאפשר לבצע כששולחים סדרה של בקשות לאותה כתובת ל-API לאימות כתובת. הפעולות האלה הן לא דרישת שימוש מחמירה, אבל הן עוזרות לכם לשפר את איכות הנתונים הכוללת ואת תגובת המערכת.
- שליחת בקשה לנקודת הקצה (endpoint)
provideValidationFeedback
- הגדרת השדה
previousResponseID
שליחה של בקשה ל-provideValidationFeedback
בסיום סדרת אימותים, Google ממליצה לבצע קריאה ל-Provide Validation Feedback API כדי לציין את התוצאה הסופית של כל האימותים. הבקשה מגדירה שני שדות:
conclusion
– גרסת האימות שבה השתמשתם בשירות – זו שהתקבלה על ידי המשתמש או זו שהוחזרה מה-API לאימות כתובת.responseId
– מציין את מזהה התגובה של התשובה הראשונה מה-API לאימות כתובת. ראו הגדרת השדה הקודםResponseId שבהמשך.
אפשר להשתמש ב-method provideValidationFeedback (REST) או ב-method 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
: הגרסה המאומתת של הכתובת מה-API לאימות כתובת.USER_VERSION_USED
: הגרסה המקורית שסופקה על ידי המשתמש.UNVALIDATED_VERSION_USED
: גרסה שהתקבלה בעקבות בקשה למשתמש, אבל לא אימתה אותה מחדש באמצעות ה-API לאימות כתובת.UNUSED
: העסקה לא בוצעה.
פרטים נוספים זמינים בקטע סיכום האימות במדריך העזר. |
- השדה
responseId
מציין על אילו תוצאות אימות כתובת אתם שולחים משוב. הערך הזה צריך להיות זהה לערךresponseId
שמוחזר על ידי הקריאה הראשונה ל-method validateAddress.
פרטים נוספים מופיעים בקטע גוף הבקשה במדריך העזרה למשוב על אימות. |
הגדרת השדה previousResponseID
כששולחים בקשת מעקב, Address Validation API לכתובת נתונה, מגדירים את השדה previousResponseId
.
- בערך של
previousResponseId
, משתמשים בערך מה-responseId
שהוחזר על ידי ה-API אחרי בקשת האימות הראשונה. - משתמשים בערך הזה לכל בקשות המעקב עד להשלמת הסדרה.
תרשים הרצף הזה מציג את התהליך המועדף: