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

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

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

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

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

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

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

استخدم إما 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

عند إصدار طلب متابعة إلى Address Validation API لعنوان معيّن، يجب ضبط الحقل previousResponseId.

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

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

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