Genel bakış

Google Cüzdan Passes API, iş ortaklarının aşağıdakiler için bir uç nokta belirtmesine olanak tanır: toplu taşıma biletinin etkinleştirilmesi. Etkinleştirme gerektiğinde "Etkinleştir" düğmesi gösterilir Kullanıcı içindir. Bu öğe dokunulduğunda, aşağıda açıklanan parametrelerle belirtilen uç noktayı çağırır. Uç nokta, kartın geçerli teklifi kullanma bilgilerine (barkod veya barkod) sahip olduğundan emin olmalıdır. görsel inceleme) geri dönmeden önce, kullanıcının Cüzdan'ındaki kart güncellenecektir. kullanabilirsiniz. Etkinleştirme öncesinde tüm mevcut tekliften bilgileri görüntülenmez.

Etkinleştirme API'sı

Etkinleştirme uç noktası, API'de activationOptions kullanılarak belirtilir. transit class (nakliye sınıfı) hakkında daha fazla bilgi edinin. İş ortağı, mevcut bir etkinleştirme uç noktasının oluşturulmasından makul bir gecikme.

  activationOptions: {
    activationUrl: string
  }
Alan Açıklama
activationUrl

string

Etkinleştirme istekleri için çağrılacak iş ortağı uç noktasının URL'si. URL, ve robots.txt üzerinde barındırılması, URL yolunun Google tarafından UserAgent:Google-Valuables.

Etkinleştirme durumu, activationStatus alanı kullanılarak nesnede depolanır. Geçerli durumlar arasında NOT_ACTIVATED ve ACTIVATED bulunmaktadır. Etkinleştirme uç nokta, nesneyi ACTIVATED durumuyla güncellemeli ve aynı zamanda nesne, barkod veya görsel inceleme parametreleri gibi geçerli teklif kullanma bilgilerine sahip. İlgili içeriği oluşturmak için kullanılan deviceContext alanı, cihaz sabitleme için kullanılabilir.

  activationStatus: enum (ActivationStatus),
  deviceContext: {
    deviceToken: string
  },
  hasLinkedDevice: boolean
Alan Açıklama
activationStatus

enum (ActivationStatus)

Bu toplu taşıma nesnesinin etkinleştirme durumu. Bu durum, ifadenin şu şekilde gösterilmesini sağlar: destek kaydı oluşturmalı ve kullanıcıların işlem yapmasına olanak tanımalıdır. ör. Etkinleştir düğmesi, NOT_ACTIVATED olarak ayarlanırsa bilet bilgileri.

Kabul edilebilir değerler şunlardır:

  • NOT_ACTIVATED
  • ACTIVATED
deviceContext

object (DeviceContext)

Nesnenin ilişkilendirileceği cihaz bağlamı. Ayarlanırsa teklifi kullanma bilgileri belirtilen cihaza iade edilebilir.
hasLinkedDevice

boolean

Bu nesnenin şu anda tek bir cihaza bağlı olup olmadığı.
DeviceContext
Alan Açıklama
deviceToken

string

Ayarlanırsa teklifi kullanma bilgileri yalnızca etkinleştirme sonrasında belirtilen cihaza döndürülür belirir. Bu kimlik, bir kullanıcının cihazını izlemek için kararlı bir tanımlayıcı olarak kullanılamaz. Google Aynı cihaz için farklı kartlarda ve hatta farklı kartlarda değişiklik gösterebilir. aynı cihaz için etkinleştirme. Bunu ayarlarken arayanlar şunları da ayarlamalıdır: Etkinleştirilmekte olan nesnede hasLinkedDevice.

deviceToken dokümanının alındığına dikkat edin: etkinleştirme parametreleri deviceContext alanı

Cihaz sabitleme

Cihaz sabitleme, kullanıcının bileti bir cihazda etkinleştirmesini ve Bilet kullanma bilgileri yalnızca ilgili cihazda görüntülenir. Bu, multipleDevicesAndHoldersAllowedStatus/ONE_USER_ONE_DEVICE Biletin yalnızca tek bir cihazda gösterilmesine izin verir. Durum Cihaz sabitleme özelliğine sahip ONE_USER_ALL_DEVICES.

Kullanıcı, etkinleştirme işleminden önce bileti görebilir ve düğmeyi her cihazda etkinleştirebilir. sahip olmalıdır. Etkinleştirilip bir cihaza sabitlendikten sonra, sabitlenen cihazda tekliften yararlanma bilgileri gösterilir. Diğer cihazlarda ise kullanıcının bileti başka bir cihaza taşıması için bir etkinleştir düğmesi gösterilir. olanak tanır. Biletin taşınması tercih edilmiyorsa ancak herhangi bir cihazda etkinleştiriliyorsa etkinleştirme sırasında bilet, ONE_USER_ONE_DEVICE olarak güncellenebilir. daha iyi performans gösterdiğini hatırlatmış olalım.

Cihaz sabitlemeyi uygulamak için nesnenin deviceToken alanıyla güncellenmesi gerekir etkinleştirme parametreleri ile alınan ve hasLinkedDevice aynı API çağrısında doğru değerine ayarlandığında İstenirse bilet hasLinkedDevice, gelecekteki bir API çağrısında yanlış değerine ayarlanarak cihazdan bağlantısı kaldırılabilir.

cihaz sabitleme için sıra şeması

Etkinleştirme parametreleri

Etkinleştirme uç noktasına yapılan istek, aşağıdaki parametreleri içerir.

JSON Örneği: 

  {
    classId: “123.classId”,
    objectIds: [ “123.objectId” ],
    expTimeMillis: 1669671940735,
    eventType: “activate”,
    nonce: “1c6fccce-6f66-11ed-a1eb-0242ac120002”,
    deviceContext: “6fba937a-6f6e-11ed-a1eb-0242ac120002”
  }

Tanımlayıcı Açıklama
classId

Tam nitelikli sınıf kimliği. Aşağıdaki biçimi kullanır:

<issuer_id.class_id>
objectIds

Aşağıdaki biçimi kullanan tam nitelikli nesne kimlikleri dizisi:

<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 Her zaman "activate".
nonce Yinelenen yayınları takip etmek için tek seferlik rastgele sayı.
deviceContext

Kullanıcının işlem yaptığı cihazı temsil eden, Google tarafından oluşturulan benzersiz bir kimlik. Bir nesneyi cihaza bağlayan güncellemeler yaparken bu kimlik kullanılmalıdır.

Bu kimlik, belirli bir cihazdan gelecek istekler için sabit olmayabilir.