טיפול בכתובות שעודכנו

בחלק מהמקרים אפשר לבצע מספר קריאות ל-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 אחרי בקשת האימות הראשונה.
• משתמשים בערך הזה לכל בקשות המעקב עד להשלמת הסדרה.

תרשים הרצף הזה מציג את התהליך המועדף: