Method: provideValidationFeedback

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

בקשת HTTP

POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "conclusion": enum (ValidationConclusion),
  "responseId": string
}
שדות
conclusion

enum (ValidationConclusion)

חובה. התוצאה של רצף ניסיונות האימות.

אם קובעים בשדה הזה את הערך VALIDATION_CONCLUSION_UNSPECIFIED, תוחזר שגיאת INVALID_ARGUMENT.

responseId

string

חובה. מזהה התשובה של המשוב הזה. הכתובת הזו צריכה להיות [responseId][google.maps.addressvalidation.v1.VerifyAddressRequest.response_id] מהתגובה הראשונה בסדרת ניסיונות לאימות כתובת.

גוף התגובה

אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.

ValidationConclusion

התוצאות הסופיות האפשריות של רצף הבקשות לאימות כתובת, הנדרשות לאימות כתובת.

טיפוסים בני מנייה (enums)
VALIDATION_CONCLUSION_UNSPECIFIED הערך הזה לא בשימוש. אם השדה ProvideValidationFeedbackRequest.conclusion מוגדר לערך VALIDATION_CONCLUSION_UNSPECIFIED, תוחזר השגיאה INVALID_ARGUMENT.
VALIDATED_VERSION_USED גרסת הכתובת שהוחזרה על ידי ממשק ה-API לאימות כתובות שימשה לעסקה.
USER_VERSION_USED גרסת הכתובת שסופקה על ידי המשתמש שימשה לעסקה
UNVALIDATED_VERSION_USED גרסה של הכתובת שהוזנה אחרי ניסיון האימות האחרון אך לא אומתה מחדש, שימשה לביצוע העסקה.
UNUSED העסקה ננטשה ולא נעשה שימוש בכתובת.