Method: provideValidationFeedback
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משוב על התוצאה של רצף הניסיונות לאימות. זו צריכה להיות הקריאה האחרונה שהתבצעה לאחר רצף של קריאות אימות לאותה כתובת, וצריך להתקשר אליה לאחר השלמת העסקה. צריך לשלוח את הכתובת רק פעם אחת ברצף של v1.validateAddress הבקשות לאימות מלא של כתובת.
בקשת HTTP
POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| שדות |
conclusion |
enum (ValidationConclusion)
חובה. התוצאה של רצף ניסיונות האימות. אם קובעים בשדה הזה את הערך VALIDATION_CONCLUSION_UNSPECIFIED, תוחזר השגיאה INVALID_ARGUMENT.
|
responseId |
string
חובה. המזהה של התשובה שהמשוב הזה מיועד לה. הוא אמור להיות [responseId][google.maps.address Validation.v1.VerifyAddressRequest.response_id] מהתגובה הראשונה בסדרה של ניסיונות לאימות כתובת.
|
גוף התשובה
אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.
ValidationConclusion
התוצאות הסופיות האפשריות של רצף הבקשות לאימות כתובת שנדרשות לאימות כתובת.
| טיפוסים בני מנייה (enum) |
VALIDATION_CONCLUSION_UNSPECIFIED |
הערך הזה לא בשימוש. אם קובעים בשדה ProvideValidationFeedbackRequest.conclusion את הערך VALIDATION_CONCLUSION_UNSPECIFIED, תוחזר השגיאה INVALID_ARGUMENT. |
VALIDATED_VERSION_USED |
גרסת הכתובת שהוחזרה על ידי ה-API לאימות כתובת שימשה לעסקה. |
USER_VERSION_USED |
גרסת הכתובת שסופקה על ידי המשתמש שימשה לעסקה |
UNVALIDATED_VERSION_USED |
נעשה שימוש בגרסה של הכתובת שהוזנה אחרי ניסיון האימות האחרון, אבל לא אומתה מחדש, עבור העסקה. |
UNUSED |
העסקה ננטשה ולא נעשה שימוש בכתובת. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\u003cp\u003eProvide feedback on the outcome of address validation attempts using the \u003ccode\u003eProvideValidationFeedback\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe feedback request body includes the validation conclusion and the initial response ID.\u003c/p\u003e\n"],["\u003cp\u003ePossible validation conclusions include using the validated, user-provided, or an unvalidated address version, or abandoning the transaction.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eProvideValidationFeedback\u003c/code\u003e request should be sent only once after the transaction is concluded.\u003c/p\u003e\n"],["\u003cp\u003eA successful feedback submission results in an empty response body.\u003c/p\u003e\n"]]],[],null,["# Method: provideValidationFeedback\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [ValidationConclusion](#ValidationConclusion)\n\nFeedback about the outcome of the sequence of validation attempts. This should be the last call made after a sequence of validation calls for the same address, and should be called once the transaction is concluded. This should only be sent once for the sequence of `v1.validateAddress` requests needed to validate an address fully.\n\n### HTTP request\n\n`POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"conclusion\": enum (/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback#ValidationConclusion), \"responseId\": string } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `conclusion` | `enum (`[ValidationConclusion](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback#ValidationConclusion)`)` Required. The outcome of the sequence of validation attempts. If this field is set to `VALIDATION_CONCLUSION_UNSPECIFIED`, an `INVALID_ARGUMENT` error will be returned. |\n| `responseId` | `string` Required. The ID of the response that this feedback is for. This should be the \\[responseId\\]\\[google.maps.addressvalidation.v1.ValidateAddressRequest.response_id\\] from the first response in a series of address validation attempts. |\n\n### Response body\n\nIf successful, the response body is empty.\n\nValidationConclusion\n--------------------\n\nThe possible final outcomes of the sequence of address validation requests needed to validate an address.\n\n| Enums ||\n|-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `VALIDATION_CONCLUSION_UNSPECIFIED` | This value is unused. If the `ProvideValidationFeedbackRequest.conclusion` field is set to `VALIDATION_CONCLUSION_UNSPECIFIED`, an `INVALID_ARGUMENT` error will be returned. |\n| `VALIDATED_VERSION_USED` | The version of the address returned by the Address Validation API was used for the transaction. |\n| `USER_VERSION_USED` | The version of the address provided by the user was used for the transaction |\n| `UNVALIDATED_VERSION_USED` | A version of the address that was entered after the last validation attempt but that was not re-validated was used for the transaction. |\n| `UNUSED` | The transaction was abandoned and the address was not used. |"]]
