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