REST Resource: giftcardobject

Recurso: GiftCardObject

Representación JSON
{
  "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)
  }
}
Campos
kind
(deprecated)

string

Identifica qué tipo de recurso es. Valor: la cadena fija "walletobjects#giftCardObject"

classReference

object (GiftCardClass)

Una copia de los campos heredados de la clase superior. Estos campos se recuperan durante un GET.

cardNumber

string

Obligatorio. El número de la tarjeta.

pin

string

El PIN de la tarjeta.

balance

object (Money)

El saldo monetario de la tarjeta

balanceUpdateTime

object (DateTime)

Indica la fecha y hora en que se actualizó el saldo por última vez.

El desplazamiento es obligatorio.

Si se actualiza el saldo y no se proporciona esta propiedad, el sistema usará la hora actual de forma predeterminada.

eventNumber

string

El número de evento de la tarjeta, un campo opcional que usan algunas tarjetas de regalo

id

string

Obligatorio. Es el identificador único de un objeto. Este ID debe ser único entre todos los objetos de una entidad emisora. Este valor debe seguir el formato issuer ID.identifier, en el que Google emite el primero y tú eliges el segundo. El identificador único solo debe incluir caracteres alfanuméricos, “.”, “_” o “-”.

classId

string

Obligatorio. La clase asociada con este objeto. La clase debe ser del mismo tipo que este objeto, ya debe existir y debe aprobarse.

Los IDs de clase deben seguir el formato issuer ID.identifier, en el que Google emite el primero y tú eliges el segundo.

version
(deprecated)

string (int64 format)

Obsoleto

state

enum (State)

Obligatorio. El estado del objeto. Este campo se usa para determinar cómo se muestra un objeto en la app. Por ejemplo, un objeto inactive se mueve a "Pases vencidos". sección.

barcode

object (Barcode)

El tipo y valor del código de barras.

messages[]

object (Message)

Un array de mensajes que se muestra en la app. Todos los usuarios de este objeto recibirán los mensajes asociados. La cantidad máxima de estos campos es 10.

validTimeInterval

object (TimeInterval)

El período en el que será active el objeto, y se puede usar. El estado de un objeto cambiará a expired cuando finalice este período.

locations[]

object (LatLongPoint)

Nota: Por el momento, este campo no se admite para activar notificaciones geográficas.

hasUsers

boolean

Indica si el objeto tiene usuarios. La plataforma establece este campo.

smartTapRedemptionValue

string

El valor que se transmitirá a un terminal certificado para Smart Tap mediante NFC para este objeto. Los campos de nivel de clase enableSmartTap y redemptionIssuers también deben configurarse correctamente para que el pase sea compatible con el Toque inteligente. Solo se admiten caracteres ASCII.

hasLinkedDevice

boolean

Indica si este objeto está vinculado actualmente a un solo dispositivo. La plataforma establece este campo cuando un usuario guarda el objeto y lo vincula a su dispositivo. Está diseñada para que la usen socios seleccionados. Comunícate con el equipo de asistencia para obtener más información.

disableExpirationNotification

boolean

Indica si se deben suprimir explícitamente las notificaciones. Si se establece este campo como verdadero, independientemente del campo messages, se suprimirán las notificaciones de vencimiento que envíe al usuario. De forma predeterminada, este campo se establece en falso.

Por el momento, esta opción solo se puede configurar para las ofertas.

infoModuleData

object (InfoModuleData)

Obsoleta. En su lugar, usa textModulesData.

imageModulesData[]

object (ImageModuleData)

Datos del módulo de imagen La cantidad máxima de estos campos que se muestran es 1 desde el nivel de objeto y 1 para el nivel de objeto de clase.

textModulesData[]

object (TextModuleData)

Datos del módulo de texto Si también se definen datos del módulo de texto en la clase, se mostrarán ambos. La cantidad máxima de estos campos que se muestran es 10 para el objeto y 10 para la clase.

rotatingBarcode

object (RotatingBarcode)

El tipo y el valor del código de barras rotativo.

heroImage

object (Image)

Imagen del banner opcional que se muestra en el frente de la tarjeta. Si no hay ninguno, se mostrará la imagen principal de la clase, si está presente. Si la imagen principal de la clase tampoco está presente, no se mostrará nada.

groupingInfo

object (GroupingInfo)

Información que controla cómo se agrupan los pases.

passConstraints

object (PassConstraints)

Pasa las restricciones del objeto. Incluye la limitación de los comportamientos de NFC y capturas de pantalla.

saveRestrictions

object (SaveRestrictions)

Son las restricciones en el objeto que se debe verificar antes de que el usuario intente guardar el pase. Ten en cuenta que estas restricciones solo se aplicarán durante el tiempo de guardado. Si las restricciones cambian después de que un usuario guarda un pase, las restricciones nuevas no se aplicarán a un pase ya guardado.

Métodos

addmessage

Agrega un mensaje al objeto de la tarjeta de regalo al que hace referencia el ID de objeto determinado.

get

Devuelve el objeto de la tarjeta de regalo con el ID de objeto especificado.

insert

Inserta un objeto de tarjeta de regalo con el ID y las propiedades especificados.

list

Devuelve una lista de todos los objetos de tarjetas de regalo de un ID de entidad emisora determinado.

patch

Actualiza el objeto de la tarjeta de regalo al que hace referencia el ID de objeto determinado.

update

Actualiza el objeto de la tarjeta de regalo al que hace referencia el ID de objeto determinado.