提供地址驗證意見回饋

為協助我們改善 Address Validation API 的品質,您可以選擇提供意見回饋給 Google,讓我們瞭解使用者是否接受經過驗證的地址。這些意見回饋可協助我們改善 API 的整體準確度。

地址驗證意見回饋要求

如要在呼叫地址驗證方法後提供意見回饋,請呼叫 provideValidationFeedback 方法 (REST) 或 ProvideValidationFeedback 方法 (gRPC)。以下範例會向 REST API 發出 POST 要求:

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 欄位會指定要提供意見回饋的地址驗證結果。這個值必須與先前呼叫 validateAddress 方法時傳回的 responseId 值相同。

    如需呼叫 validateAddress 方法的範例,請參閱驗證地址

如何設定「responseID

每個 Address Validation API 呼叫會在回應的 responseId 欄位中傳回不重複的值。

在某些情況下,您可能會針對單一地址對 Address Validation API 進行多次呼叫。例如,使用者可能會在看到第一次驗證的結果後變更地址。然後針對更新後的地址執行第二次驗證。

如果您要驗證的地址需要重新驗證,請在「所有」後續要求中的 previousResponseId 欄位中,將 responseId 從「第一個」回應傳遞至 Address Validation API。

對這些後續追蹤要求的每個回應都包含新的 responseId,但會繼續使用 previousResponseId第一個 responseId 的值,直到驗證完成為止。

如要進一步瞭解如何驗證更新後的地址,請參閱「驗證更新後的地址」。

完成一連串的驗證後,建議您呼叫 Provide Validation Feedback API,讓我們瞭解所有驗證的最終結果。從提供 Validation Feedback API 要求中的第一個回應傳遞 responseId

這張序列圖顯示所需的流程:

使用回應 ID 驗證地址。