Gestire gli indirizzi aggiornati

In alcuni casi, potresti effettuare più chiamate all'API Address Validation per un singolo indirizzo. Ad esempio, il cliente potrebbe apportare modifiche al proprio indirizzo dopo aver visto i risultati della prima convalida. Poi esegui una seconda convalida sull'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 non sono un requisito di utilizzo rigoroso, ma un'azione utile da parte tua per migliorare la qualità complessiva dei dati e la 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 effettuare una chiamata all'API Provide Validation Feedback per indicare il risultato finale di tutte le convalide. La richiesta imposta due campi:

  • conclusion: indica la versione di convalida utilizzata nel servizio, che si tratti di quella fornita dall'utente o di quella restituita dall'API Address Validation.
  • responseId: indica l'ID risposta della prima risposta dell'API Address Validation. Vedi Impostare il campo precedenteResponseId di seguito.

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

L'esempio seguente passa un corpo JSON alla richiesta che definisce la 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 da parte tua:
    • VALIDATED_VERSION_USED: la versione convalidata dell'indirizzo dell'API Address Validation.
    • USER_VERSION_USED: la versione originale fornita dall'utente.
    • UNVALIDATED_VERSION_USED: una versione che è il risultato di una richiesta all'utente, ma che non è stata convalidata di nuovo con l'API Address Validation.
    • UNUSED: ha abbandonato la transazione.
Consulta la sezione Conclusione della convalida nella guida di riferimento.
  • Il campo responseId specifica per quali risultati di convalida dell'indirizzo stai fornendo un feedback. Questo valore deve essere uguale al valore responseId restituito dalla chiamata first al metodo validateAddress.
Consulta Corpo della richiesta nella guida di riferimento sul feedback sulla convalida.

Imposta il campo previousResponseID

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

  • Per il valore di previousResponseId, utilizza il valore di responseId restituito dall'API dopo la prima richiesta di convalida.
  • Utilizza lo stesso valore per tutte le richieste di follow-up fino al completamento della serie.

Questo diagramma di sequenza mostra il flusso preferito:

Utilizza l'ID risposta per convalidare un indirizzo.