Method: provideValidationFeedback

關於驗證嘗試序列結果的意見回饋。這應該是同一個地址依序發出驗證呼叫後的最後一個呼叫,且應在交易完成後呼叫。對於需要完整驗證地址的 v1.validateAddress 要求序列,此值應只傳送一次。

HTTP 要求

POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "conclusion": enum (ValidationConclusion),
  "responseId": string
}
欄位
conclusion

enum (ValidationConclusion)

必要欄位。驗證嘗試序列的結果。

如果將這個欄位設為 VALIDATION_CONCLUSION_UNSPECIFIED,系統會傳回 INVALID_ARGUMENT 錯誤。

responseId

string

必要欄位。這項意見回饋所屬的回應 ID。這應該是一系列地址驗證嘗試中,第一個回應的 [responseId][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id]。

回應主體

如果成功,回應主體會留白。

ValidationConclusion

驗證地址所需的地址驗證要求序列可能產生的最終結果。

列舉
VALIDATION_CONCLUSION_UNSPECIFIED 此值未使用。如果將 ProvideValidationFeedbackRequest.conclusion 欄位設為 VALIDATION_CONCLUSION_UNSPECIFIED,系統會傳回 INVALID_ARGUMENT 錯誤。
VALIDATED_VERSION_USED Address Validation API 傳回的地址版本用於交易。
USER_VERSION_USED 使用者提供的地址版本已用於交易
UNVALIDATED_VERSION_USED 交易使用的是上次驗證嘗試後輸入的位址版本,但該版本並未重新驗證。
UNUSED 交易已放棄,因此系統並未使用該地址。