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

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

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

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

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

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

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

אפשר להשתמש באחד משני הסוגים provideValidationFeedback method (REST) או ProvideValidationFeedback method (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

בעת שליחה של בקשת מעקב, את ה-API לאימות כתובת עבור כתובת נתונה, מגדירים השדה previousResponseId.

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

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