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önderinpreviousResponseID
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ülenresponseId
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: