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

במקרים מסוימים, יכול להיות שתבצעו כמה קריאות ל-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: נטש את העסקה.

• השדה responseId מציין את תוצאות אימות הכתובת שלגביה אתם שולחים משוב. הערך הזה חייב להיות זהה לערך responseId שהוחזר בקריאה הראשונה לשיטה validateAddress.

הגדרת השדה previousResponseID

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

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

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