Google Cüzdan Kartlar API'si, iş ortaklarının Google Cüzdan'a dönen barkodlar kaydetmesine olanak tanır. Bu barkodlar yalnızca kısa bir süre için geçerlidir. Böylece, barkod ekran görüntüsü alma riskini azaltmak için ek güvenlik sağlanır. Barkodlar, gizli anahtarı iş ortağı tarafından sağlanarak RFC 6238'e uygun şekilde cihazda oluşturulur. Ancak bir iş ortağı barkodları kendi üretmeyi tercih ederse Google, barkodların Google'a toplu olarak yüklenebilmesi için bir API sağlar. Bu barkodlar daha sonra kullanıcıların telefonlarına aktarılır. Burada dönen barkodlar gibi davranır ve kısa bir süre boyunca gösterilir. Bu çözüme iş ortağı tarafından oluşturulan dönen barkodlar diyoruz.
İş Ortağı Tarafından Oluşturulan Dönen Barkod API'si
İş ortağı tarafından oluşturulan dönen barkodlar, aynı RotatingBarcode nesnesi kullanılarak oluşturulur. Yalnızca tür gereklidir ancak küçük bir başlangıç barkodları grubu initialRotatingBarcodeValues oluşturmanızı ve bunları göndermenizi de öneririz. İş ortağı, kullanıcı için her zaman geçerli bir barkod hazır olmasını sağlamaktan ve initialRotatingBarcodeValues sonraki toplu yükleme çağrısının eşzamansız olmasını sağlamaktan sorumludur.
rotatingBarcode {
initialRotatingBarcodeValues: object (RotatingBarcodeValues),
type: enum (BarcodeType),
}
| Alan | Açıklama |
|---|---|
initialRotatingBarcodeValues |
Barkoda kodlanacak değerler. En az bir değer girilmelidir. Bu ilk barkodlar, kullanıcının kartını ilk edindiği zaman ile sonraki toplu yükleme çağrısı arasındaki boşluğu doldurmak için kullanılır. |
type |
Zorunlu. Bu barkodu türü. Kabul edilen değerler şunlardır:
|
| Alan | Açıklama |
|---|---|
startDateTime |
İlk barkodun geçerli olduğu tarih/saat. Barkodlar Bu, bir ofset içeren ISO 8601 genişletilmiş biçimli tarih/saattir. |
values[] |
Barkoda kodlanacak değerler. En az bir değer girilmelidir. Maksimum değer sayısı yoktur ancak istek gövdesinin boyutunun 5 MB'ı aşmaması gerektiğini unutmayın. |
periodMillis |
Her barkodun geçerli olduğu süre. |
Barkod değerlerini toplu olarak güncelleme
RotatingBarcode nesnesi oluşturulduktan sonra, kullanıcının kartının süresi dolana kadar her gün bir günlük barkod yüklemenizi öneririz. Bu işlem aşağıdaki REST API uç noktasıyla yapılabilir.
Yöntem: transitobject.uploadrotatingbarcodevalues
Dönen barkod değerlerini, belirtilen nesne kimliği tarafından referans verilen toplu taşıma nesnesine yükler.
HTTP isteği
POST
https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc
eId}/uploadRotatingBarcodeValues
Yol parametreleri
| Parametre | Açıklama |
|---|---|
resourceId |
Bir nesnenin benzersiz tanımlayıcısı. |
İstek içeriği
İstek metni (5 MB'ı aşamaz), RotatingBarcodeValues öğesinin bir örneğini içerir.
Yöntem: transitobject.downloadrotatingbarcodevalues
Belirtilen nesne kimliği tarafından referans verilen toplu taşıma nesnesi için dönen barkod değerlerini indirir. Bu, iş ortaklarının en son grubu doğrulamak istemesi durumunda faydalıdır.
HTTP isteği
GET
https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do
wnloadRotatingBarcodeValues?alt=media
Yol parametreleri
| Parametre | Açıklama |
|---|---|
resourceId |
Bir nesnenin benzersiz tanımlayıcısı. |