工具:list_pass_classes
擷取與已驗證使用者相關聯的 Google 錢包商家控制台中,註冊的所有票證類別完整清單。這項工具可為管理會員卡、禮物卡或航班等 Google 錢包票證的開發人員,提供重要資訊。
以下範例示範如何使用 curl 叫用 list_pass_classes MCP 工具。
| 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 }' |
輸入內容的結構定義
要求訊息,列出發卡機構的票證類別。
ListPassClassesRequest
| JSON 表示法 |
|---|
{ "issuerId": string, "passType": enum ( |
| 欄位 | |
|---|---|
issuerId |
必填。要列出票證類別的發卡機構專屬 ID。 |
passType |
(選用步驟) 要列出的票證類別。如未指定,系統會傳回所有類型的票證類別。 |
view |
(選用步驟) 指定要為每個票證類別傳回的詳細資料層級。 |
輸出內容的結構定義
列出核發機構票證類別的回應訊息。
ListPassClassesResponse
| JSON 表示法 |
|---|
{
"passClasses": [
{
object ( |
| 欄位 | |
|---|---|
passClasses[] |
發卡機構的票證類別。 |
PassClass
| JSON 表示法 |
|---|
{ // Union field |
| 欄位 | |
|---|---|
聯集欄位
|
|
loyaltyClass |
(選用步驟) 核發機構的會員類別。 |
giftCardClass |
(選用步驟) 發卡機構的儲值卡類別。 |
offerClass |
(選用步驟) 發卡機構的優惠類別。 |
eventTicketClass |
(選用步驟) 發卡機構的活動票券類別。 |
flightClass |
(選用步驟) 發卡機構的航班艙等。 |
transitClass |
(選用步驟) 發卡機構的交通運輸類別。 |
genericClass |
(選用步驟) 發卡機構的泛型類別。 |
LoyaltyClass
| JSON 表示法 |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| 欄位 | |
|---|---|
id |
(選用步驟) 會員類別的 ID。 |
issuerName |
(選用步驟) 會員類別的發卡機構名稱。 |
localizedIssuerName |
(選用步驟) 會員等級的本地化發卡機構名稱。 |
programName |
(選用步驟) 會員類別的方案名稱。 |
localizedProgramName |
(選用步驟) 會員等級的本地化方案名稱。 |
programLogoUri |
(選用步驟) 會員等級的方案標誌。 |
hexBackgroundColor |
(選用步驟) 會員等級的背景顏色。格式為十六進位顏色字串,例如「#RRGGBB」。 |
heroImageUri |
(選用步驟) 顯示在會員卡正面的橫幅圖片。 |
discoverableProgram |
(選用步驟) 如何在 Google 錢包中探索會員類別及將類別例項化的相關資訊。 |
classTemplateInfo |
(選用步驟) 會員類別的顯示方式範本資訊。 |
LocalizedString
| JSON 表示法 |
|---|
{ "translatedValues": [ { object ( |
| 欄位 | |
|---|---|
translatedValues[] |
(選用步驟) 字串的翻譯字串。 |
defaultValue |
(選用步驟) 沒有適當翻譯時顯示的字串。 |
TranslatedString
| JSON 表示法 |
|---|
{ "languageCode": string, "value": string } |
| 欄位 | |
|---|---|
languageCode |
(選用步驟) BCP 47 語言標記。範例值:「en-US」、「en-GB」、「de」或「de-AT」。 |
value |
(選用步驟) 採 UTF-8 編碼的翻譯字串。 |
DiscoverableProgram
| JSON 表示法 |
|---|
{ "merchantSignupInfo": { object ( |
| 欄位 | |
|---|---|
merchantSignupInfo |
(選用步驟) 透過商家網站註冊這項可探索方案並為該方案新增有價值項目之功能的相關資訊。 |
merchantSigninInfo |
(選用步驟) 有關如何登入以及透過商家網站為該可探索方案加值的相關資訊。 |
state |
僅供輸出。可探索方案的狀態。 |
MerchantSignupInfo
| JSON 表示法 |
|---|
{ "signupWebsite": { object ( |
| 欄位 | |
|---|---|
signupWebsite |
(選用步驟) 可探索方案的註冊網站。 |
signupSharedDatas[] |
(選用步驟) 在 POST 要求中傳送至註冊網站網址的使用者資料。這項資訊會先經過編碼再共用,因此商家網站可以預先填入欄位,以便讓使用者註冊可供搜索的方案。 |
URI
| JSON 表示法 |
|---|
{
"uri": string,
"description": string,
"localizedDescription": {
object ( |
| 欄位 | |
|---|---|
uri |
(選用步驟) URI。 |
description |
(選用步驟) 在 Google 錢包中以文字顯示的 URI 標題。 |
localizedDescription |
(選用步驟) 在 Google 錢包中以文字顯示的 URI 標題譯文。 |
MerchantSigninInfo
| JSON 表示法 |
|---|
{
"signinWebsite": {
object ( |
| 欄位 | |
|---|---|
signinWebsite |
(選用步驟) 可探索方案的登入網站。 |
ClassTemplateInfo
| JSON 表示法 |
|---|
{ "cardBarcodeSectionDetails": { object ( |
| 欄位 | |
|---|---|
cardBarcodeSectionDetails |
(選用步驟) 顯示於條碼上方和下方的其他資訊。 |
cardTemplateOverride |
(選用步驟) 資訊卡檢視畫面的範本覆寫內容。 |
detailsTemplateOverride |
(選用步驟) 詳細資料檢視畫面的範本覆寫。 |
listTemplateOverride |
(選用步驟) 票證清單檢視畫面的範本覆寫內容。 |
CardBarcodeSectionDetails
| JSON 表示法 |
|---|
{ "firstTopDetail": { object ( |
| 欄位 | |
|---|---|
firstTopDetail |
(選用步驟) 要顯示於條碼上方的選擇性資訊。如已定義 secondTopDetail,這項資訊將會顯示在這個詳細資料區段的開頭。 |
firstBottomDetail |
(選用步驟) 要顯示於條碼下方的選擇性資訊。 |
secondTopDetail |
(選用步驟) 顯示於條碼上方的第二則選擇性資訊。如已定義 firstTopDetail,這項資訊將會顯示在這個詳細資料區段的結尾。 |
BarcodeSectionDetail
| JSON 表示法 |
|---|
{
"fieldSelector": {
object ( |
| 欄位 | |
|---|---|
fieldSelector |
(選用步驟) 要顯示的現有文字或圖片欄位參照。 |
FieldSelector
| JSON 表示法 |
|---|
{
"fields": [
{
object ( |
| 欄位 | |
|---|---|
fields[] |
(選用步驟) 用於欄位覆寫的欄位參照。如果提供多個參照,將顯示第一個參照非空白欄位的參照。 |
FieldReference
| JSON 表示法 |
|---|
{
"fieldPath": string,
"dateFormat": enum ( |
| 欄位 | |
|---|---|
fieldPath |
(選用步驟) 參照欄位的路徑,前面加上「object」或「class」,並以點號分隔。 |
dateFormat |
(選用步驟) 用於顯示日期/時間欄位的日期格式。 |
CardTemplateOverride
| JSON 表示法 |
|---|
{
"cardRowTemplateInfos": [
{
object ( |
| 欄位 | |
|---|---|
cardRowTemplateInfos[] |
(選用步驟) 資訊卡檢視畫面中的資料列範本資訊。最多只能指定三列。 |
CardRowTemplateInfo
| JSON 表示法 |
|---|
{ // Union field |
| 欄位 | |
|---|---|
聯集欄位 row_template。單一列包含一、二或三個項目的範本。row_template 只能是下列其中一項: |
|
oneItem |
(選用步驟) 單一列包含一個項目的範本。 |
twoItems |
(選用步驟) 單一列包含兩個項目的範本。 |
threeItems |
(選用步驟) 單一列包含三個項目的範本。 |
CardRowOneItem
| JSON 表示法 |
|---|
{
"item": {
object ( |
| 欄位 | |
|---|---|
item |
(選用步驟) 要在資料列中顯示的項目。此項目會置中。 |
TemplateItem
| JSON 表示法 |
|---|
{ "firstValue": { object ( |
| 欄位 | |
|---|---|
firstValue |
(選用步驟) 要顯示的第一個欄位參照。 |
secondValue |
(選用步驟) 要顯示的第二個欄位參照。 |
predefinedItem |
(選用步驟) 要顯示的預先定義項目。 |
CardRowTwoItems
| JSON 表示法 |
|---|
{ "startItem": { object ( |
| 欄位 | |
|---|---|
startItem |
(選用步驟) 要在資料列開頭顯示的項目。這個項目會靠左對齊。 |
endItem |
(選用步驟) 要顯示於資料列結尾的項目。這個項目會靠右對齊。 |
CardRowThreeItems
| JSON 表示法 |
|---|
{ "startItem": { object ( |
| 欄位 | |
|---|---|
startItem |
(選用步驟) 要在資料列開頭顯示的項目。這個項目會靠左對齊。 |
middleItem |
(選用步驟) 要顯示於資料列中間的項目。這個項目會置中放置在開始和結束項目之間。 |
endItem |
(選用步驟) 要顯示於資料列結尾的項目。這個項目會靠右對齊。 |
DetailsTemplateOverride
| JSON 表示法 |
|---|
{
"detailsItemInfos": [
{
object ( |
| 欄位 | |
|---|---|
detailsItemInfos[] |
(選用步驟) 詳細資料清單中顯示項目的範本資訊。 |
DetailsItemInfo
| JSON 表示法 |
|---|
{
"item": {
object ( |
| 欄位 | |
|---|---|
item |
(選用步驟) 要在詳細資料清單中顯示的項目。 |
ListTemplateOverride
| JSON 表示法 |
|---|
{ "firstRowOption": { object ( |
| 欄位 | |
|---|---|
firstRowOption |
(選用步驟) 要在第一列顯示的欄位參照。 |
secondRowOption |
(選用步驟) 要在第二列顯示的欄位參照。 |
FirstRowOption
| JSON 表示法 |
|---|
{ "transitOption": enum ( |
| 欄位 | |
|---|---|
transitOption |
(選用步驟) 要在第一列顯示的大眾運輸選項。 |
fieldOption |
(選用步驟) 要在第一列顯示的欄位參照。 |
GiftCardClass
| JSON 表示法 |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| 欄位 | |
|---|---|
id |
(選用步驟) 儲值卡類別的 ID。 |
issuerName |
(選用步驟) 儲值卡類別的核發機構名稱。 |
localizedIssuerName |
(選用步驟) 儲值卡類別的本地化發卡機構名稱。 |
merchantName |
(選用步驟) 禮物卡類別的商家名稱。 |
localizedMerchantName |
(選用步驟) 禮物卡類別的本地化商家名稱。 |
programLogoUri |
(選用步驟) 儲值卡類別的方案標誌。 |
hexBackgroundColor |
(選用步驟) 禮物卡類別的背景顏色。格式為十六進位顏色字串,例如「#RRGGBB」。 |
heroImageUri |
(選用步驟) 顯示在禮物卡類別正面的橫幅圖片。 |
homePageUri |
(選用步驟) 應用程式首頁的網站。 |
classTemplateInfo |
(選用步驟) 禮物卡類別的顯示方式範本資訊。 |
OfferClass
| JSON 表示法 |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| 欄位 | |
|---|---|
id |
(選用步驟) 優惠類別的 ID。 |
issuerName |
(選用步驟) 優惠類別的發卡機構名稱。 |
localizedIssuerName |
(選用步驟) 優惠類別的本地化發卡機構名稱。 |
provider |
(選用步驟) 優惠類別的供應商。 |
localizedProvider |
(選用步驟) 優惠類別的本地化供應商。 |
title |
(選用步驟) 優惠類別的標題。 |
localizedTitle |
(選用步驟) 優惠類別的本地化標題。 |
titleImageUri |
(選用步驟) 優惠類別的標題圖片。 |
hexBackgroundColor |
(選用步驟) 優惠類別的背景顏色。格式為十六進位顏色字串,例如「#RRGGBB」。 |
heroImageUri |
(選用步驟) 顯示在優惠類別正面的橫幅圖片。 |
redemptionChannel |
(選用步驟) 優惠類別的兌換管道。 |
classTemplateInfo |
(選用步驟) 優惠類別的顯示方式範本資訊。 |
EventTicketClass
| JSON 表示法 |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| 欄位 | |
|---|---|
id |
(選用步驟) 活動票券類別的 ID。 |
issuerName |
(選用步驟) 活動票券類別的發卡機構名稱。 |
localizedIssuerName |
(選用步驟) 活動票券類別的本地化發卡機構名稱。 |
logoUri |
(選用步驟) 活動票券類別的標誌。 |
eventName |
(選用步驟) 活動的名稱。 |
venue |
(選用步驟) 活動場地。 |
dateTime |
(選用步驟) 活動的日期和時間資訊。 |
hexBackgroundColor |
(選用步驟) 活動票券類別的背景顏色。格式為十六進位顏色字串,例如「#RRGGBB」。 |
heroImageUri |
(選用步驟) 顯示在活動票券類別正面的橫幅圖片。 |
classTemplateInfo |
(選用步驟) 活動票券類別的顯示範本資訊。 |
EventVenue
| JSON 表示法 |
|---|
{ "name": { object ( |
| 欄位 | |
|---|---|
name |
(選用步驟) 場地的名稱。 |
address |
(選用步驟) 場地地址。 |
EventDateTime
| JSON 表示法 |
|---|
{ "start": string, "end": string } |
| 欄位 | |
|---|---|
start |
(選用步驟) 活動開始的日期/時間。如果活動橫跨數天,則應為活動第一天的開始日期/時間。格式為 ISO 8601 擴充格式的日期/時間 (不含時差),時間可精確指定到毫秒,例如 2027-03-05T06:30:00。 |
end |
(選用步驟) 活動結束的日期/時間。如果活動橫跨數天,則應為活動最後一天的結束日期/時間。格式為 ISO 8601 擴充格式的日期/時間 (不含時差),時間可精確指定到毫秒,例如 2027-03-05T06:30:00。 |
FlightClass
| JSON 表示法 |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| 欄位 | |
|---|---|
id |
(選用步驟) 航班類別的 ID。 |
issuerName |
(選用步驟) 航班類別的發卡機構名稱。 |
localizedIssuerName |
(選用步驟) 航班艙等的本地化發行者名稱。 |
flightHeader |
(選用步驟) 航班所屬航空公司和航班編號的相關資訊。 |
origin |
(選用步驟) 出發地機場資訊。 |
destination |
(選用步驟) 目的地機場的相關資訊。 |
localScheduledDepartureDateTime |
(選用步驟) 飛機離開登機門 (而非跑道) 的表定日期和時間。格式為 ISO 8601 擴充格式的日期/時間 (不含時差),時間可準確指定到毫秒,例如 2027-03-05T06:30:00。這是機場的當地日期/時間 (並非世界標準時間)。 |
hexBackgroundColor |
(選用步驟) 航班艙等的背景顏色。格式為十六進位顏色字串,例如「#RRGGBB」。 |
heroImageUri |
(選用步驟) 顯示在航班艙等正面的橫幅圖片。 |
classTemplateInfo |
(選用步驟) 航班艙等顯示方式的範本資訊。 |
FlightHeader
| JSON 表示法 |
|---|
{
"carrier": {
object ( |
| 欄位 | |
|---|---|
carrier |
(選用步驟) 航空公司資訊。 |
flightNumber |
(選用步驟) 航班編號 (不含航空公司 IATA 代碼)。欄位只包含數字,例如「123」。 |
FlightCarrier
| JSON 表示法 |
|---|
{ "carrierIataCode": string, "carrierIcaoCode": string, "airlineLogoUri": string } |
| 欄位 | |
|---|---|
carrierIataCode |
(選用步驟) 航空公司的 IATA 航空公司代碼 (共兩個字元)。 |
carrierIcaoCode |
(選用步驟) 航空公司的 ICAO 航空公司代碼 (共 3 個字元)。 |
airlineLogoUri |
(選用步驟) 由航空公司 IATA 代碼定義的航空公司標誌。 |
AirportInfo
| JSON 表示法 |
|---|
{ "airportIataCode": string, "terminal": string, "gate": string } |
| 欄位 | |
|---|---|
airportIataCode |
(選用步驟) IATA 機場代碼 (共三個字元),例如「SFO」。 |
terminal |
(選用步驟) 航廈名稱,例如「I」。 |
gate |
(選用步驟) 登機門名稱,例如「B59」。 |
TransitClass
| JSON 表示法 |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| 欄位 | |
|---|---|
id |
(選用步驟) 大眾運輸類別的 ID。 |
issuerName |
(選用步驟) 大眾運輸類別的發卡機構名稱。 |
localizedIssuerName |
(選用步驟) 大眾運輸票證類別的本地化發卡機構名稱。 |
hexBackgroundColor |
(選用步驟) 大眾運輸類別的背景顏色。格式為十六進位顏色字串,例如「#RRGGBB」。 |
heroImageUri |
(選用步驟) 顯示在交通運輸課程正面的橫幅圖片。 |
transitType |
(選用步驟) 大眾運輸類別的大眾運輸類型。 |
classTemplateInfo |
(選用步驟) 運送類別的顯示方式範本資訊。 |
GenericClass
| JSON 表示法 |
|---|
{
"id": string,
"classTemplateInfo": {
object ( |
| 欄位 | |
|---|---|
id |
(選用步驟) 泛型類別的 ID。 |
classTemplateInfo |
(選用步驟) 泛型類別的顯示方式範本資訊。 |
工具註解
破壞性提示:❌ | 等冪提示:✅ | 唯讀提示:✅ | 開放世界提示:❌