REST Resource: transitclass

リソース: TransitClass

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)
  }
}
フィールド
transitOperatorName

object (LocalizedString)

交通機関の名前。

transitType

enum (TransitType)

必須。このクラスが表す交通機関のタイプ(「バス」など)。

watermark

object (Image)

ユーザーのデバイスに表示する透かし画像。

languageOverride

string

このフィールドが存在する場合、ユーザーのデバイスに配信される交通機関の乗車券は常にこの言語で表記されます。BCP 47 言語タグを表します。(例: 「en-US」、「en-GB」、「de」、「de-AT」)。

customTransitTerminusNameLabel

object (LocalizedString)

終点名の値(transitObject.ticketLeg.transitTerminusName)に使用するカスタムラベル。

customTicketNumberLabel

object (LocalizedString)

チケット番号の値(transitObject.ticketNumber)に使用するカスタムラベル。

customRouteRestrictionsLabel

object (LocalizedString)

利用ルートの制限の値(transitObject.ticketRestrictions.routeRestrictions)に使用するカスタムラベル。

customRouteRestrictionsDetailsLabel

object (LocalizedString)

利用ルート制限の詳細の値(transitObject.ticketRestrictions.routeRestrictionsDetails)に使用するカスタムラベル。

customTimeRestrictionsLabel

object (LocalizedString)

時間制限の詳細の値(transitObject.ticketRestrictions.timeRestrictions)に使用するカスタムラベル。

customOtherRestrictionsLabel

object (LocalizedString)

他の制限値(transitObject.ticketRestrictions.otherRestrictions)に使用するカスタムラベル。

customPurchaseReceiptNumberLabel

object (LocalizedString)

購入領収書番号の値(transitObject.purchaseDetails.purchaseReceiptNumber)に使用するカスタムラベル。

customConfirmationCodeLabel

object (LocalizedString)

確認コードの値(transitObject.purchaseDetails.confirmationCode)に使用するカスタムラベル。

customPurchaseFaceValueLabel

object (LocalizedString)

購入額面額(transitObject.purchaseDetails.ticketCost.faceValue)に使用するカスタムラベル。

customPurchasePriceLabel

object (LocalizedString)

購入価格の値(transitObject.purchaseDetails.ticketCost.purchasePrice)に使用するカスタムラベル。

customDiscountMessageLabel

object (LocalizedString)

交通機関の割引メッセージの値(transitObject.purchaseDetails.ticketCost.discountMessage)に使用するカスタムラベル。

customCarriageLabel

object (LocalizedString)

車両の値(transitObject.ticketLeg.carriage)に使用するカスタムラベル。

customSeatLabel

object (LocalizedString)

座席位置の値(transitObject.ticketLeg.ticketSeat.seat)に使用するカスタムラベル。

customCoachLabel

object (LocalizedString)

コーチの値(transitObject.ticketLeg.ticketSeat.coach)に使用するカスタムラベル。

customPlatformLabel

object (LocalizedString)

乗車プラットフォームの値(transitObject.ticketLeg.platform)に使用するカスタムラベル。

customZoneLabel

object (LocalizedString)

乗車区間の値(transitObject.ticketLeg.zone)に使用するカスタムラベル。

customFareClassLabel

object (LocalizedString)

運賃クラスの値(transitObject.ticketLeg.ticketSeat.fareClass)に使用するカスタムラベル。

customConcessionCategoryLabel

object (LocalizedString)

交通機関割引カテゴリの値(transitObject.concessionCategory)に使用するカスタムラベル。

customFareNameLabel

object (LocalizedString)

交通機関運賃名の値(transitObject.ticketLeg.fareName)に使用するカスタムラベル。

classTemplateInfo

object (ClassTemplateInfo)

クラスの表示方法に関するテンプレート情報。設定しない場合、表示されるデフォルトのフィールド セットにフォールバックします。

enableSingleLegItinerary

boolean

このクラスの 1 区間の旅行プランの表示を制御します。デフォルトでは、旅程は複数区間にまたがるルートにのみ表示されます。

id

string

必須。クラスの一意の識別子。この ID は、発行者のすべてのクラスに対して一意である必要があります。この値は issuer ID の形式にする必要があります。identifier: 前者は Google が発行し、後者はユーザーが選択したものです。一意の識別子には、英数字、「.」、「_」、「-」のみを使用できます。

version
(deprecated)

string (int64 format)

非推奨

issuerName

string

必須。発行者の名前。小さな画面でも文字列全体が表示されるように、20 文字以下にすることをおすすめします。

messages[]

object (Message)

アプリに表示されるメッセージの配列。このオブジェクトのすべてのユーザーが、関連するメッセージを受信します。これらのフィールドの最大数は 10 です。

allowMultipleUsersPerObject
(deprecated)

boolean

非推奨です。multipleDevicesAndHoldersAllowedStatus を代わりに使用してください。

homepageUri

object (Uri)

アプリケーションのホームページの URI。このフィールドに URI を設定すると、linksModuleData に URI を入力する場合とまったく同じ動作になります(オブジェクトがレンダリングされると、通常そのオブジェクトの linksModuleData セクションと考えられる場所にホームページへのリンクが表示されます)。

locations[]

object (LatLongPoint)

注: 現在、このフィールドは位置情報に関する通知のトリガーに対応していません。

reviewStatus

enum (ReviewStatus)

必須。クラスのステータス。このフィールドは、挿入、パッチ、更新の API 呼び出しを使用して draft または underReview に設定できます。レビュー ステータスを draft から変更すると、draft に戻すことはできません。

クラスが開発中の場合は、このフィールドを draft のままにしてください。draft クラスを使用してオブジェクトを作成することはできません。

クラスを使用する準備ができたら、このフィールドを underReview に設定する必要があります。プラットフォームでは、このフィールドが自動的に approved に設定され、オブジェクトの作成や移行にすぐに使用できます。

すでに approved クラスを更新する場合は、このフィールドを underReview に設定したままにする必要があります。

review

object (Review)

クラスが approved または rejected とマークされたときにプラットフォームによって設定されたレビュー コメント。

infoModuleData
(deprecated)

object (InfoModuleData)

非推奨です。代わりに textModulesData を使用してください。

imageModulesData[]

object (ImageModuleData)

画像モジュールのデータ。表示されるこれらのフィールドの最大数は、オブジェクト レベルで 1 個、クラス オブジェクト レベルで 1 個です。

textModulesData[]

object (TextModuleData)

テキスト モジュールのデータ。テキスト モジュール データもクラスで定義されている場合は、両方が表示されます。表示されるこれらのフィールドの最大数は、オブジェクトから 10 個、クラスから 10 個です。

redemptionIssuers[]

string (int64 format)

スマートタップでパスを利用できるクーポン発行者を識別します。クーポン発行者は発行者 ID で識別されます。クーポン発行者には、少なくとも 1 つのスマートタップ キーが設定されている必要があります。

パスでスマートタップをサポートするには、enableSmartTap フィールドとオブジェクト レベルの smartTapRedemptionLevel フィールドも正しく設定する必要があります。

countryCode

string

カードの国を表示するために使用される国コード(ユーザーがその国にいない場合)。また、ユーザーのロケールでコンテンツが利用できない場合に、ローカライズされたコンテンツを表示するために使用される国コード。

heroImage

object (Image)

カードの表面に表示されるオプションのバナー画像。存在しない場合は、何も表示されません。画像は 100% の幅で表示されます。

wordMark
(deprecated)

object (Image)

廃止されました。

enableSmartTap

boolean

このクラスがスマートタップをサポートしているかどうかを指定します。パスでスマートタップをサポートするには、redemptionIssuers フィールドとオブジェクト レベルの smartTapRedemptionLevel フィールドも正しく設定する必要があります。

hexBackgroundColor

string

カードの背景色。設定しない場合、ヒーロー画像のドミナント カラーが使用されます。ヒーロー画像が設定されていない場合は、ロゴのドミナント カラーが使用されます。形式は #rrggbb です。ここで、rrggbb は 16 進数の RGB トリプレットです(例: #ffcc00)。#fc0 など、RGB トリプレットの省略形(#rgb)を使用することもできます。

localizedIssuerName

object (LocalizedString)

IssuerName の翻訳文字列。小さな画面でも文字列全体が表示されるように、20 文字以下にすることをおすすめします。

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

このクラスを参照する同じオブジェクトを複数のユーザーとデバイスで保存するかどうかを指定します。

callbackOptions

object (CallbackOptions)

エンドユーザーがこのクラスのオブジェクトを保存または削除するたびに、発行元をコールバックするために使用するコールバック オプション。このクラスのすべてのオブジェクトはコールバックの対象となります。

securityAnimation

object (SecurityAnimation)

セキュリティ アニメーションに関する省略可能な情報。これが設定されている場合、セキュリティ アニメーションがパスの詳細にレンダリングされます。

activationOptions

object (ActivationOptions)

有効化可能なチケットの有効化オプション。

viewUnlockRequirement

enum (ViewUnlockRequirement)

交通機関の乗車券のロック解除要件のオプションを表示します。

TransitType

列挙型
TRANSIT_TYPE_UNSPECIFIED
BUS
bus

BUS のレガシー エイリアス。廃止されました。

RAIL
rail

RAIL のレガシー エイリアス。廃止されました。

TRAM
tram

TRAM のレガシー エイリアス。廃止されました。

FERRY
ferry

FERRY のレガシー エイリアス。廃止されました。

OTHER
other

OTHER のレガシー エイリアス。廃止されました。

ActivationOptions

クラスの ActivationOptions

JSON 表現
{
  "activationUrl": string,
  "allowReactivation": boolean
}
フィールド
activationUrl

string

REST セマンティクスをサポートする HTTPS URL。特定の有価物に対するパートナーのアクティベーションをリクエストするために使用され、ユーザーがトリガーします。

allowReactivation

boolean

ユーザーが別のデバイスから有効化の呼び出しを行うことを許可するフラグ。これにより、 activationStatus が ACTIVATED であっても、リクエストされたデバイスが現在のデバイスと異なる場合でも、クライアントは有効化ボタンを有効に表示できます。

Methods

addmessage

指定されたクラス ID の交通機関クラスにメッセージを追加します。

get

指定されたクラス ID の交通機関クラスを返します。

insert

指定された ID とプロパティの交通機関クラスを挿入します。

list

指定された発行者 ID のすべての交通機関クラスのリストを返します。

patch

指定されたクラス ID の交通機関クラスを更新します。

update

指定されたクラス ID の交通機関クラスを更新します。