Bu kılavuzda, Google Cüzdan API'si ile geri çağırmaların nasıl kullanılacağı açıklanmaktadır. Bir kart oluşturulduğunda veya silindiğinde Google, HTTPS üzerinden bitiş noktası oluşturabilirsiniz. Bu geri çağırma sınıfa özeldir ve verileri içerir etkinlikleri (ör. sınıf, nesne ve etkinlik türü) gösterir. Bu, Gerçekleşen kullanıcı ekleme ve silme işlemlerinin sayısını takip etmek. Örneğin, Örneğin, geri çağırmalar etkinlikleri bir analiz aracına promosyon etkinlikleri sırasında müşteri etkileşimini takip etmek için kullanılan bir uygulamadır.
Ön koşullar
Başlamadan önce aşağıdaki ön koşulları gözden geçirin:
- POST isteklerini işleyen bir HTTPS uç noktası oluşturun. Bu uç noktanın ihtiyacı herkesin erişimine açık olacak.
-
Her sınıf için geri çağırma uç noktasını programatik olarak güncelleyin. Bkz.
callbackOptions
özelliklerini sınıfa göre sınıflandırır. - Önerilen: İmzaları doğrulamak için Tink kitaplığını kullanın.
Geri çağırma uygulama
Kullanıcının nesne belirttiğinde, Google, satıcılara bir aramada ekleme veya silmeyle ilgili ayrıntıları ders başına URL'yi tıklayın. Satıcılar, ilk olarak ortak anahtarların doğruluğunu onaylamak için mesajı alırsınız. Geri çağırmalar mesajı doğruladıktan sonra, geri çağırma işlevleri kullanılabilir. için kullanılır.
İmzayı doğrulayın
İleti imzasını doğrulamak için Tink kitaplığını kullanmanızı öneririz
dikkat etmeniz gerekir. İlgili içeriği oluşturmak için kullanılan
Tink kitaplığı
PaymentMethodTokenRecipient
adlı bir yardımcı program sunar.
imzayı otomatik olarak doğrular ve gerçek iletiyi
başarılı olanlar.
Aşağıdaki örnekte, web sitenizi ziyaret etmek için
PaymentMethodTokenRecipient
:
import java.io.IOException; import javax.servlet.http.*; import com.google.common.io.CharStreams; import com.google.crypto.tink.apps.paymentmethodtoken.*; // Replace ISSUER_ID with your issuer id private static final String RECIPIENT_ID = "ISSUER_ID"; private static final String PUBLIC_KEY_URL = "https://pay.google.com/gp/m/issuer/keys"; private static final String SENDER_ID = "GooglePayPasses"; private static final String PROTOCOL = "ECv2SigningOnly"; private static final GooglePaymentsPublicKeysManager keysManager = new GooglePaymentsPublicKeysManager.Builder() .setKeysUrl(PUBLIC_KEY_URL) .build(); public void doPost(HttpServletRequest request, HttpServletResponse response) throws IOException { try { // Extract signed message with signature from POST request body. String signedMessage = CharStreams.toString(request.getReader()); PaymentMethodTokenRecipient recipient = new PaymentMethodTokenRecipient.Builder() .protocolVersion(PROTOCOL) .fetchSenderVerifyingKeysWith(keysManager) .senderId(SENDER_ID) .recipientId(RECIPIENT_ID) .build(); String serializedJsonMessage = recipient.unseal(signedMessage); // Use serializedJsonMessage to extract the details } catch (Exception e) { // Handle the error } }
Beklenen mesaj biçimi
Mesaj biçimi, şu dizeye göre serileştirilmiş JSON'dur: özellikler:
Tanımlayıcı | Açıklama |
---|---|
classId |
Tam nitelikli sınıf kimliği. Aşağıdaki biçimi kullanır: <issuer_id.class_id> |
objectId |
Tam nitelikli nesne kimliği. Aşağıdaki biçimi kullanır: <issuer_id.object_id> |
expTimeMillis |
EPOCH'tan bu yana geçen milisaniye cinsinden geçerlilik süresi. Süre sona erdiğinde, bu mesajın geçersiz kabul edilmesi gerekir. |
eventType |
Şunun için del veya save olabilir:
DELETE ve SAVE .
|
nonce |
Yinelenen yayınları takip etmek için tek seferlik rastgele sayı. |
Google sunucusundan gelen isteği işleme
Aşağıda, isteğinize konu olan isteğin başlığındaki geri çağırma uç noktanıza gönderilir:
- Kullanıcı Aracısı:
Googlebot
- İçerik Türü:
application/json
Sunucunuzu isteği reddetmeyecek şekilde yapılandırın. Bunun için:
robots.txt
içinde şunları ayarla:
User-agent: Googlebot Disallow:
Yeniden deneme sayısı
Geri arama, elimizden gelenin en iyisini yapar. Google, yeni bir deneme başlatma belgesi oluşturmak için yanıt vermediği veya bir geri çağırma uç noktasının söz konusu olduğu durumlarda ara sıra kesintiler yaşanır ve girişimler olumlu yönde geri alınır.
Yinelenen dağıtımlar
Bazı durumlarda yinelenen yayınlar olabilir. Optimum kampanya performansı için
nonce
.