Güncellenen adresleri işleme

Bazı durumlarda, tek bir adres için Adres Doğrulama API'sine 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. Ardından, güncellenen adreste ikinci bir doğrulama işlemi gerçekleştirirsiniz.

Bu belgede, Adres Doğrulama API'sine 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 koşulu olmasa da genel veri kalitesini ve sistem yanıtını iyileştirmek için yapabileceğiniz faydalı işlemlerdir.

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

provideValidationFeedback isteği gönderme

Bir dizi doğrulamanın sonunda Google, tüm doğrulamaların nihai sonucunu belirtmek için Provide Validation Feedback API'sine çağrı yapılmasını önerir. İstek iki alan ayarlar:

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

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

Aşağıdaki örnek, sonucu tanımlayan isteğe bir JSON gövdesi iletir:

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ı, sizin tarafınızdan yapılan aşağıdaki işlemlerden birini tanımlar:
    • VALIDATED_VERSION_USED: Address Validation API'den alınan adresin doğrulanmış sürümü.
    • USER_VERSION_USED: Kullanıcı tarafından sağlanan orijinal sürüm.
    • UNVALIDATED_VERSION_USED: Kullanıcıya istem gönderilmesi sonucunda oluşturulan ancak Address Validation API ile yeniden doğrulanmayan bir sürüm.
    • UNUSED: işlemi terk ettiyse
Referans kılavuzundaki Doğrulama Sonucu bölümüne bakın.
  • responseId alanı, hangi adres doğrulama sonuçları hakkında geri bildirimde bulunduğunuzu belirtir. Bu değer, validateAddress yöntemine yapılan ilk çağrı tarafından döndürülen responseId değeriyle aynı olmalıdır.
Doğrulama geri bildirimi başvuru kılavuzundaki İstek Gövdesi bölümüne bakın.

previousResponseID alanını ayarlayın

Belirli bir adres için Adres Doğrulama API'sine 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.
  • Bu değeri, seri tamamlanana kadar tüm takip istekleri için kullanın.

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

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