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.validAddressRequest.response_id] من أول إجابة في سلسلة من محاولات التحقق من صحة العنوان.

نص الاستجابة

في حال نجاح هذا الإجراء، يكون نص الاستجابة فارغًا.

ValidationConclusion

النتائج النهائية المحتملة لتسلسل طلبات التحقق من العنوان اللازمة للتحقق من صحة العنوان.

عمليات التعداد
VALIDATION_CONCLUSION_UNSPECIFIED هذه القيمة غير مستخدَمة. إذا تم ضبط الحقل ProvideValidationFeedbackRequest.conclusion على VALIDATION_CONCLUSION_UNSPECIFIED، سيتم عرض خطأ INVALID_ARGUMENT.
VALIDATED_VERSION_USED تم استخدام نسخة العنوان التي تعرضها واجهة برمجة التطبيقات لضمان صحة العنوان في المعاملة.
USER_VERSION_USED تم استخدام نسخة العنوان التي قدّمها المستخدم في المعاملة
UNVALIDATED_VERSION_USED تم استخدام نسخة من العنوان التي تم إدخالها بعد آخر محاولة تحقق ولكن لم تتم إعادة التحقق منها في المعاملة.
UNUSED تم إلغاء المعاملة ولم يتم استخدام العنوان.