Gestire gli indirizzi aggiornati

In alcuni casi, è possibile effettuare più chiamate al API Address Validation per un singolo indirizzo. Ad esempio, il cliente potrebbe modifiche al proprio indirizzo dopo aver visto i risultati della prima dei dati. Quindi esegui una seconda convalida per l'indirizzo aggiornato.

Questo documento descrive due azioni chiave che puoi intraprendere quando emetti una serie di richieste per lo stesso indirizzo all'API Address Validation. Queste azioni sono non è un requisito di utilizzo rigoroso, ma un'azione utile da parte tua per migliorare qualità complessiva dei dati e risposta del sistema.

  • Invia una richiesta all'endpoint provideValidationFeedback
  • Imposta il campo previousResponseID

Invia una richiesta provideValidationFeedback

Al termine di una serie di convalide, Google consiglia di chiamare il Fornisci l'API Validation Feedback per indicare il risultato finale della tutte le convalide. La richiesta imposta due campi:

  • conclusion: indica la versione di convalida utilizzata nel servizio. che sia quello fornito dall'utente o quello restituito API Address Validation.
  • responseId: indica l'ID risposta della prima risposta del API Address Validation. Consulta Impostare il campo beforeResponseId di seguito.

Utilizza il provideValidationFeedback (REST) o ProvideValidationFeedback (gRPC).

L'esempio seguente passa un corpo JSON alla richiesta che definisce Conclusione:

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"
  • Il campo conclusion identifica una delle seguenti azioni del tuo lato:
    • VALIDATED_VERSION_USED: la versione convalidata dell'indirizzo da l'API Address Validation.
    • USER_VERSION_USED: la versione originale fornita dall'utente.
    • UNVALIDATED_VERSION_USED: una versione risultante da un prompt di l'utente, ma non l'ha riconvalidato con l'API Address Validation.
    • UNUSED: ha abbandonato la transazione.
Consulta la sezione Conclusione della convalida nella guida di riferimento.
  • Il campo responseId consente di specificare i risultati di convalida degli indirizzi che stai per fornire un feedback. Questo valore deve essere uguale a responseId restituito dalla prima chiamata Metodo validateAddress.
Consulta il Corpo della richiesta nella guida di riferimento per il feedback sulla convalida.

Imposta il campo previousResponseID

Quando invii una richiesta di follow-up, l'API Address Validation per un determinato indirizzo, imposta il campo previousResponseId.

  • Per il valore di previousResponseId, utilizza il valore di responseId restituiti dall'API dopo la prima richiesta di convalida.
  • Utilizza lo stesso valore per tutte le richieste di follow-up fino alla serie vengono completate.

Questo diagramma di sequenza mostra il flusso preferito:

Utilizza l'ID risposta per convalidare un indirizzo.