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.VerifyAddressRequest.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 交易已取消,且未提供地址。