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. Ardından, güncellenen adres için ikinci bir doğrulama 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önderme

Google, bir dizi doğrulamanın sonunda tüm doğrulamaların nihai sonucunu belirtmek için Provide Validation Feedback API'ye çağrı yapılmasını önerir. 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) 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, 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ı, sizin tarafınızdan yapılan aşağıdaki işlemlerden birini tanımlar:
    • 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ıya gösterilen bir istem sonucunda oluşturulan ancak Address Validation API ile yeniden doğrulanmayan bir sürüm.
    • UNUSED: İşlemi terk etti.
Referans kılavuzundaki Doğrulama Sonucu bölümünü inceleyin.
  • responseId alanı, hangi adres doğrulama sonuçları için geri bildirim gönderdiğinizi belirtir. 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 bildirimi referans kılavuzundaki İstek gövdesi bölümüne bakın.

previousResponseID alanını ayarlama

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.
  • Seri tamamlanana kadar tüm takip istekleri için aynı değeri kullanın.

Bu akış şemasında tercih edilen akış gösterilmektedir:

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