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

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

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

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

إرسال طلب provideValidationFeedback

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

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

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

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

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