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

نص الاستجابة

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

ValidationConclusion

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

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