بازخورد تأیید اعتبار آدرس را ارائه دهید

برای کمک به ما در بهبود کیفیت Address Validation API، می‌توانید به صورت اختیاری بازخورد خود را به Google ارائه دهید تا به ما اطلاع دهد که آیا یک آدرس تأیید شده توسط کاربر نهایی پذیرفته شده است. این بازخورد به ما کمک می کند تا دقت کلی API را بهبود بخشیم.

درخواست بازخورد تأیید اعتبار آدرس

برای ارائه بازخورد پس از تماس با روش اعتبارسنجی آدرس، با روش provideValidationFeedback (REST) ​​یا ProvideValidationFeedback (gRPC) تماس بگیرید. مثال زیر یک درخواست POST به REST API می کند:

https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=YOUR_API_KEY

یک بدنه JSON را به درخواست POST ارسال کنید تا نتیجه تأیید اعتبار آدرس را مشخص کند:

{
  "conclusion": "VALIDATED_VERSION_USED",
  "responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}

جایی که:

• فیلد conclusion باید نتیجه واقعی اعتبار سنجی را منعکس کند.

  در این مثال، VALIDATED_VERSION_USED به‌عنوان مقدار فیلد conclusion ارسال می‌کنید تا نشان دهید که آدرسی که در نهایت استفاده می‌کنید همان آدرسی است که توسط API بازگردانده شده است.

  اگر در نهایت از آدرس ارائه شده توسط کاربر نهایی استفاده کردید، از USER_VERSION_USED عبور کنید.

  برای همه مقادیر ممکن برای conclusion ، به ValidationConclusion مراجعه کنید.

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

  برای مثال هایی در مورد فراخوانی متد validateAddress ، به اعتبارسنجی آدرس مراجعه کنید.

نحوه تنظیم responseID

هر فراخوانی Address Validation API یک مقدار منحصر به فرد را در قسمت responseId پاسخ برمی گرداند.

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

اگر آدرسی که می‌خواهید اعتبار سنجی کنید نیاز به تأیید مجدد دارد، responseId از اولین پاسخ در قسمت previousResponseId در همه درخواست‌های بعدی به Address Validation API ارسال کنید.

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

برای اطلاعات بیشتر در مورد تأیید اعتبار یک آدرس به روز شده، به تأیید اعتبار یک آدرس به روز مراجعه کنید.

در پایان یک سری اعتبارسنجی، توصیه می کنیم با ارائه API بازخورد اعتبارسنجی تماس بگیرید تا ما را از نتیجه نهایی همه تأییدیه ها مطلع کنید. responseId از اولین پاسخ در درخواست API ارائه بازخورد اعتبارسنجی ارسال کنید.

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