Trang này được dịch bởi Cloud Translation API.

REST Resource: transitclass

Tài nguyên: TransitClass
Phương thức

Tài nguyên: TransitClass

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng 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`) }, "notifyPreference": enum (`NotificationSettingsForUpdates`), "appLinkData": { object (`AppLinkData`) }, "valueAddedModuleData": [ { object (`ValueAddedModuleData`) } ] }

{
  "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)
  },
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}

Trường
`transitOperatorName`	`object (LocalizedString)` Tên của nhà vận hành phương tiện công cộng.
`logo`	`object (Image)` Bắt buộc. Hình ảnh biểu trưng của vé. Hình ảnh này hiển thị trong chế độ xem chi tiết thẻ của ứng dụng.
`transitType`	`enum (TransitType)` Bắt buộc. Loại phương tiện mà lớp này đại diện, chẳng hạn như "xe buýt".
`watermark`	`object (Image)` Hình ảnh hình mờ để hiển thị trên thiết bị của người dùng.
`languageOverride`	`string` Nếu có trường này, vé phương tiện công cộng được phân phát đến thiết bị của người dùng sẽ luôn bằng ngôn ngữ này. Biểu thị thẻ ngôn ngữ BCP 47. Giá trị mẫu là "en-US", "en-GB", "de" hoặc "de-AT".
`customTransitTerminusNameLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho giá trị tên nhà ga cuối (`transitObject.ticketLeg.transitTerminusName`).
`customTicketNumberLabel`	`object (LocalizedString)` Một nhãn tuỳ chỉnh để sử dụng cho giá trị số phiếu yêu cầu hỗ trợ (`transitObject.ticketNumber`).
`customRouteRestrictionsLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho giá trị hạn chế về lộ trình (`transitObject.ticketRestrictions.routeRestrictions`).
`customRouteRestrictionsDetailsLabel`	`object (LocalizedString)` Một nhãn tuỳ chỉnh dùng cho giá trị thông tin chi tiết về các quy định hạn chế về tuyến đường (`transitObject.ticketRestrictions.routeRestrictionsDetails`).
`customTimeRestrictionsLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho giá trị chi tiết về quy định hạn chế về thời gian (`transitObject.ticketRestrictions.timeRestrictions`).
`customOtherRestrictionsLabel`	`object (LocalizedString)` Một nhãn tuỳ chỉnh để sử dụng cho giá trị hạn chế khác (`transitObject.ticketRestrictions.otherRestrictions`).
`customPurchaseReceiptNumberLabel`	`object (LocalizedString)` Một nhãn tuỳ chỉnh để sử dụng cho giá trị của mã số biên nhận mua hàng (`transitObject.purchaseDetails.purchaseReceiptNumber`).
`customConfirmationCodeLabel`	`object (LocalizedString)` Một nhãn tuỳ chỉnh để sử dụng cho giá trị mã xác nhận (`transitObject.purchaseDetails.confirmationCode`).
`customPurchaseFaceValueLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho mệnh giá khi mua (`transitObject.purchaseDetails.ticketCost.faceValue`).
`customPurchasePriceLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho giá mua (`transitObject.purchaseDetails.ticketCost.purchasePrice`).
`customDiscountMessageLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho giá trị thông báo chiết khấu vận chuyển (`transitObject.purchaseDetails.ticketCost.discountMessage`).
`customCarriageLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho giá trị đầu dòng (`transitObject.ticketLeg.carriage`).
`customSeatLabel`	`object (LocalizedString)` Một nhãn tuỳ chỉnh để sử dụng cho giá trị vị trí của chỗ ngồi (`transitObject.ticketLeg.ticketSeat.seat`).
`customCoachLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho giá trị huấn luyện viên (`transitObject.ticketLeg.ticketSeat.coach`).
`customPlatformLabel`	`object (LocalizedString)` Một nhãn tuỳ chỉnh để sử dụng cho giá trị của nền tảng lên máy bay (`transitObject.ticketLeg.platform`).
`customZoneLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho giá trị khu vực lên máy bay (`transitObject.ticketLeg.zone`).
`customFareClassLabel`	`object (LocalizedString)` Một nhãn tuỳ chỉnh để sử dụng cho giá trị hạng vé (`transitObject.ticketLeg.ticketSeat.fareClass`).
`customConcessionCategoryLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho giá trị danh mục đặc quyền vận chuyển (`transitObject.concessionCategory`).
`customFareNameLabel`	`object (LocalizedString)` Nhãn tuỳ chỉnh để sử dụng cho giá trị tên phí đi phương tiện công cộng (`transitObject.ticketLeg.fareName`).
`classTemplateInfo`	`object (ClassTemplateInfo)` Thông tin mẫu về cách hiển thị lớp. Nếu bạn không đặt chính sách này, Google sẽ chuyển dự phòng về nhóm trường mặc định để hiển thị.
`enableSingleLegItinerary`	`boolean` Kiểm soát việc hiển thị hành trình một chặng cho lớp này. Theo mặc định, hành trình sẽ chỉ hiển thị cho các chuyến đi nhiều chặng.
`id`	`string` Bắt buộc. Giá trị nhận dạng duy nhất của một lớp. Mã nhận dạng này phải là duy nhất trên tất cả các lớp của một tổ chức phát hành. Giá trị này phải tuân theo định dạng `issuer ID`.`identifier`, trong đó mã bưu chính do Google phát hành còn mã sau do bạn chọn. Giá trị nhận dạng duy nhất của bạn chỉ được bao gồm ký tự chữ-số, ".", "_" hoặc "-".
`version (deprecated)`	`string (int64 format)` Mục này không được dùng nữa! Không được dùng nữa
`issuerName`	`string` Bắt buộc. Tên tổ chức phát hành. Độ dài tối đa được đề xuất là 20 ký tự để đảm bảo chuỗi đầy đủ hiển thị trên các màn hình nhỏ hơn.
`messages[]`	`object (Message)` Một mảng thông báo hiển thị trong ứng dụng. Tất cả người dùng của đối tượng này sẽ nhận được thông báo liên quan. Số lượng tối đa các trường này là 10.
`allowMultipleUsersPerObject (deprecated)`	`boolean` Mục này không được dùng nữa! Không dùng nữa. Thay vào đó, hãy sử dụng `multipleDevicesAndHoldersAllowedStatus`.
`homepageUri`	`object (Uri)` URI trang chủ ứng dụng của bạn. Việc điền URI vào trường này sẽ dẫn đến hành vi giống hệt như khi điền URI vào linksModuleData (khi một đối tượng được hiển thị, một đường liên kết đến trang chủ sẽ xuất hiện trong phần thường được coi là phần linksModuleData của đối tượng).
`locations[] (deprecated)`	`object (LatLongPoint)` Mục này không được dùng nữa! Lưu ý: Trường này hiện không được hỗ trợ để kích hoạt thông báo theo vị trí.
`reviewStatus`	`enum (ReviewStatus)` Bắt buộc. Trạng thái của lớp học. Bạn có thể đặt trường này thành `draft` hoặc `underReview` bằng cách sử dụng lệnh gọi API chèn, vá hoặc cập nhật. Khi đã thay đổi trạng thái xem xét từ `draft`, bạn sẽ không thể khôi phục trạng thái đó về `draft`. Bạn nên giữ trường này thành `draft` khi lớp đang trong quá trình phát triển. Không thể dùng lớp `draft` để tạo đối tượng nào. Bạn nên thiết lập trường này thành `underReview` khi cho rằng lớp đã sẵn sàng để sử dụng. Nền tảng sẽ tự động đặt trường này thành `approved` và trường này có thể được dùng ngay để tạo hoặc di chuyển đối tượng. Khi cập nhật một lớp đã có `approved`, bạn nên tiếp tục thiết lập trường này thành `underReview`.
`review`	`object (Review)` Các bình luận đánh giá do nền tảng đặt khi một lớp được đánh dấu là `approved` hoặc `rejected`.
`infoModuleData (deprecated)`	`object (InfoModuleData)` Mục này không được dùng nữa! Không dùng nữa. Thay vào đó, hãy sử dụng textModulesData.
`imageModulesData[]`	`object (ImageModuleData)` Dữ liệu mô-đun hình ảnh. Số lượng trường tối đa được hiển thị là 1 trường ở cấp đối tượng và 1 trường ở cấp đối tượng lớp.
`textModulesData[]`	`object (TextModuleData)` Dữ liệu mô-đun văn bản. Nếu dữ liệu mô-đun văn bản cũng được xác định trên lớp, thì cả hai sẽ hiển thị. Số lượng tối đa của các trường này hiển thị là 10 từ đối tượng và 10 từ lớp.
`linksModuleData`	`object (LinksModuleData)` Liên kết dữ liệu mô-đun. Nếu dữ liệu mô-đun liên kết cũng được xác định trên đối tượng, thì cả hai đều sẽ hiển thị.
`redemptionIssuers[]`	`string (int64 format)` Xác định tổ chức phát hành thẻ đổi thưởng có thể sử dụng thẻ/vé qua tính năng Chạm thông minh. Công ty phát hành chương trình đổi thưởng được xác định theo mã tổ chức phát hành của họ. Tổ chức phát hành ưu đãi phải thiết lập ít nhất một khoá Chạm thông minh. Bạn cũng phải thiết lập đúng cách các trường `enableSmartTap` và `smartTapRedemptionLevel` ở cấp đối tượng để thẻ/vé hỗ trợ tính năng Chạm thông minh.
`countryCode`	`string` Mã quốc gia dùng để hiển thị quốc gia của thẻ (khi người dùng không ở quốc gia đó), cũng như để hiển thị nội dung được bản địa hoá khi không có nội dung bằng ngôn ngữ của người dùng.
`heroImage`	`object (Image)` Ảnh biểu ngữ không bắt buộc xuất hiện ở mặt trước của thẻ. Nếu không có dải ô, thì sẽ không có tệp nào hiển thị. Hình ảnh sẽ hiển thị ở chiều rộng 100%.
`wordMark (deprecated)`	`object (Image)` Mục này không còn được dùng nữa! Không dùng nữa.
`enableSmartTap`	`boolean` Xác định xem lớp này có hỗ trợ tính năng Nhấn thông minh hay không. Bạn cũng phải thiết lập đúng cách các trường `redemptionIssuers` và `smartTapRedemptionLevel` ở cấp đối tượng để thẻ/vé hỗ trợ tính năng Chạm thông minh.
`hexBackgroundColor`	`string` Màu nền cho thẻ. Nếu bạn không đặt màu chủ đạo của hình ảnh chính, và nếu bạn không đặt hình ảnh chính, thì màu chủ đạo của biểu trưng sẽ được sử dụng. Định dạng là #`rrggbb`, trong đó `rrggbb` là bộ ba màu thập lục phân RGB, chẳng hạn như `#ffcc00`. Bạn cũng có thể sử dụng phiên bản viết tắt của bộ ba RGB là #`rgb`, chẳng hạn như `#fc0`.
`localizedIssuerName`	`object (LocalizedString)` Các chuỗi đã được dịch choNhà phát hànhName. Độ dài tối đa được đề xuất là 20 ký tự để đảm bảo chuỗi đầy đủ hiển thị trên các màn hình nhỏ hơn.
`multipleDevicesAndHoldersAllowedStatus`	`enum (MultipleDevicesAndHoldersAllowedStatus)` Xác định xem nhiều người dùng và thiết bị có lưu cùng một đối tượng tham chiếu đến lớp này hay không.
`callbackOptions`	`object (CallbackOptions)` Các tuỳ chọn gọi lại được dùng để gọi lại công ty phát hành cho mỗi lần người dùng cuối lưu/xoá một đối tượng cho lớp này. Tất cả đối tượng của lớp này đều đủ điều kiện để gọi lại.
`securityAnimation`	`object (SecurityAnimation)` Thông tin không bắt buộc về ảnh động bảo mật. Nếu bạn đặt giá trị này, ảnh động bảo mật sẽ hiển thị trên thông tin chi tiết của thẻ và vé.
`activationOptions`	`object (ActivationOptions)` Các tuỳ chọn kích hoạt cho một phiếu yêu cầu hỗ trợ.
`viewUnlockRequirement`	`enum (ViewUnlockRequirement)` Xem các lựa chọn về Yêu cầu mở khoá cho vé phương tiện công cộng.
`wideLogo`	`object (Image)` Biểu trưng dạng ngang của vé. Khi được cung cấp, tên này sẽ được sử dụng thay cho biểu trưng ở phía trên cùng bên trái của chế độ xem thẻ.
`notifyPreference`	`enum (NotificationSettingsForUpdates)` Liệu nội dung cập nhật trường đối với lớp này có kích hoạt thông báo hay không. Khi được đặt thành NOTIFY, chúng tôi sẽ cố gắng kích hoạt thông báo cập nhật trường cho người dùng. Chúng tôi sẽ chỉ gửi các thông báo này cho người dùng nếu trường này nằm trong danh sách cho phép. Nếu được đặt thành DO_NOT_chẳng hạn, thì sẽ không có thông báo nào được kích hoạt. Chế độ cài đặt này là tạm thời và cần được thiết lập cho từng yêu cầu PATCH hoặc UPDATE, nếu không, thông báo sẽ không được kích hoạt.
`appLinkData`	`object (AppLinkData)` Đường liên kết đến ứng dụng hoặc trang web (không bắt buộc) sẽ hiển thị dưới dạng nút ở mặt trước của thẻ và vé. Nếu AppLinkData được cung cấp cho đối tượng tương ứng sẽ được dùng để thay thế.
`valueAddedModuleData[]`	`object (ValueAddedModuleData)` Dữ liệu mô-đun giá trị gia tăng không bắt buộc. Tối đa 10 người trong lớp. Đối với một thẻ và vé, chỉ 10 thẻ và vé sẽ hiển thị, ưu tiên những thẻ và vé từ đối tượng.

TransitType

Enum
`TRANSIT_TYPE_UNSPECIFIED`
`BUS`
`bus`	Bí danh cũ của `BUS`. Không dùng nữa. Mục này không còn được dùng nữa!
`RAIL`
`rail`	Bí danh cũ của `RAIL`. Không dùng nữa. Mục này không được dùng nữa!
`TRAM`
`tram`	Bí danh cũ của `TRAM`. Không dùng nữa. Mục này không được dùng nữa!
`FERRY`
`ferry`	Bí danh cũ của `FERRY`. Không dùng nữa. Mục này không được dùng nữa!
`OTHER`
`other`	Bí danh cũ của `OTHER`. Không dùng nữa. Mục này không được dùng nữa!

ActivationOptions

TriggerOptions cho lớp

Biểu diễn dưới dạng JSON
{ "activationUrl": string, "allowReactivation": boolean }

Trường

Trường
`activationUrl`	`string` URL HTTPS có hỗ trợ ngữ nghĩa REST. Sẽ được dùng để yêu cầu đối tác kích hoạt một giá trị nhất định do người dùng kích hoạt.
`allowReactivation`	`boolean` Cờ để cho phép người dùng thực hiện cuộc gọi kích hoạt từ nhiều thiết bị. Điều này cho phép ứng dụng hiển thị nút kích hoạt đã bật ngay cả khi kích hoạtStatus được ACTIVED (KÍCH HOẠT) nhưng thiết bị được yêu cầu khác với thiết bị hiện tại.

activationUrl

string

URL HTTPS có hỗ trợ ngữ nghĩa REST. Sẽ được dùng để yêu cầu đối tác kích hoạt một giá trị nhất định do người dùng kích hoạt.

allowReactivation

boolean

Cờ để cho phép người dùng thực hiện cuộc gọi kích hoạt từ nhiều thiết bị. Điều này cho phép ứng dụng hiển thị nút kích hoạt đã bật ngay cả khi kích hoạtStatus được ACTIVED (KÍCH HOẠT) nhưng thiết bị được yêu cầu khác với thiết bị hiện tại.

Phương thức
`addmessage`	Thêm thông báo vào lớp phương tiện công cộng được tham chiếu bằng mã lớp đã cho.
`get`	Trả về lớp phương tiện công cộng có mã lớp đã cho.
`insert`	Chèn một lớp phương tiện công cộng có mã nhận dạng và thuộc tính đã cho.
`list`	Trả về danh sách tất cả các hạng phương tiện công cộng cho một mã tổ chức phát hành cụ thể.
`patch`	Cập nhật lớp phương tiện công cộng được tham chiếu theo mã lớp đã cho.
`update`	Cập nhật lớp phương tiện công cộng được tham chiếu theo mã lớp đã cho.

REST Resource: transitclass

Tài nguyên: TransitClass

TransitType

ActivationOptions

Phương thức

`addmessage`

`get`

`insert`

`list`

`patch`

`update`