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.addresssingleation.v1.VerifyAddressRequest.response_id] الوارد على الردّ الأول في سلسلة من محاولات التحقّق من العنوان.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
ValidationConclusion
يشير ذلك المصطلح إلى النتائج النهائية المحتمَلة لتسلسل طلبات التحقّق من العنوان اللازمة للتحقّق من صحة العنوان.
| عمليات التعداد |
VALIDATION_CONCLUSION_UNSPECIFIED |
هذه القيمة غير مستخدمة. وفي حال ضبط الحقل ProvideValidationFeedbackRequest.conclusion على VALIDATION_CONCLUSION_UNSPECIFIED، سيظهر خطأ INVALID_ARGUMENT. |
VALIDATED_VERSION_USED |
تم استخدام نسخة العنوان التي تعرضها واجهة برمجة تطبيقات التحقق من صحة العنوان في المعاملة. |
USER_VERSION_USED |
إنّ نسخة العنوان التي قدّمها المستخدم استُخدمت لإجراء المعاملة. |
UNVALIDATED_VERSION_USED |
تم استخدام نسخة من العنوان في المعاملة تم إدخالها بعد آخر محاولة تحقّق ولكن لم تتم إعادة التحقّق من صحتها. |
UNUSED |
تم إلغاء المعاملة ولم يتم استخدام العنوان. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
