更新された住所を処理する

場合によっては、サービスに対して複数の 単一の住所に対応する Address Validation API。たとえば、お客様が 最初の住所の結果を見た後に、そのユーザーが 検証できます。その後、更新された住所に対して 2 回目の検証を行います。

このドキュメントでは、一連の API リクエストを発行するときに実行できる 2 つの主要なアクションについて説明します。 Address Validation API に送信します。これらのアクションは 厳格な使用要件ではありませんが、 全体的なデータ品質とシステムの対応です。

  • provideValidationFeedback エンドポイントにリクエストを送信する
  • previousResponseID フィールドを設定する

provideValidationFeedback リクエストを送信する

一連の検証が終了したら、Google は呼び出しを行ってから Validation Feedback API を提供して、インフラストラクチャの すべての検証が行われます。このリクエストでは、次の 2 つのフィールドが設定されます。

  • conclusion - サービスで使用されている検証バージョンを示します。 ユーザーが指定したものなのか、 Address Validation API。
  • responseId - 最初のレスポンスの ID を示します。 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 フィールドでは、 side: <ph type="x-smartling-placeholder">
      </ph>
    • 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 から返されます。
  • 一連のフォローアップ リクエストすべてに、この同じ値を使用します。 表示されます。

次のシーケンス図に推奨されるフローを示します。

レスポンス ID を使用して住所を検証します。