التعامل مع العناوين المعدَّلة

في بعض الحالات، قد تجري مكالمات متعددة مع واجهة برمجة تطبيقات التحقق من صحة العناوين لعنوان واحد. على سبيل المثال، قد يقرر العميل التغييرات على عنوانها بعد مشاهدة نتائج التحقق من الصحة. يمكنك بعد ذلك إجراء عملية تحقُّق ثانية من العنوان الذي تم تعديله.

يصف هذا المستند إجراءين رئيسيين يمكنك اتخاذهما عند إصدار سلسلة من العنوان نفسه إلى واجهة برمجة تطبيقات التحقق من صحة العنوان. هذه الإجراءات ليس مطلبًا صارمًا للاستخدام، ولكنه إجراء مفيد من جانبك لتحسين جودة البيانات العامة واستجابة النظام.

  • إرسال طلب إلى نقطة نهاية provideValidationFeedback
  • ضبط الحقل previousResponseID

إرسال طلب للحصول على "provideValidationFeedback"

في نهاية سلسلة من عمليات التحقق، تنصح Google بإجراء اتصال توفير واجهة برمجة تطبيقات ملاحظات التحقق من الصحة للإشارة إلى النتيجة النهائية جميع عمليات التحقق من الصحة. يعيّن الطلب حقلين:

  • conclusion — يشير إلى إصدار التحقق الذي استخدمته في الخدمة، سواء كانت الرسالة التي قدمها المستخدم، أو تلك التي تم عرضها من خلال واجهة برمجة تطبيقات التحقق من صحة العناوين
  • responseId — يشير إلى معرّف الاستجابة الأول من واجهة برمجة تطبيقات التحقق من صحة العناوين راجِع ضبط الحقل beforeResponseId. أدناه.

استخدم إما provideValidationFeedback الطريقة (REST) أو ProvideValidationFeedback (gRPC).

يمرر المثال التالي نص JSON إلى الطلب الذي يحدد الاستنتاج:

curl -X POST -d '{
  "conclusion": "VALIDATED_VERSION_USED",
  "responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=API_KEY"
  • يحدد الحقل conclusion أحد الإجراءات التالية من الجانب:
    • VALIDATED_VERSION_USED: النسخة التي تم التحقق من صحتها للعنوان من واجهة برمجة تطبيقات التحقق من صحة العنوان.
    • USER_VERSION_USED: الإصدار الأصلي الذي يقدّمه المستخدم
    • UNVALIDATED_VERSION_USED: إصدار نتيجة طلب إلى المستخدم، ولكن لم تتم إعادة التحقق من صحته باستخدام واجهة برمجة تطبيقات التحقق من صحة العنوان.
    • UNUSED: تم إلغاء المعاملة.
يمكنك الاطّلاع على خاتمة عملية التحقّق في الدليل المرجعي.
  • يحدّد الحقل responseId نتائج التحقق من العناوين التي تظهر لك. يقدم الملاحظات بشأنها. يجب أن تكون هذه القيمة مماثلة لـ responseId. التي يعرضها الاستدعاء الأول validateAddress.
اطّلِع على نص الطلب في الدليل المرجعي للملاحظات المتعلقة بالتحقق من صحة البيانات.

ضبط الحقل previousResponseID

عند إصدار طلب متابعة، واجهة برمجة تطبيقات التحقق من صحة العنوان لعنوان معين، قم بتعيين الحقل previousResponseId.

  • بالنسبة إلى قيمة previousResponseId، استخدِم القيمة من responseId تعرضها واجهة برمجة التطبيقات بعد طلب التحقق الأول.
  • استخدم هذه القيمة نفسها لجميع طلبات المتابعة حتى سلسلة الإجراءات تكتمل.

يوضح مخطط التسلسل التخطيطي هذا التدفق المفضل:

يمكنك استخدام معرّف الرد لتأكيد صحة عنوان.