Method: provideValidationFeedback
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
بازخورد در مورد نتیجه توالی تلاش‌های اعتبارسنجی. این باید آخرین تماسی باشد که پس از یک سری تماس های اعتبارسنجی برای همان آدرس انجام می شود و باید پس از پایان تراکنش فراخوانی شود. این فقط باید یک بار برای دنباله درخواست های v1.validateAddress که برای اعتبارسنجی کامل یک آدرس لازم است ارسال شود.
درخواست HTTP
POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| فیلدها |
|---|
conclusion | enum ( ValidationConclusion ) مورد نیاز. نتیجه توالی تلاش‌های اعتبارسنجی اگر این فیلد روی VALIDATION_CONCLUSION_UNSPECIFIED تنظیم شود، یک خطای INVALID_ARGUMENT برگردانده خواهد شد. |
responseId | string مورد نیاز. شناسه پاسخی که این بازخورد برای آن است. این باید [responseId][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] از اولین پاسخ در یک سری تلاش‌های اعتبارسنجی آدرس باشد. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ خالی است.
نتیجه گیری اعتبار سنجی
نتایج نهایی ممکن از توالی درخواست های اعتبارسنجی آدرس مورد نیاز برای اعتبارسنجی یک آدرس.
| Enums |
|---|
VALIDATION_CONCLUSION_UNSPECIFIED | این مقدار استفاده نشده است. اگر قسمت ProvideValidationFeedbackRequest.conclusion روی VALIDATION_CONCLUSION_UNSPECIFIED تنظیم شود، یک خطای INVALID_ARGUMENT برگردانده می شود. |
VALIDATED_VERSION_USED | نسخه آدرس برگشتی توسط Address Validation API برای تراکنش استفاده شد. |
USER_VERSION_USED | از نسخه آدرس ارائه شده توسط کاربر برای تراکنش استفاده شد |
UNVALIDATED_VERSION_USED | نسخه‌ای از آدرسی که پس از آخرین تلاش برای اعتبارسنجی وارد شده بود، اما دوباره تأیید نشد، برای تراکنش استفاده شد. |
UNUSED | معامله لغو شد و از آدرس استفاده نشد. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
