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

במקרים מסוימים, יכול להיות שתבצעו כמה קריאות ל-Address Validation API עבור כתובת אחת. לדוגמה, יכול להיות שהלקוח ישנה את הכתובת שלו אחרי שיראה את תוצאות האימות הראשון. לאחר מכן מבצעים אימות שני של הכתובת המעודכנת.

במסמך הזה מתוארות שתי פעולות מפתח שאפשר לבצע כששולחים סדרה של בקשות לאותה כתובת ל-Address Validation API. הפעולות האלה הן לא דרישות שימוש מחמירות, אלא פעולות מועילות שתוכלו לבצע כדי לשפר את איכות הנתונים הכוללת ואת תגובת המערכת.

  • שליחת בקשה לנקודת הקצה provideValidationFeedback
  • הגדרת השדה previousResponseID

שליחת בקשה ל-provideValidationFeedback

בסוף סדרה של אימותים, Google ממליצה לבצע קריאה ל-Provide Validation Feedback API כדי לציין את התוצאה הסופית של כל האימותים. הבקשה מגדירה שני שדות:

  • conclusion – מציין את גרסת האימות שבה השתמשתם בשירות, בין אם זו הגרסה שסיפק המשתמש ובין אם זו הגרסה שהוחזרה מ-Address Validation API.
  • responseId – מזהה התגובה של התשובה הראשונה מ-Address Validation API. מידע נוסף זמין בקטע הגדרת השדה previousResponseId בהמשך.

משתמשים ב-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: הגרסה המאומתת של הכתובת מ-Address Validation API.
    • USER_VERSION_USED: הגרסה המקורית שסופקה על ידי המשתמש.
    • UNVALIDATED_VERSION_USED: גרסה שהתקבלה כתוצאה מהודעה למשתמשים, אבל לא בוצע אימות חוזר שלה באמצעות Address Validation API.
    • UNUSED: נטש את העסקה.
אפשר לעיין בקטע Validation Conclusion במדריך העזרה.
  • השדה responseId מציין את תוצאות אימות הכתובת שלגביה אתם שולחים משוב. הערך הזה חייב להיות זהה לערך של responseId שמוחזר בקריאה הראשונה לשיטה validateAddress.
מידע נוסף זמין בקטע גוף הבקשה במדריך העזר בנושא משוב על אימות.

הגדרת השדה previousResponseID

כששולחים בקשת מעקב ל-Address Validation API לגבי כתובת מסוימת, צריך להגדיר את השדה previousResponseId.

  • בערך של previousResponseId, משתמשים בערך של responseId שהוחזר על ידי ה-API אחרי בקשת האימות הראשונה.
  • צריך להשתמש באותו ערך בכל הבקשות הבאות עד לסיום הסדרה.

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

שימוש במזהה התגובה לאימות כתובת.