Công cụ: list_pass_classes
Truy xuất danh sách đầy đủ tất cả các lớp thẻ và vé đã đăng ký trong bảng điều khiển doanh nghiệp Google Wallet được liên kết với người dùng đã xác thực. Công cụ này cung cấp thông tin cần thiết cho những nhà phát triển quản lý thẻ và vé trong Wallet, chẳng hạn như thẻ khách hàng thân thiết, thẻ quà tặng hoặc vé máy bay.
Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ list_pass_classes MCP.
| Yêu cầu Curl |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "list_pass_classes", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Giản đồ đầu vào
Thông báo yêu cầu liệt kê các lớp thẻ của một tổ chức phát hành.
ListPassClassesRequest
| Biểu diễn dưới dạng JSON |
|---|
{ "issuerId": string, "passType": enum ( |
| Trường | |
|---|---|
issuerId |
Bắt buộc. Giá trị nhận dạng riêng biệt của tổ chức phát hành mà bạn muốn liệt kê các lớp thẻ và vé. |
passType |
Không bắt buộc. Loại lớp thẻ và vé cần liệt kê. Nếu bạn không chỉ định, tất cả các loại thẻ và vé sẽ được trả về. |
view |
Không bắt buộc. Chỉ định mức độ chi tiết sẽ được trả về cho từng lớp thẻ và vé. |
Giản đồ đầu ra
Thông báo phản hồi cho việc liệt kê các lớp thẻ và vé của một tổ chức phát hành.
ListPassClassesResponse
| Biểu diễn dưới dạng JSON |
|---|
{
"passClasses": [
{
object ( |
| Trường | |
|---|---|
passClasses[] |
Các lớp thẻ và vé của công ty phát hành. |
PassClass
| Biểu diễn dưới dạng JSON |
|---|
{ // Union field |
| Trường | |
|---|---|
Trường nhóm
|
|
loyaltyClass |
Không bắt buộc. Hạng khách hàng thân thiết của tổ chức phát hành. |
giftCardClass |
Không bắt buộc. Loại thẻ quà tặng của tổ chức phát hành. |
offerClass |
Không bắt buộc. Loại ưu đãi của tổ chức phát hành. |
eventTicketClass |
Không bắt buộc. Lớp vé xem sự kiện của tổ chức phát hành. |
flightClass |
Không bắt buộc. Hạng chuyến bay của hãng phát hành. |
transitClass |
Không bắt buộc. Loại phương tiện công cộng của tổ chức phát hành. |
genericClass |
Không bắt buộc. Lớp chung của tổ chức phát hành. |
LoyaltyClass
| Biểu diễn dưới dạng JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Trường | |
|---|---|
id |
Không bắt buộc. Mã nhận dạng của thẻ khách hàng thân thiết. |
issuerName |
Không bắt buộc. Tên tổ chức phát hành của lớp khách hàng thân thiết. |
localizedIssuerName |
Không bắt buộc. Tên tổ chức phát hành đã bản địa hoá của thẻ khách hàng thân thiết. |
programName |
Không bắt buộc. Tên chương trình của lớp khách hàng thân thiết. |
localizedProgramName |
Không bắt buộc. Tên chương trình đã bản địa hoá của hạng khách hàng thân thiết. |
programLogoUri |
Không bắt buộc. Biểu trưng chương trình của lớp khách hàng thân thiết. |
hexBackgroundColor |
Không bắt buộc. Màu nền của thẻ khách hàng thân thiết. Định dạng là một chuỗi màu thập lục phân, ví dụ: "#RRGGBB". |
heroImageUri |
Không bắt buộc. Hình ảnh biểu ngữ xuất hiện ở mặt trước của thẻ khách hàng thân thiết. |
discoverableProgram |
Không bắt buộc. Thông tin về cách lớp khách hàng thân thiết có thể được phát hiện và khởi tạo trong Google Wallet. |
classTemplateInfo |
Không bắt buộc. Thông tin mẫu về cách hiển thị loại khách hàng thân thiết. |
LocalizedString
| Biểu diễn dưới dạng JSON |
|---|
{ "translatedValues": [ { object ( |
| Trường | |
|---|---|
translatedValues[] |
Không bắt buộc. Chuỗi đã dịch cho chuỗi. |
defaultValue |
Không bắt buộc. Chuỗi sẽ hiển thị nếu không có bản dịch phù hợp. |
TranslatedString
| Biểu diễn dưới dạng JSON |
|---|
{ "languageCode": string, "value": string } |
| Trường | |
|---|---|
languageCode |
Không bắt buộc. Thẻ ngôn ngữ BCP 47. Các giá trị mẫu là "en-US", "en-GB", "de" hoặc "de-AT". |
value |
Không bắt buộc. Chuỗi đã dịch được mã hoá bằng UTF-8. |
DiscoverableProgram
| Biểu diễn dưới dạng JSON |
|---|
{ "merchantSignupInfo": { object ( |
| Trường | |
|---|---|
merchantSignupInfo |
Không bắt buộc. Thông tin về khả năng đăng ký và thêm thông tin có giá trị cho chương trình có tiềm năng được khám phá này thông qua trang web của người bán. |
merchantSigninInfo |
Không bắt buộc. Thông tin về khả năng đăng nhập và thêm một thông tin có giá trị cho chương trình có thể khám phá này thông qua một trang web của người bán. |
state |
Chỉ có đầu ra. Trạng thái của chương trình có thể phát hiện. |
MerchantSignupInfo
| Biểu diễn dưới dạng JSON |
|---|
{ "signupWebsite": { object ( |
| Trường | |
|---|---|
signupWebsite |
Không bắt buộc. Trang web để đăng ký chương trình có thể phát hiện. |
signupSharedDatas[] |
Không bắt buộc. Dữ liệu người dùng được gửi trong yêu cầu POST đến URL trang web đăng ký. Thông tin này được mã hoá rồi chia sẻ để trang web của người bán có thể điền sẵn các trường dùng để đăng ký người dùng cho chương trình có thể khám phá. |
URI
| Biểu diễn dưới dạng JSON |
|---|
{
"uri": string,
"description": string,
"localizedDescription": {
object ( |
| Trường | |
|---|---|
uri |
Không bắt buộc. URI. |
description |
Không bắt buộc. Tiêu đề của URI xuất hiện trong Google Wallet dưới dạng văn bản. |
localizedDescription |
Không bắt buộc. Các chuỗi đã dịch của tiêu đề URI xuất hiện trong Google Wallet dưới dạng văn bản. |
MerchantSigninInfo
| Biểu diễn dưới dạng JSON |
|---|
{
"signinWebsite": {
object ( |
| Trường | |
|---|---|
signinWebsite |
Không bắt buộc. Trang web để đăng nhập vào chương trình có thể phát hiện. |
ClassTemplateInfo
| Biểu diễn dưới dạng JSON |
|---|
{ "cardBarcodeSectionDetails": { object ( |
| Trường | |
|---|---|
cardBarcodeSectionDetails |
Không bắt buộc. Thông tin bổ sung sẽ xuất hiện ở phía trên và phía dưới mã vạch. |
cardTemplateOverride |
Không bắt buộc. Mẫu ghi đè cho chế độ xem thẻ. |
detailsTemplateOverride |
Không bắt buộc. Mẫu ghi đè cho chế độ xem chi tiết. |
listTemplateOverride |
Không bắt buộc. Mẫu ghi đè cho chế độ xem danh sách thẻ và vé. |
CardBarcodeSectionDetails
| Biểu diễn dưới dạng JSON |
|---|
{ "firstTopDetail": { object ( |
| Trường | |
|---|---|
firstTopDetail |
Không bắt buộc. Thông tin không bắt buộc sẽ xuất hiện phía trên mã vạch. Nếu secondTopDetail được xác định, thì thông tin này sẽ xuất hiện ở phía bắt đầu của phần chi tiết này. |
firstBottomDetail |
Không bắt buộc. Thông tin không bắt buộc sẽ xuất hiện bên dưới mã vạch. |
secondTopDetail |
Không bắt buộc. Thông tin thứ hai không bắt buộc sẽ xuất hiện phía trên mã vạch. Nếu firstTopDetail được xác định, thì thông tin này sẽ xuất hiện ở phía cuối của phần chi tiết này. |
BarcodeSectionDetail
| Biểu diễn dưới dạng JSON |
|---|
{
"fieldSelector": {
object ( |
| Trường | |
|---|---|
fieldSelector |
Không bắt buộc. Tham chiếu đến một trường văn bản hoặc hình ảnh hiện có sẽ được hiển thị. |
FieldSelector
| Biểu diễn dưới dạng JSON |
|---|
{
"fields": [
{
object ( |
| Trường | |
|---|---|
fields[] |
Không bắt buộc. Các tham chiếu trường để sử dụng với các chế độ ghi đè trường. Nếu bạn cung cấp nhiều giá trị tham chiếu, thì giá trị tham chiếu đầu tiên tham chiếu đến một trường không trống sẽ xuất hiện. |
FieldReference
| Biểu diễn dưới dạng JSON |
|---|
{
"fieldPath": string,
"dateFormat": enum ( |
| Trường | |
|---|---|
fieldPath |
Không bắt buộc. Đường dẫn đến trường được tham chiếu, bắt đầu bằng "object" hoặc "class" và được phân tách bằng dấu chấm. |
dateFormat |
Không bắt buộc. Định dạng ngày để hiển thị các trường ngày/giờ. |
CardTemplateOverride
| Biểu diễn dưới dạng JSON |
|---|
{
"cardRowTemplateInfos": [
{
object ( |
| Trường | |
|---|---|
cardRowTemplateInfos[] |
Không bắt buộc. Thông tin mẫu về các hàng trong chế độ xem thẻ. Bạn chỉ được phép chỉ định tối đa 3 hàng. |
CardRowTemplateInfo
| Biểu diễn dưới dạng JSON |
|---|
{ // Union field |
| Trường | |
|---|---|
Trường nhóm row_template. Mẫu cho một hàng chứa một, hai hoặc ba mặt hàng. row_template chỉ có thể là một trong những trạng thái sau: |
|
oneItem |
Không bắt buộc. Mẫu cho một hàng chứa một mục. |
twoItems |
Không bắt buộc. Mẫu cho một hàng chứa 2 mục. |
threeItems |
Không bắt buộc. Mẫu cho một hàng chứa 3 mục. |
CardRowOneItem
| Biểu diễn dưới dạng JSON |
|---|
{
"item": {
object ( |
| Trường | |
|---|---|
item |
Không bắt buộc. Mục sẽ xuất hiện trong hàng. Mục này sẽ được căn giữa. |
TemplateItem
| Biểu diễn dưới dạng JSON |
|---|
{ "firstValue": { object ( |
| Trường | |
|---|---|
firstValue |
Không bắt buộc. Tham chiếu đến trường đầu tiên sẽ được hiển thị. |
secondValue |
Không bắt buộc. Tham chiếu đến trường thứ hai sẽ được hiển thị. |
predefinedItem |
Không bắt buộc. Mục được xác định trước sẽ xuất hiện. |
CardRowTwoItems
| Biểu diễn dưới dạng JSON |
|---|
{ "startItem": { object ( |
| Trường | |
|---|---|
startItem |
Không bắt buộc. Mục sẽ xuất hiện ở đầu hàng. Mục này sẽ được căn chỉnh sang trái. |
endItem |
Không bắt buộc. Mục sẽ xuất hiện ở cuối hàng. Mục này sẽ được căn chỉnh sang phải. |
CardRowThreeItems
| Biểu diễn dưới dạng JSON |
|---|
{ "startItem": { object ( |
| Trường | |
|---|---|
startItem |
Không bắt buộc. Mục sẽ xuất hiện ở đầu hàng. Mục này sẽ được căn chỉnh sang trái. |
middleItem |
Không bắt buộc. Mục sẽ xuất hiện ở giữa hàng. Mục này sẽ được căn giữa giữa mục bắt đầu và mục kết thúc. |
endItem |
Không bắt buộc. Mục sẽ xuất hiện ở cuối hàng. Mục này sẽ được căn chỉnh sang phải. |
DetailsTemplateOverride
| Biểu diễn dưới dạng JSON |
|---|
{
"detailsItemInfos": [
{
object ( |
| Trường | |
|---|---|
detailsItemInfos[] |
Không bắt buộc. Thông tin mẫu về các mục xuất hiện trong danh sách chi tiết. |
DetailsItemInfo
| Biểu diễn dưới dạng JSON |
|---|
{
"item": {
object ( |
| Trường | |
|---|---|
item |
Không bắt buộc. Mục sẽ xuất hiện trong danh sách chi tiết. |
ListTemplateOverride
| Biểu diễn dưới dạng JSON |
|---|
{ "firstRowOption": { object ( |
| Trường | |
|---|---|
firstRowOption |
Không bắt buộc. Tham chiếu đến trường sẽ xuất hiện ở hàng đầu tiên. |
secondRowOption |
Không bắt buộc. Tham chiếu đến trường sẽ xuất hiện ở hàng thứ hai. |
FirstRowOption
| Biểu diễn dưới dạng JSON |
|---|
{ "transitOption": enum ( |
| Trường | |
|---|---|
transitOption |
Không bắt buộc. Lựa chọn phương tiện công cộng sẽ xuất hiện ở hàng đầu tiên. |
fieldOption |
Không bắt buộc. Tham chiếu đến trường sẽ xuất hiện ở hàng đầu tiên. |
GiftCardClass
| Biểu diễn dưới dạng JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Trường | |
|---|---|
id |
Không bắt buộc. Mã nhận dạng của lớp thẻ quà tặng. |
issuerName |
Không bắt buộc. Tên của công ty phát hành lớp thẻ quà tặng. |
localizedIssuerName |
Không bắt buộc. Tên nhà phát hành đã bản địa hoá của lớp thẻ quà tặng. |
merchantName |
Không bắt buộc. Tên người bán của lớp thẻ quà tặng. |
localizedMerchantName |
Không bắt buộc. Tên người bán đã bản địa hoá của lớp thẻ quà tặng. |
programLogoUri |
Không bắt buộc. Biểu trưng chương trình của loại thẻ quà tặng. |
hexBackgroundColor |
Không bắt buộc. Màu nền của lớp thẻ quà tặng. Định dạng là một chuỗi màu hệ thập lục phân, ví dụ: "#RRGGBB". |
heroImageUri |
Không bắt buộc. Hình ảnh biểu ngữ xuất hiện ở mặt trước của thẻ quà tặng. |
homePageUri |
Không bắt buộc. Trang web của trang chủ ứng dụng. |
classTemplateInfo |
Không bắt buộc. Thông tin mẫu về cách hiển thị lớp thẻ quà tặng. |
OfferClass
| Biểu diễn dưới dạng JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Trường | |
|---|---|
id |
Không bắt buộc. Mã nhận dạng của lớp ưu đãi. |
issuerName |
Không bắt buộc. Tên của tổ chức phát hành lớp ưu đãi. |
localizedIssuerName |
Không bắt buộc. Tên tổ chức phát hành đã bản địa hoá của lớp ưu đãi. |
provider |
Không bắt buộc. Nhà cung cấp của lớp ưu đãi. |
localizedProvider |
Không bắt buộc. Nhà cung cấp được bản địa hoá của lớp ưu đãi. |
title |
Không bắt buộc. Tiêu đề của lớp ưu đãi. |
localizedTitle |
Không bắt buộc. Tiêu đề đã bản địa hoá của lớp ưu đãi. |
titleImageUri |
Không bắt buộc. Hình ảnh tiêu đề của lớp ưu đãi. |
hexBackgroundColor |
Không bắt buộc. Màu nền của lớp ưu đãi. Định dạng là một chuỗi màu hệ thập lục phân, ví dụ: "#RRGGBB". |
heroImageUri |
Không bắt buộc. Hình ảnh biểu ngữ xuất hiện ở mặt trước của lớp ưu đãi. |
redemptionChannel |
Không bắt buộc. Kênh sử dụng của lớp ưu đãi. |
classTemplateInfo |
Không bắt buộc. Thông tin mẫu về cách hiển thị lớp ưu đãi. |
EventTicketClass
| Biểu diễn dưới dạng JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Trường | |
|---|---|
id |
Không bắt buộc. Mã của lớp vé xem sự kiện. |
issuerName |
Không bắt buộc. Tên đơn vị phát hành của lớp vé xem sự kiện. |
localizedIssuerName |
Không bắt buộc. Tên đơn vị phát hành đã bản địa hoá của lớp vé xem sự kiện. |
logoUri |
Không bắt buộc. Biểu trưng của lớp vé xem sự kiện. |
eventName |
Không bắt buộc. Tên của sự kiện. |
venue |
Không bắt buộc. Địa điểm diễn ra sự kiện. |
dateTime |
Không bắt buộc. Thông tin về ngày và giờ diễn ra sự kiện. |
hexBackgroundColor |
Không bắt buộc. Màu nền của lớp vé xem sự kiện. Định dạng là một chuỗi màu hệ thập lục phân, ví dụ: "#RRGGBB". |
heroImageUri |
Không bắt buộc. Hình ảnh biểu ngữ xuất hiện ở mặt trước của vé xem sự kiện. |
classTemplateInfo |
Không bắt buộc. Thông tin về mẫu cho biết cách hiển thị lớp vé xem sự kiện. |
EventVenue
| Biểu diễn dưới dạng JSON |
|---|
{ "name": { object ( |
| Trường | |
|---|---|
name |
Không bắt buộc. Tên của địa điểm. |
address |
Không bắt buộc. Địa chỉ của địa điểm tổ chức sự kiện. |
EventDateTime
| Biểu diễn dưới dạng JSON |
|---|
{ "start": string, "end": string } |
| Trường | |
|---|---|
start |
Không bắt buộc. Ngày/giờ bắt đầu sự kiện. Nếu sự kiện diễn ra trong nhiều ngày, thì đó phải là ngày/giờ bắt đầu vào ngày đầu tiên. Định dạng này là ngày/giờ ở định dạng mở rộng ISO 8601 mà không có độ lệch, và thời gian có thể được chỉ định với độ chính xác lên đến mili giây, ví dụ: 2027-03-05T06:30:00. |
end |
Không bắt buộc. Ngày/giờ kết thúc sự kiện. Nếu sự kiện diễn ra trong nhiều ngày, thì đó phải là ngày/giờ kết thúc vào ngày cuối cùng. Định dạng này là ngày/giờ ở định dạng mở rộng ISO 8601 mà không có độ lệch, và thời gian có thể được chỉ định với độ chính xác lên đến mili giây, ví dụ: 2027-03-05T06:30:00. |
FlightClass
| Biểu diễn dưới dạng JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Trường | |
|---|---|
id |
Không bắt buộc. Mã nhận dạng của hạng đặt chỗ. |
issuerName |
Không bắt buộc. Tên tổ chức phát hành của lớp chuyến bay. |
localizedIssuerName |
Không bắt buộc. Tên tổ chức phát hành đã bản địa hoá của lớp chuyến bay. |
flightHeader |
Không bắt buộc. Thông tin về hãng hàng không và số chuyến bay. |
origin |
Không bắt buộc. Thông tin về sân bay khởi hành. |
destination |
Không bắt buộc. Thông tin về sân bay đến. |
localScheduledDepartureDateTime |
Không bắt buộc. Ngày và giờ theo lịch trình mà máy bay dự kiến khởi hành từ cửa (không phải đường băng). Định dạng này là ngày/giờ ở định dạng mở rộng ISO 8601 mà không có độ lệch, và thời gian có thể được chỉ định với độ chính xác lên đến mili giây, ví dụ: 2027-03-05T06:30:00. Đây phải là ngày/giờ địa phương tại sân bay (không phải giờ UTC). |
hexBackgroundColor |
Không bắt buộc. Màu nền của hạng vé máy bay. Định dạng là một chuỗi màu hệ thập lục phân, ví dụ: "#RRGGBB". |
heroImageUri |
Không bắt buộc. Hình ảnh biểu ngữ xuất hiện ở mặt trước của lớp học về chuyến bay. |
classTemplateInfo |
Không bắt buộc. Thông tin mẫu về cách hiển thị hạng vé máy bay. |
FlightHeader
| Biểu diễn dưới dạng JSON |
|---|
{
"carrier": {
object ( |
| Trường | |
|---|---|
carrier |
Không bắt buộc. Thông tin về hãng hàng không. |
flightNumber |
Không bắt buộc. Số hiệu chuyến bay không có mã IATA của hãng hàng không. Trường này chỉ chứa các chữ số, ví dụ: "123". |
FlightCarrier
| Biểu diễn dưới dạng JSON |
|---|
{ "carrierIataCode": string, "carrierIcaoCode": string, "airlineLogoUri": string } |
| Trường | |
|---|---|
carrierIataCode |
Không bắt buộc. Mã IATA gồm 2 ký tự của hãng hàng không. |
carrierIcaoCode |
Không bắt buộc. Mã hãng hàng không gồm 3 ký tự theo ICAO của hãng vận chuyển. |
airlineLogoUri |
Không bắt buộc. Biểu trưng của hãng hàng không được mô tả bằng mã IATA của hãng vận chuyển. |
AirportInfo
| Biểu diễn dưới dạng JSON |
|---|
{ "airportIataCode": string, "terminal": string, "gate": string } |
| Trường | |
|---|---|
airportIataCode |
Không bắt buộc. Mã sân bay gồm 3 ký tự theo IATA, ví dụ: "SFO". |
terminal |
Không bắt buộc. Tên thiết bị đầu cuối, ví dụ: "I". |
gate |
Không bắt buộc. Tên cổng, ví dụ: "B59". |
TransitClass
| Biểu diễn dưới dạng JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Trường | |
|---|---|
id |
Không bắt buộc. Mã nhận dạng của loại phương tiện công cộng. |
issuerName |
Không bắt buộc. Tên đơn vị phát hành của thẻ phương tiện công cộng. |
localizedIssuerName |
Không bắt buộc. Tên tổ chức phát hành đã bản địa hoá của thẻ đi phương tiện công cộng. |
hexBackgroundColor |
Không bắt buộc. Màu nền của thẻ phương tiện công cộng. Định dạng là một chuỗi màu hệ thập lục phân, ví dụ: "#RRGGBB". |
heroImageUri |
Không bắt buộc. Hình ảnh biểu ngữ xuất hiện ở mặt trước của thẻ phương tiện công cộng. |
transitType |
Không bắt buộc. Loại phương tiện công cộng của lớp phương tiện công cộng. |
classTemplateInfo |
Không bắt buộc. Thông tin mẫu về cách hiển thị lớp phương tiện công cộng. |
GenericClass
| Biểu diễn dưới dạng JSON |
|---|
{
"id": string,
"classTemplateInfo": {
object ( |
| Trường | |
|---|---|
id |
Không bắt buộc. Mã nhận dạng của lớp chung. |
classTemplateInfo |
Không bắt buộc. Thông tin mẫu về cách hiển thị lớp chung. |
Chú giải công cụ
Gợi ý mang tính phá hoại: ❌ | Gợi ý mang tính luỹ đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌