REST Resource: giftcardobject

{
  "kind": string,
  "classReference": {
    object (GiftCardClass)
  },
  "cardNumber": string,
  "pin": string,
  "balance": {
    object (Money)
  },
  "balanceUpdateTime": {
    object (DateTime)
  },
  "eventNumber": string,
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}

string

Bu kaynağın ne tür olduğunu tanımlar. Değer: "walletobjects#giftCardObject" sabit dizesi.

object (GiftCardClass)

Üst sınıfın devralınan alanlarının bir kopyası. Bu alanlar GET sırasında alınır.

string

Zorunlu. Kartın numarası.

string

Kartın PIN'i.

object (Money)

Kartın parasal bakiyesi.

object (DateTime)

Bakiyenin en son güncellendiği tarih ve saat.

Ofset gereklidir.

Denge güncellenirse ve bu özellik sağlanmazsa sistem varsayılan olarak mevcut saati kullanır.

string

Kartın etkinlik numarası. Bazı hediye kartları tarafından kullanılan isteğe bağlı bir alandır.

string

Zorunlu. Bir nesnenin benzersiz tanımlayıcısı. Bu kimlik, bir verenin tüm nesneleri arasında benzersiz olmalıdır. Bu değer issuer ID biçiminde olmalıdır.identifier. Bunlardan ilki Google tarafından verilir, ikincisi ise sizin tarafınızdan seçilir. Benzersiz tanımlayıcı yalnızca alfanümerik karakterler, ".", "_" veya "-" içermelidir.

string

Zorunlu. Bu nesneyle ilişkili sınıf. Sınıf, bu nesneyle aynı türde olmalı, zaten mevcut olmalı ve onaylanmalıdır.

Sınıf kimlikleri issuer ID biçimini izlemelidir.identifier. Bunlardan ilki Google tarafından verilir, ikincisi ise sizin tarafınızdan seçilir.

string (int64 format)

Kullanımdan kaldırıldı

enum (State)

Zorunlu. Nesnenin durumu. Bu alan, bir nesnenin uygulamada nasıl görüntüleneceğini belirlemek için kullanılır. Örneğin, bir inactive nesnesi "Süresi dolan kartlar" bölümüne taşınır.

object (Barcode)

Barkod türü ve değeri.

object (Message)

Uygulamada gösterilen bir mesaj dizisi. Bu nesnenin tüm kullanıcıları, ilişkili mesajları alır. Bu alanlar en fazla 10 tane olabilir.

object (TimeInterval)

Bu nesnenin active olacağı ve nesnenin kullanılabileceği dönem. Bu süre geçtiğinde nesnenin durumu expired olarak değiştirilir.

object (LatLongPoint)

Not: Şu anda bu alan, coğrafi bildirimleri tetiklemek için desteklenmemektedir.

boolean

Nesnenin kullanıcı olup olmadığını belirtir. Bu alan platform tarafından belirlenir.

string

Bu nesne için NFC üzerinden Smart Tap sertifikalı bir terminale iletilecek değer. Kartın Akıllı Dokunma'yı desteklemesi için sınıf düzeyindeki enableSmartTap ve redemptionIssuers alanları da doğru şekilde ayarlanmalıdır. Yalnızca ASCII karakterler desteklenir.

boolean

Bu nesnenin şu anda tek bir cihaza bağlı olup olmadığı. Bu alan, kullanıcı nesneyi kaydedip cihazına bağladığında platform tarafından ayarlanır. Belirli iş ortakları tarafından kullanılmak üzere tasarlanmıştır. Daha fazla bilgi için destek ekibiyle iletişime geçin.

boolean

Bildirimlerin açıkça engellenip engellenmeyeceğini belirtir. Bu alan true (doğru) değerine ayarlanırsa messages alanından bağımsız olarak kullanıcıya gönderilen süre sonu bildirimleri engellenir. Bu alan varsayılan olarak "yanlış" değerine ayarlanır.

Bu özellik şu anda yalnızca teklifler için ayarlanabilir.

object (InfoModuleData)

Kullanımdan kaldırıldı. Bunun yerine textModulesData parametresini kullanın.

object (ImageModuleData)

Resim modülü verileri. Bu alanların gösterilen maksimum sayısı, nesne düzeyinde 1 ve sınıf nesnesi düzeyinde 1'dir.

object (TextModuleData)

Metin modülü verileri. Sınıfta metin modülü verileri de tanımlanmışsa her ikisi de gösterilir. Bu alanların gösterilen maksimum sayısı, nesneden 10 ve sınıftan 10'dur.

object (LinksModuleData)

Bağlantılar modülü verileri. Bağlantı modülü verileri sınıfta da tanımlanmışsa her ikisi de gösterilir.

object (AppLinkData)

Kartın ön tarafında düğme olarak gösterilecek isteğe bağlı uygulama veya web sitesi bağlantısı. İlgili sınıf için AppLinkData sağlanırsa yalnızca AppLinkData nesnesi gösterilir.

object (RotatingBarcode)

Dönen barkod türü ve değeri.

object (Image)

Kartın ön tarafında gösterilen isteğe bağlı banner resmi. Yoksa, varsa sınıfın hero resmi gösterilir. Sınıfın hero resmi de yoksa hiçbir şey gösterilmez.

object (GroupingInfo)

Kartların nasıl gruplandırılacağını kontrol eden bilgiler.

object (PassConstraints)

Nesne için kısıtlamaları iletin. NFC ve ekran görüntüsü davranışlarını sınırlama da buna dahildir.

object (SaveRestrictions)

Kullanıcının kartı kaydetmeye çalışmadan önce doğrulanması gereken nesneyle ilgili kısıtlamalar. Bu kısıtlamaların yalnızca programdan yararlanıldığı sırada geçerli olacağını unutmayın. Kullanıcı geçişi kaydettikten sonra kısıtlamalar değişirse yeni kısıtlamalar, önceden kaydedilmiş geçişlere uygulanmaz.

string

linkedObjectId’ler bu hediye kartı nesnesine otomatik olarak eklenmesi gereken etkinlik bileti, bağlılık, fırsat, genel, hediye kartı, toplu taşıma ve biniş kartı gibi diğer nesnelerin listesidir. Kullanıcı bu hediye kartını kaydettiyse bu linkedObjectIds, kullanıcının cüzdanına otomatik olarak gönderilir (bu tür bağlı kartları alma ayarını devre dışı bırakmadığı sürece).

linkedObjectIds'de bulunan nesnelerin zaten eklendiğinden emin olun. Aksi takdirde çağrılar başarısız olur. Bağlı nesnelerin bağlantısı kaldırılamaz. Başka bir verene ait nesneleri bağlayamazsınız. Tek bir nesneye bağlanabilecek nesne sayısı sınırlıdır. Sınıra ulaşıldığında görüşmedeki yeni bağlı nesneler sessizce yoksayılır.

Nesne kimlikleri issuer ID biçimini izlemelidir.identifier. Bunlardan ilki Google tarafından, ikincisi ise sizin tarafınızdan seçilir.

enum (NotificationSettingsForUpdates)

Bu nesnede yapılan alan güncellemelerinin bildirimleri tetikleyip tetiklemeyeceğini belirler. NOTIFY olarak ayarlandığında, kullanıcılara alan güncelleme bildirimi göndermeye çalışırız. Bu bildirimler yalnızca ilgili alan bir izin verilenler listesinde yer alıyorsa kullanıcılara gönderilir. DO_NOT_NOTIFY veya ACCOUNT_SETTINGS_UNSPECIFIED olarak ayarlanırsa herhangi bir bildirim tetiklenmez. Bu ayar geçicidir ve her PATCH veya UPDATE isteğiyle birlikte ayarlanması gerekir. Aksi takdirde bildirim tetiklenmez.

object (ValueAddedModuleData)

İsteğe bağlı katma değer modülü verileri. Nesnede en fazla on tane olabilir.