도구: list_pass_classes
인증된 사용자와 연결된 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 |
필수 항목입니다. 패스 클래스를 나열할 발급기관의 고유 식별자입니다. |
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 |
선택사항입니다. 포인트 멤버십 등급의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#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 요청으로 가입 웹사이트 URL에 전송되는 사용자 데이터입니다. 이 정보는 암호화 후 공유되므로 판매자 웹사이트에서 검색 가능한 프로그램에 사용자를 등록하는 데 사용되는 필드를 미리 채울 수 있습니다. |
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[] |
선택사항입니다. 카드 보기의 행에 관한 템플릿 정보입니다. 최대 3개의 행을 지정할 수 있습니다. |
CardRowTemplateInfo
| JSON 표현 |
|---|
{ // Union field |
| 필드 | |
|---|---|
통합 필드 row_template. 1개, 2개 또는 3개의 항목을 포함하는 행의 템플릿입니다. row_template은 다음 중 하나여야 합니다. |
|
oneItem |
선택사항입니다. 1개 항목을 포함하는 행의 템플릿입니다. |
twoItems |
선택사항입니다. 2개 항목을 포함하는 행의 템플릿입니다. |
threeItems |
선택사항입니다. 3개 항목을 포함하는 행의 템플릿입니다. |
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 |
선택사항입니다. 기프트 카드 클래스의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#RRGGBB'). |
heroImageUri |
선택사항입니다. 기프트 카드 클래스의 앞면에 표시되는 배너 이미지입니다. |
homePageUri |
선택사항입니다. 애플리케이션 홈페이지의 웹사이트입니다. |
classTemplateInfo |
선택사항입니다. 기프트 카드 클래스를 표시하는 방법에 관한 템플릿 정보입니다. |
OfferClass
| JSON 표현 |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| 필드 | |
|---|---|
id |
선택사항입니다. 혜택 클래스의 ID입니다. |
issuerName |
선택사항입니다. 혜택 클래스의 발급기관 이름입니다. |
localizedIssuerName |
선택사항입니다. 혜택 등급의 현지화된 발급기관 이름입니다. |
provider |
선택사항입니다. 혜택 클래스의 제공자입니다. |
localizedProvider |
선택사항입니다. 쿠폰 클래스의 현지화된 제공업체입니다. |
title |
선택사항입니다. 혜택 클래스의 제목입니다. |
localizedTitle |
선택사항입니다. 혜택 등급의 현지화된 제목입니다. |
titleImageUri |
선택사항입니다. 쿠폰 클래스의 제목 이미지입니다. |
hexBackgroundColor |
선택사항입니다. 혜택 등급의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#RRGGBB'). |
heroImageUri |
선택사항입니다. 혜택 클래스 앞면에 표시되는 배너 이미지입니다. |
redemptionChannel |
선택사항입니다. 쿠폰 클래스의 사용 채널입니다. |
classTemplateInfo |
선택사항입니다. 혜택 클래스를 표시하는 방법에 관한 템플릿 정보입니다. |
EventTicketClass
| JSON 표현 |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| 필드 | |
|---|---|
id |
선택사항입니다. 이벤트 티켓 클래스의 ID입니다. |
issuerName |
선택사항입니다. 이벤트 티켓 클래스의 발급기관 이름입니다. |
localizedIssuerName |
선택사항입니다. 이벤트 티켓 클래스의 현지화된 발급기관 이름입니다. |
logoUri |
선택사항입니다. 이벤트 티켓 클래스의 로고입니다. |
eventName |
선택사항입니다. 이벤트 이름 |
venue |
선택사항입니다. 이벤트의 장소입니다. |
dateTime |
선택사항입니다. 이벤트의 날짜 및 시간에 관한 정보입니다. |
hexBackgroundColor |
선택사항입니다. 이벤트 티켓 클래스의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#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). 이 속성은 UTC 시간이 아니라 공항 현지의 날짜/시간이어야 합니다. |
hexBackgroundColor |
선택사항입니다. 항공편 등급의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#RRGGBB'). |
heroImageUri |
선택사항입니다. 항공편 클래스 앞면에 표시되는 배너 이미지입니다. |
classTemplateInfo |
선택사항입니다. 항공편 클래스를 표시하는 방법에 관한 템플릿 정보입니다. |
FlightHeader
| JSON 표현 |
|---|
{
"carrier": {
object ( |
| 필드 | |
|---|---|
carrier |
선택사항입니다. 항공사에 대한 정보입니다. |
flightNumber |
선택사항입니다. 항공사 IATA 코드가 없는 항공편 번호입니다. 필드에 숫자만 포함됩니다(예: '123'). |
FlightCarrier
| JSON 표현 |
|---|
{ "carrierIataCode": string, "carrierIcaoCode": string, "airlineLogoUri": string } |
| 필드 | |
|---|---|
carrierIataCode |
선택사항입니다. 항공사의 두 자로 된 IATA 항공사 코드입니다. |
carrierIcaoCode |
선택사항입니다. 항공사의 세 자리 ICAO 항공사 코드입니다. |
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 |
선택사항입니다. 대중교통 클래스의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#RRGGBB'). |
heroImageUri |
선택사항입니다. 대중교통 클래스 앞면에 표시되는 배너 이미지입니다. |
transitType |
선택사항입니다. 대중교통 클래스의 대중교통 유형입니다. |
classTemplateInfo |
선택사항입니다. 대중교통 클래스를 표시하는 방법에 관한 템플릿 정보입니다. |
GenericClass
| JSON 표현 |
|---|
{
"id": string,
"classTemplateInfo": {
object ( |
| 필드 | |
|---|---|
id |
선택사항입니다. 일반 클래스의 ID입니다. |
classTemplateInfo |
선택사항입니다. 일반 클래스를 표시하는 방법에 대한 템플릿 정보입니다. |
도구 주석
파괴적 힌트: ❌ | 동일한 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌