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

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

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

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

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

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

  • conclusion — يشير إلى إصدار التحقق الذي استخدمته في خدمتك، سواء كان الإصدار الذي قدّمه المستخدم أو الإصدار الذي تم عرضه من واجهة برمجة تطبيقات التحقق من صحة العنوان.
  • responseId — يشير إلى رقم تعريف الاستجابة الأول للاستجابة من واجهة برمجة تطبيقات التحقق من صحة العنوان. اطّلع على تعيين الحقل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

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

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

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

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