آدرس های به روز شده را مدیریت کنید

در برخی موارد، ممکن است چندین تماس با Address Validation API برای یک آدرس واحد برقرار کنید. به عنوان مثال، مشتری ممکن است پس از مشاهده نتایج اولین اعتبارسنجی، تغییراتی در آدرس خود ایجاد کند. سپس اعتبار سنجی دوم را روی آدرس به روز شده انجام می دهید.

این سند دو اقدام کلیدی را توضیح می‌دهد که می‌توانید هنگام ارسال یک سری درخواست برای یک آدرس به Address Validation API انجام دهید. این اقدامات یک الزام استفاده دقیق نیستند، بلکه اقدامی مفید از جانب شما برای بهبود کیفیت کلی داده و پاسخ سیستم هستند.

• درخواستی را به نقطه پایان provideValidationFeedback ارسال کنید
• فیلد previousResponseID را تنظیم کنید

یک درخواست provideValidationFeedback ارسال کنید

در پایان یک سری اعتبارسنجی، Google توصیه می‌کند با ارائه API بازخورد اعتبارسنجی تماس بگیرید تا نتیجه نهایی همه اعتبارسنجی‌ها را نشان دهد. درخواست دو فیلد را تنظیم می کند:

• conclusion - نشان‌دهنده نسخه اعتبارسنجی است که در سرویس خود استفاده کرده‌اید، خواه نسخه ارائه شده توسط کاربر باشد یا نسخه‌ای که از Address Validation API بازگردانده شده است.
• 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 : نسخه معتبر آدرس از Address Validation API.
  • USER_VERSION_USED : نسخه اصلی ارائه شده توسط کاربر.
  • UNVALIDATED_VERSION_USED : نسخه ای که در نتیجه درخواستی به کاربر بوده است، اما آن را مجدداً با Address Validation API تأیید نکرده است.
  • UNUSED : معامله را رها کرد.

نتیجه گیری اعتبار سنجی را در راهنمای مرجع ببینید.

• فیلد responseId مشخص می کند که برای کدام نتایج اعتبارسنجی آدرس بازخورد ارائه می کنید. این مقدار باید همان مقدار responseId باشد که با اولین فراخوانی متد validateAddress بازگردانده شده است.

به بدنه درخواست در راهنمای مرجع بازخورد اعتبار سنجی مراجعه کنید.

فیلد previousResponseID را تنظیم کنید

هنگام صدور یک درخواست پیگیری Address Validation API برای یک آدرس معین، قسمت previousResponseId را تنظیم کنید.

• برای مقدار previousResponseId ، از مقدار responseId که توسط API پس از اولین درخواست اعتبار سنجی بازگردانده شده است استفاده کنید.
• از این مقدار برای همه درخواست‌های پیگیری تا تکمیل مجموعه استفاده کنید.

این نمودار توالی جریان ترجیحی را نشان می دهد: