Güncellenen adresleri işleme

Bazı durumlarda, tek bir adres için Address Validation API'yi birden çok kez çağırabilirsiniz. Örneğin, müşteri ilk doğrulamanın sonuçlarını gördükten sonra adresinde değişiklik yapabilir. Daha sonra, güncellenen adres üzerinde ikinci bir doğrulama işlemi gerçekleştirirsiniz.

Bu belgede, Address Validation API'ye aynı adres için bir dizi istek gönderdiğinizde uygulayabileceğiniz iki önemli işlem açıklanmaktadır. Bu işlemler katı bir kullanım koşulu olmasa da genel veri kalitesini ve sistem yanıtını iyileştirmek için sizin tarafınızdan yapılması yararlı bir işlemdir.

  • provideValidationFeedback uç noktasına istek gönderin
  • previousResponseID alanını ayarlayın

provideValidationFeedback isteği gönder

Google, bir dizi doğrulama işleminin sonunda, Doğrulama geri bildirimi API'sini kullanarak ele alacağız. Bu istekte iki alan ayarlanır:

  • conclusion: Hizmetinizde kullandığınız doğrulama sürümünü (kullanıcı tarafından sağlanan veya Address Validation API'den döndürülen sürüm) belirtir.
  • responseId — Veri öğesinden ilk yanıtın yanıt kimliğini Address Validation API. Aşağıdaki previousResponseId alanını ayarlama bölümüne bakın.

provideValidationFeedback yöntemini (REST) veya ProvideValidationFeedback yöntemini (gRPC) kullanın.

Aşağıdaki örnekte, sonuca dair bilgileri içeren bir JSON gövdesi isteğe iletilmektedir:

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 alanı, taraf:
    • VALIDATED_VERSION_USED: Address Validation API'deki adresin doğrulanmış sürümü.
    • USER_VERSION_USED: Kullanıcı tarafından sağlanan orijinal sürüm.
    • UNVALIDATED_VERSION_USED: kullanıcı isteminin sonucu olarak oluşturulan bir sürüm ancak Address Validation API ile yeniden doğrulanmaması.
    • UNUSED: İşlemden vazgeçti.
Referans kılavuzundaki Doğrulama Sonucu bölümünü inceleyin.
  • responseId alanı, adres doğrulama sonuçlarını belirtir. sağlayabilir. Bu değer, validateAddress yöntemine yapılan ilk çağrının döndürdüğü responseId değeriyle aynı olmalıdır.
Doğrulama geri bildirim referans kılavuzundaki İstek Gövdesi konusuna bakın.

previousResponseID alanını ayarlayın

Belirli bir adres için Address Validation API'den takip isteği gönderirken previousResponseId alanına girin.

  • previousResponseId değeri için, ilk doğrulama isteğinden sonra API tarafından döndürülen responseId değerini kullanın.
  • Seriye kadar olan tüm takip istekleri için aynı değeri kullanın. gerekir.

Bu sıra diyagramı, tercih edilen akışı gösterir:

Bir adresi doğrulamak için yanıt kimliğini kullanın.