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

در پایان یک سری اعتبارسنجی، 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 پس از اولین درخواست اعتبار سنجی بازگردانده شده است استفاده کنید.
• از این مقدار برای همه درخواست‌های پیگیری تا تکمیل مجموعه استفاده کنید.

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