REST Resource: transitclass

Recurso: TransitClass

Representación JSON
{
  "transitOperatorName": {
    object (LocalizedString)
  },
  "logo": {
    object (Image)
  },
  "transitType": enum (TransitType),
  "watermark": {
    object (Image)
  },
  "languageOverride": string,
  "customTransitTerminusNameLabel": {
    object (LocalizedString)
  },
  "customTicketNumberLabel": {
    object (LocalizedString)
  },
  "customRouteRestrictionsLabel": {
    object (LocalizedString)
  },
  "customRouteRestrictionsDetailsLabel": {
    object (LocalizedString)
  },
  "customTimeRestrictionsLabel": {
    object (LocalizedString)
  },
  "customOtherRestrictionsLabel": {
    object (LocalizedString)
  },
  "customPurchaseReceiptNumberLabel": {
    object (LocalizedString)
  },
  "customConfirmationCodeLabel": {
    object (LocalizedString)
  },
  "customPurchaseFaceValueLabel": {
    object (LocalizedString)
  },
  "customPurchasePriceLabel": {
    object (LocalizedString)
  },
  "customDiscountMessageLabel": {
    object (LocalizedString)
  },
  "customCarriageLabel": {
    object (LocalizedString)
  },
  "customSeatLabel": {
    object (LocalizedString)
  },
  "customCoachLabel": {
    object (LocalizedString)
  },
  "customPlatformLabel": {
    object (LocalizedString)
  },
  "customZoneLabel": {
    object (LocalizedString)
  },
  "customFareClassLabel": {
    object (LocalizedString)
  },
  "customConcessionCategoryLabel": {
    object (LocalizedString)
  },
  "customFareNameLabel": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "enableSingleLegItinerary": boolean,
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "activationOptions": {
    object (ActivationOptions)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideLogo": {
    object (Image)
  },
  "appLinkData": {
    object (AppLinkData)
  }
}
Campos
transitOperatorName

object (LocalizedString)

Indica el nombre del operador de transporte público.

transitType

enum (TransitType)

Obligatorio. Indica el tipo de transporte público que representa esta clase, como "autobús".

watermark

object (Image)

Imagen de marca de agua para mostrar en el dispositivo del usuario.

languageOverride

string

Si se incluye este campo, los boletos de transporte público entregados en el dispositivo de un usuario siempre estarán en este idioma. Representa la etiqueta de idioma BCP 47. Los valores de ejemplo son “en-US”, “en-GB”, “de” o “de-AT”.

customTransitTerminusNameLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor del nombre de la terminal de transporte público (transitObject.ticketLeg.transitTerminusName).

customTicketNumberLabel

object (LocalizedString)

Es una etiqueta personalizada que se usa para el valor del número de ticket (transitObject.ticketNumber).

customRouteRestrictionsLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor de restricciones de ruta (transitObject.ticketRestrictions.routeRestrictions).

customRouteRestrictionsDetailsLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor de detalles de las restricciones de ruta (transitObject.ticketRestrictions.routeRestrictionsDetails).

customTimeRestrictionsLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor de detalles de restricciones de tiempo (transitObject.ticketRestrictions.timeRestrictions).

customOtherRestrictionsLabel

object (LocalizedString)

Una etiqueta personalizada para usar con el valor de las otras restricciones (transitObject.ticketRestrictions.otherRestrictions).

customPurchaseReceiptNumberLabel

object (LocalizedString)

Es una etiqueta personalizada que se usa para el valor del número del recibo de compra (transitObject.purchaseDetails.purchaseReceiptNumber).

customConfirmationCodeLabel

object (LocalizedString)

Es una etiqueta personalizada para usar en el valor del código de confirmación (transitObject.purchaseDetails.confirmationCode).

customPurchaseFaceValueLabel

object (LocalizedString)

Es una etiqueta personalizada que se usa para el valor nominal de compra (transitObject.purchaseDetails.ticketCost.faceValue).

customPurchasePriceLabel

object (LocalizedString)

Es una etiqueta personalizada que se usa para el valor del precio de compra (transitObject.purchaseDetails.ticketCost.purchasePrice).

customDiscountMessageLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor del mensaje de descuento de transporte público (transitObject.purchaseDetails.ticketCost.discountMessage).

customCarriageLabel

object (LocalizedString)

Es una etiqueta personalizada para usar para el valor de carro (transitObject.ticketLeg.carriage).

customSeatLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor de la ubicación de asientos (transitObject.ticketLeg.ticketSeat.seat).

customCoachLabel

object (LocalizedString)

Es una etiqueta personalizada que se utiliza para el valor del coach (transitObject.ticketLeg.ticketSeat.coach).

customPlatformLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor de la plataforma de embarque (transitObject.ticketLeg.platform).

customZoneLabel

object (LocalizedString)

Una etiqueta personalizada para usar en el valor de la zona de abordaje (transitObject.ticketLeg.zone).

customFareClassLabel

object (LocalizedString)

Es una etiqueta personalizada que se utiliza para el valor del tipo de tarifa (transitObject.ticketLeg.ticketSeat.fareClass).

customConcessionCategoryLabel

object (LocalizedString)

Es una etiqueta personalizada que se usa en el valor de la categoría de concesión de transporte público (transitObject.concessionCategory).

customFareNameLabel

object (LocalizedString)

Es una etiqueta personalizada que se usa para el valor del nombre de la tarifa de transporte público (transitObject.ticketLeg.fareName).

classTemplateInfo

object (ClassTemplateInfo)

Información de plantilla sobre cómo se debe mostrar la clase. Si no la estableces, Google recurrirá a un conjunto predeterminado de campos para mostrar.

enableSingleLegItinerary

boolean

Controla la visualización del itinerario de un solo tramo para esta clase. De forma predeterminada, un itinerario solo se mostrará para los viajes con varios tramos.

id

string

Obligatorio. Es el identificador único de una clase. Este ID debe ser único en todas las clases 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 “-”.

version
(deprecated)

string (int64 format)

Obsoleto

issuerName

string

Obligatorio. Nombre de la entidad emisora. La longitud máxima recomendada es de 20 caracteres para garantizar que la cadena completa se muestre en las pantallas más pequeñas.

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.

allowMultipleUsersPerObject
(deprecated)

boolean

Obsoleta. Usa multipleDevicesAndHoldersAllowedStatus en su lugar.

homepageUri

object (Uri)

El URI de la página principal de tu aplicación. Cuando se propaga el URI en este campo, se produce exactamente el mismo comportamiento que cuando se propaga un URI en linksModuleData (cuando se renderiza un objeto, se muestra un vínculo a la página principal en lo que normalmente se consideraría la sección linksModuleData del objeto).

locations[]

object (LatLongPoint)

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

reviewStatus

enum (ReviewStatus)

Obligatorio. Es el estado de la clase. Este campo se puede establecer en draft o underReview mediante las llamadas a la API de insertar, aplicar parches o actualizar. Una vez que se cambie el estado de revisión de draft, no se puede volver a cambiar a draft.

Debes mantener este campo en draft cuando la clase está en desarrollo. No se puede usar una clase draft para crear ningún objeto.

Debes configurar este campo como underReview cuando creas que la clase está lista para usarse. La plataforma establecerá automáticamente este campo en approved y se puede usar de inmediato para crear o migrar objetos.

Cuando actualices una clase que ya es approved, debes seguir estableciendo este campo en underReview.

review

object (Review)

Los comentarios de las opiniones que establece la plataforma cuando se marca una clase como approved o rejected.

infoModuleData
(deprecated)

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.

redemptionIssuers[]

string (int64 format)

Identifica qué entidades emisoras de canje pueden canjear el pase con Smart Tap. Las entidades emisoras de canje se identifican con su ID de entidad emisora. Las entidades emisoras de canjes deben tener configurada al menos una clave de Toque inteligente.

Los campos enableSmartTap y smartTapRedemptionLevel de nivel de objeto también deben configurarse correctamente para que un pase admita el Toque inteligente.

countryCode

string

Es el código de país que se usa para mostrar el país de la tarjeta (cuando el usuario no está en ese país) y contenido localizado cuando el contenido no está disponible en la configuración regional del usuario.

heroImage

object (Image)

Imagen del banner opcional que se muestra en el frente de la tarjeta. Si no hay ninguno, no se mostrará nada. La imagen se mostrará con un ancho del 100%.

wordMark
(deprecated)

object (Image)

Obsoleta.

enableSmartTap

boolean

Identifica si esta clase es compatible con el Toque inteligente. Los campos redemptionIssuers y smartTapRedemptionLevel de nivel de objeto también deben configurarse correctamente para que un pase admita el Toque inteligente.

hexBackgroundColor

string

El color de fondo de la tarjeta Si no se establece el color dominante de la imagen principal, se usa el color dominante del logotipo. El formato es #rrggbb, en el que rrggbb es un triplete RGB hexadecimal, como #ffcc00. También puedes usar la versión abreviada del triplete RGB que es #rgb, como #fc0.

localizedIssuerName

object (LocalizedString)

Cadenas traducidas para encryptionName. La longitud máxima recomendada es de 20 caracteres para garantizar que la cadena completa se muestre en las pantallas más pequeñas.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Identifica si varios usuarios y dispositivos guardarán el mismo objeto que hace referencia a esta clase.

callbackOptions

object (CallbackOptions)

Opciones de devolución de llamada que se usarán para devolver la llamada a la entidad emisora cada vez que el usuario final guarde o borre un objeto de esta clase. Todos los objetos de esta clase son aptos para la devolución de llamada.

securityAnimation

object (SecurityAnimation)

Información opcional sobre la animación de seguridad. Si se configura, se renderizará una animación de seguridad en los detalles del pase.

activationOptions

object (ActivationOptions)

Opciones de activación para un ticket que se puede activar

viewUnlockRequirement

enum (ViewUnlockRequirement)

Consulta las opciones de Requisito de desbloqueo para el boleto de transporte público.

TransitType

Enumeraciones
TRANSIT_TYPE_UNSPECIFIED
BUS
bus

Alias heredado de BUS. Obsoleta.

RAIL
rail

Alias heredado de RAIL. Obsoleta.

TRAM
tram

Alias heredado de TRAM. Obsoleta.

FERRY
ferry

Alias heredado de FERRY. Obsoleta.

OTHER
other

Alias heredado de OTHER. Obsoleta.

ActivationOptions

ActivationOptions para la clase

Representación JSON
{
  "activationUrl": string,
  "allowReactivation": boolean
}
Campos
activationUrl

string

Es una URL HTTPS que admite la semántica de REST. Podría usarse para solicitar la activación de socios valiosos que activan los usuarios

allowReactivation

boolean

Marca esta opción para permitir que los usuarios realicen una llamada de activación desde otro dispositivo. Esto permite que el cliente renderice el botón de activación habilitado, incluso si activationStatus está ACTIVATED, pero el dispositivo solicitado es diferente del dispositivo actual.

Métodos

addmessage

Agrega un mensaje a la clase de transporte público a la que hace referencia el ID de clase dado.

get

Muestra la clase de transporte público con el ID de clase proporcionado.

insert

Inserta una clase de transporte público con el ID y las propiedades especificados.

list

Devuelve una lista de todas las clases de transporte público de un ID de entidad emisora determinado.

patch

Actualiza la clase de transporte público a la que hace referencia el ID de clase dado.

update

Actualiza la clase de transporte público a la que hace referencia el ID de clase dado.