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.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 تم إلغاء المعاملة ولم يتم استخدام العنوان.