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

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

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

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

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

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

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

אפשר להשתמש באחד משני הסוגים 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: הגרסה המאומתת של הכתובת ממשק ה-API לאימות כתובת.
  • USER_VERSION_USED: הגרסה המקורית שסופקה על ידי המשתמש.
  • UNVALIDATED_VERSION_USED: גרסה שהיא תוצאה של הנחיה המשתמש, אבל לא אימתו אותו מחדש באמצעות ה-API לאימות כתובת.
  • UNUSED: העסקה לא בוצעה.

פרטים נוספים זמינים בקטע סיכום האימות במדריך העזר.

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

פרטים נוספים מופיעים בקטע גוף הבקשה במדריך העזרה למשוב על אימות.

הגדרת השדה previousResponseID

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

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

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