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. Ardından, güncellenen adres üzerinde ikinci bir doğrulama gerçekleştiriyorsunuz.
Bu dokümanda, 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 gereksinimi değildir, ancak genel veri kalitesini ve sistem yanıtını iyileştirmek için sizin açınızdan faydalı bir işlemdir.
provideValidationFeedback
uç noktasına istek gönderinpreviousResponseID
alanını ayarlayın
provideValidationFeedback
isteği gönder
Bir dizi doğrulamanın sonunda Google, tüm doğrulamaların nihai sonucunu belirtmek için Doğrulama Geri Bildirimi Sağlama API'sine çağrı yapılmasını önerir. İstek iki alanı ayarlar:
conclusion
: Hizmetinizde kullandığınız doğrulama sürümünü belirtir. Kullanıcı tarafından sağlanan sürüm mü yoksa Address Validation API'den döndürülen sürüm müdür?responseId
— Address Validation API'den alınan ilk yanıtın yanıt kimliğini belirtir. Aşağıdaki PreviousResponseId alanını ayarlama konusuna bakın.
provideValidationFeedback yöntemini (REST) veya ProvideValidationFeedback yöntemini (gRPC) kullanabilirsiniz.
Aşağıdaki örnek, sonucu tanımlayan isteğe bir JSON gövdesi aktarır:
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ızda aşağıdaki işlemlerden birini tanımlar:VALIDATED_VERSION_USED
: Address Validation API'deki adresin 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 oluşturulan, ancak Address Validation API ile yeniden doğrulanmayan bir sürüm.UNUSED
: İşlemden vazgeçti.
Referans kılavuzunda Validation Conclusion (Doğrulama Sonucu) bölümüne göz atın. |
responseId
alanı, hangi adres doğrulama sonuçları için geri bildirim sağladığınızı belirtir. Bu değer, validateAddress yöntemine yapılan ilk çağrı tarafından döndürülenresponseId
değeriyle aynı olmalıdır.
Doğrulama geri bildirimi referans kılavuzunda İstek Gövdesi bölümüne bakın. |
previousResponseID
alanını ayarlayın
Belirli bir adres için Address Validation API'ye bir 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: