Güncellenen adresleri işleme

Bazı durumlarda, tek bir adres için Address Validation API'ye birden fazla çağrı yapabilirsiniz. Ö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 gerçekleştirebileceğiniz iki temel işlem açıklanmaktadır. Bu işlemler katı bir kullanım gerekliliği değildir. Ancak genel veri kalitesini ve sistem yanıtını iyileştirmek için sizin açınızdan faydalı bir işlem olacaktır.

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

provideValidationFeedback isteği gönder

Bir dizi doğrulama işleminin sonunda Google, tüm doğrulamaların nihai sonucunu belirtmek için Doğrulama Geri Bildirimi API'sini Sağla'ya çağrıda bulunmanızı önerir. Bu istekte iki alan ayarlanır:

• conclusion — Hizmetinizde kullandığınız doğrulama sürümünü (kullanıcı tarafından sağlanan sürüm mü yoksa Address Validation API'den döndürülen sürüm mü olduğunu) belirtir.
• responseId — Address Validation API'den gelen ilk yanıtın yanıt kimliğini belirtir. 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, sonucu tanımlayan isteğe bir JSON gövdesi iletilir:

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ı, kendi tarafınızda aşağıdaki işlemlerden birini tanımlar:
  • VALIDATED_VERSION_USED: Adresin Address Validation API'sinden doğrulanmış sürümüdür.
  • USER_VERSION_USED: Kullanıcı tarafından sağlanan orijinal sürüm.
  • UNVALIDATED_VERSION_USED: Kullanıcıya gönderilen bir istem sonucunda ortaya çıkan ancak Address Validation API ile yeniden doğrulanmamış bir sürüm.
  • UNUSED: İşlemden vazgeçti.

Referans kılavuzundaki Doğrulama Sonucu bölümünü inceleyin.

• responseId alanı, hangi adres doğrulama sonuçları için geri bildirim sağladığınızı belirtir. Bu değer, validateAddress yöntemine first çağrısı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'ye takip isteği gönderirken previousResponseId alanını ayarlayın.

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

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