MCP Tools Reference: paydeveloper.googleapis.com

도구: 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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

발급기관의 패스 클래스를 나열하는 요청 메시지입니다.

ListPassClassesRequest

JSON 표현
{
  "issuerId": string,
  "passType": enum (PassType),
  "view": enum (PassClassView)
}
필드
issuerId

string (int64 format)

필수 항목입니다. 패스 클래스를 나열할 발급기관의 고유 식별자입니다.

passType

enum (PassType)

선택사항입니다. 나열할 패스 클래스 유형입니다. 지정하지 않으면 모든 유형의 패스 클래스가 반환됩니다.

view

enum (PassClassView)

선택사항입니다. 각 패스 클래스에 대해 반환할 세부정보 수준을 지정합니다.

PassType

패스 클래스의 유형입니다.

열거형
PASS_TYPE_UNSPECIFIED 패스 유형이 지정되지 않았습니다.
LOYALTY 패스 유형이 포인트입니다.
GIFT_CARD 패스 유형은 기프트 카드입니다.
OFFER 패스 유형은 혜택입니다.
EVENT_TICKET 패스 유형은 이벤트 티켓입니다.
FLIGHT 패스 유형은 항공편입니다.
TRANSIT 패스 유형은 대중교통입니다.
GENERIC 패스 유형이 일반입니다.

PassClassView

각 패스 클래스에 대해 반환될 세부 정보 수준입니다.

열거형
PASS_CLASS_VIEW_UNSPECIFIED 기본값 / 설정되지 않은 값입니다. API는 BASIC 뷰로 기본 설정됩니다.
PASS_CLASS_VIEW_BASIC 이용권 클래스에 관한 기본 정보를 포함합니다.
PASS_CLASS_VIEW_FULL 패스 클래스에 관한 모든 세부정보를 포함합니다.

출력 스키마

발급기관의 패스 클래스를 나열하기 위한 응답 메시지입니다.

ListPassClassesResponse

JSON 표현
{
  "passClasses": [
    {
      object (PassClass)
    }
  ]
}
필드
passClasses[]

object (PassClass)

발급기관의 패스 클래스입니다.

PassClass

JSON 표현
{

  // Union field resource can be only one of the following:
  "loyaltyClass": {
    object (LoyaltyClass)
  },
  "giftCardClass": {
    object (GiftCardClass)
  },
  "offerClass": {
    object (OfferClass)
  },
  "eventTicketClass": {
    object (EventTicketClass)
  },
  "flightClass": {
    object (FlightClass)
  },
  "transitClass": {
    object (TransitClass)
  },
  "genericClass": {
    object (GenericClass)
  }
  // End of list of possible types for union field resource.
}
필드

통합 필드 resource.

resource는 다음 중 하나여야 합니다.

loyaltyClass

object (LoyaltyClass)

선택사항입니다. 발급자의 충성도 클래스입니다.

giftCardClass

object (GiftCardClass)

선택사항입니다. 발급기관의 기프트 카드 클래스입니다.

offerClass

object (OfferClass)

선택사항입니다. 발행자의 오퍼 클래스.

eventTicketClass

object (EventTicketClass)

선택사항입니다. 발급기관의 이벤트 티켓 클래스입니다.

flightClass

object (FlightClass)

선택사항입니다. 발행자의 항공편 등급.

transitClass

object (TransitClass)

선택사항입니다. 발급기관의 트랜짓 클래스.

genericClass

object (GenericClass)

선택사항입니다. 발급기관의 일반 클래스입니다.

LoyaltyClass

JSON 표현
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "programName": string,
  "localizedProgramName": {
    object (LocalizedString)
  },
  "programLogoUri": string,
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "discoverableProgram": {
    object (DiscoverableProgram)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
필드
id

string

선택사항입니다. 충성도 클래스의 ID입니다.

issuerName

string

선택사항입니다. 포인트 멤버십 클래스의 발급기관 이름입니다.

localizedIssuerName

object (LocalizedString)

선택사항입니다. 포인트 멤버십 클래스의 현지화된 발급기관 이름입니다.

programName

string

선택사항입니다. 로열티 클래스의 프로그램 이름입니다.

localizedProgramName

object (LocalizedString)

선택사항입니다. 포인트 멤버십 등급의 현지화된 프로그램 이름입니다.

programLogoUri

string

선택사항입니다. 포인트 멤버십 클래스의 프로그램 로고입니다.

hexBackgroundColor

string

선택사항입니다. 포인트 멤버십 등급의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#RRGGBB').

heroImageUri

string

선택사항입니다. 포인트 멤버십 클래스의 앞면에 표시되는 배너 이미지입니다.

discoverableProgram

object (DiscoverableProgram)

선택사항입니다. 구글 월렛 내에서 로열티 클래스를 찾고 생성하는 방법에 대한 정보입니다.

classTemplateInfo

object (ClassTemplateInfo)

선택사항입니다. 포인트 멤버십 등급을 표시하는 방법에 관한 템플릿 정보입니다.

LocalizedString

JSON 표현
{
  "translatedValues": [
    {
      object (TranslatedString)
    }
  ],
  "defaultValue": {
    object (TranslatedString)
  }
}
필드
translatedValues[]

object (TranslatedString)

선택사항입니다. 문자열의 번역된 문자열입니다.

defaultValue

object (TranslatedString)

선택사항입니다. 적절한 번역을 사용할 수 없는 경우에 표시할 문자열입니다.

TranslatedString

JSON 표현
{
  "languageCode": string,
  "value": string
}
필드
languageCode

string

선택사항입니다. BCP 47 언어 태그입니다. 값의 예시로는 'en-US', 'en-GB', 'de', 'de-AT' 등이 있습니다.

value

string

선택사항입니다. UTF-8로 인코딩된 번역된 문자열입니다.

DiscoverableProgram

JSON 표현
{
  "merchantSignupInfo": {
    object (MerchantSignupInfo)
  },
  "merchantSigninInfo": {
    object (MerchantSigninInfo)
  },
  "state": enum (State)
}
필드
merchantSignupInfo

object (MerchantSignupInfo)

선택사항입니다. 이 정보는 판매자 사이트를 통해 이 발견 가능한 프로그램에 가입하고 유용한 정보를 추가하는 기능에 관한 것입니다.

merchantSigninInfo

object (MerchantSigninInfo)

선택사항입니다. 판매자 사이트를 통해 이 검색 가능한 프로그램에 로그인하고 프로그램의 패스를 추가하는 기능에 대한 정보입니다.

state

enum (State)

출력 전용입니다. 검색 가능한 프로그램의 상태입니다.

MerchantSignupInfo

JSON 표현
{
  "signupWebsite": {
    object (Uri)
  },
  "signupSharedDatas": [
    enum (SharedDataType)
  ]
}
필드
signupWebsite

object (Uri)

선택사항입니다. 검색 가능한 프로그램에 가입할 수 있는 웹사이트입니다.

signupSharedDatas[]

enum (SharedDataType)

선택사항입니다. 회원가입 웹사이트 URL로 POST 요청에 전송되는 사용자 데이터입니다. 이 정보는 암호화된 후 공유되어 판매자의 웹사이트에서 사용자를 검색 가능한 프로그램에 등록하는 데 필요한 필드를 미리 채울 수 있도록 합니다.

URI

JSON 표현
{
  "uri": string,
  "description": string,
  "localizedDescription": {
    object (LocalizedString)
  }
}
필드
uri

string

선택사항입니다. URI입니다.

description

string

선택사항입니다. Google 월렛에 텍스트로 표시되는 URI의 제목입니다.

localizedDescription

object (LocalizedString)

선택사항입니다. Google 월렛에 텍스트로 표시되는 URI 제목의 번역된 문자열입니다.

MerchantSigninInfo

JSON 표현
{
  "signinWebsite": {
    object (Uri)
  }
}
필드
signinWebsite

object (Uri)

선택사항입니다. 검색 가능한 프로그램에 로그인하는 웹사이트입니다.

ClassTemplateInfo

JSON 표현
{
  "cardBarcodeSectionDetails": {
    object (CardBarcodeSectionDetails)
  },
  "cardTemplateOverride": {
    object (CardTemplateOverride)
  },
  "detailsTemplateOverride": {
    object (DetailsTemplateOverride)
  },
  "listTemplateOverride": {
    object (ListTemplateOverride)
  }
}
필드
cardBarcodeSectionDetails

object (CardBarcodeSectionDetails)

선택사항입니다. 바코드 위아래에 표시될 추가 정보.

cardTemplateOverride

object (CardTemplateOverride)

선택사항입니다. 카드 보기의 템플릿 재정의입니다.

detailsTemplateOverride

object (DetailsTemplateOverride)

선택사항입니다. 세부정보 보기의 템플릿 재정의입니다.

listTemplateOverride

object (ListTemplateOverride)

선택사항입니다. 합격자 목록 보기의 템플릿 재정의입니다.

CardBarcodeSectionDetails

JSON 표현
{
  "firstTopDetail": {
    object (BarcodeSectionDetail)
  },
  "firstBottomDetail": {
    object (BarcodeSectionDetail)
  },
  "secondTopDetail": {
    object (BarcodeSectionDetail)
  }
}
필드
firstTopDetail

object (BarcodeSectionDetail)

선택사항입니다. 바코드 위에 표시될 선택적 정보입니다. secondTopDetail이 정의되면 이 세부정보 섹션의 시작 부분에 표시됩니다.

firstBottomDetail

object (BarcodeSectionDetail)

선택사항입니다. 바코드 아래에 표시할 선택적 정보입니다.

secondTopDetail

object (BarcodeSectionDetail)

선택사항입니다. 바코드 위에 표시될 두 번째 정보(선택 사항). firstTopDetail이 정의되면 이 세부정보 섹션의 끝 부분에 표시됩니다.

BarcodeSectionDetail

JSON 표현
{
  "fieldSelector": {
    object (FieldSelector)
  }
}
필드
fieldSelector

object (FieldSelector)

선택사항입니다. 표시할 기존 텍스트 기반 또는 이미지 필드에 대한 참조입니다.

FieldSelector

JSON 표현
{
  "fields": [
    {
      object (FieldReference)
    }
  ]
}
필드
fields[]

object (FieldReference)

선택사항입니다. 필드 재정의에 사용할 필드 참조입니다. 참조가 두 개 이상 제공된 경우, 비어 있지 않은 필드를 참조하는 첫 번째 참조가 표시됩니다.

FieldReference

JSON 표현
{
  "fieldPath": string,
  "dateFormat": enum (DateFormat)
}
필드
fieldPath

string

선택사항입니다. 'object' 또는 'class' 프리픽스가 붙고 점으로 구분된 필드의 경로입니다.

dateFormat

enum (DateFormat)

선택사항입니다. 날짜/시간 필드를 렌더링할 날짜 형식입니다.

CardTemplateOverride

JSON 표현
{
  "cardRowTemplateInfos": [
    {
      object (CardRowTemplateInfo)
    }
  ]
}
필드
cardRowTemplateInfos[]

object (CardRowTemplateInfo)

선택사항입니다. 카드 보기의 행에 대한 템플릿 정보입니다. 최대 3개의 행을 지정할 수 있습니다.

CardRowTemplateInfo

JSON 표현
{

  // Union field row_template can be only one of the following:
  "oneItem": {
    object (CardRowOneItem)
  },
  "twoItems": {
    object (CardRowTwoItems)
  },
  "threeItems": {
    object (CardRowThreeItems)
  }
  // End of list of possible types for union field row_template.
}
필드
통합 필드 row_template. 1개, 2개 또는 3개의 항목을 포함하는 행의 템플릿입니다. row_template은 다음 중 하나여야 합니다.
oneItem

object (CardRowOneItem)

선택사항입니다. 1개 항목을 포함하는 행의 템플릿입니다.

twoItems

object (CardRowTwoItems)

선택사항입니다. 두 개의 항목이 포함된 행의 템플릿입니다.

threeItems

object (CardRowThreeItems)

선택사항입니다. 항목이 세 개 포함된 행의 템플릿입니다.

CardRowOneItem

JSON 표현
{
  "item": {
    object (TemplateItem)
  }
}
필드
item

object (TemplateItem)

선택사항입니다. 행에 표시될 항목입니다. 이 항목은 가운데에 배치됩니다.

TemplateItem

JSON 표현
{
  "firstValue": {
    object (FieldSelector)
  },
  "secondValue": {
    object (FieldSelector)
  },
  "predefinedItem": enum (PredefinedItem)
}
필드
firstValue

object (FieldSelector)

선택사항입니다. 표시할 첫 번째 필드에 대한 참조입니다.

secondValue

object (FieldSelector)

선택사항입니다. 표시할 두 번째 필드에 대한 참조입니다.

predefinedItem

enum (PredefinedItem)

선택사항입니다. 표시할 미리 정의된 항목입니다.

CardRowTwoItems

JSON 표현
{
  "startItem": {
    object (TemplateItem)
  },
  "endItem": {
    object (TemplateItem)
  }
}
필드
startItem

object (TemplateItem)

선택사항입니다. 행 시작 부분에 표시될 항목입니다. 이 항목은 왼쪽으로 정렬됩니다.

endItem

object (TemplateItem)

선택사항입니다. 행 끝에 표시될 항목입니다. 이 항목은 오른쪽에 정렬됩니다.

CardRowThreeItems

JSON 표현
{
  "startItem": {
    object (TemplateItem)
  },
  "middleItem": {
    object (TemplateItem)
  },
  "endItem": {
    object (TemplateItem)
  }
}
필드
startItem

object (TemplateItem)

선택사항입니다. 행 시작 부분에 표시될 항목입니다. 이 항목은 왼쪽으로 정렬됩니다.

middleItem

object (TemplateItem)

선택사항입니다. 행의 가운데에 표시될 항목입니다. 이 항목은 시작 항목과 끝 항목의 중간에 배치됩니다.

endItem

object (TemplateItem)

선택사항입니다. 행 끝에 표시될 항목입니다. 이 항목은 오른쪽에 정렬됩니다.

DetailsTemplateOverride

JSON 표현
{
  "detailsItemInfos": [
    {
      object (DetailsItemInfo)
    }
  ]
}
필드
detailsItemInfos[]

object (DetailsItemInfo)

선택사항입니다. 세부정보 목록에 표시된 항목에 관한 템플릿 정보입니다.

DetailsItemInfo

JSON 표현
{
  "item": {
    object (TemplateItem)
  }
}
필드
item

object (TemplateItem)

선택사항입니다. 세부정보 목록에 표시될 항목입니다.

ListTemplateOverride

JSON 표현
{
  "firstRowOption": {
    object (FirstRowOption)
  },
  "secondRowOption": {
    object (FieldSelector)
  }
}
필드
firstRowOption

object (FirstRowOption)

선택사항입니다. 첫 번째 행에 표시될 필드에 대한 참조입니다.

secondRowOption

object (FieldSelector)

선택사항입니다. 두 번째 행에 표시될 필드에 대한 참조입니다.

FirstRowOption

JSON 표현
{
  "transitOption": enum (TransitOption),
  "fieldOption": {
    object (FieldSelector)
  }
}
필드
transitOption

enum (TransitOption)

선택사항입니다. 첫 번째 행에 표시할 대중교통 옵션입니다.

fieldOption

object (FieldSelector)

선택사항입니다. 첫 번째 행에 표시될 필드에 대한 참조입니다.

GiftCardClass

JSON 표현
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "merchantName": string,
  "localizedMerchantName": {
    object (LocalizedString)
  },
  "programLogoUri": string,
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "homePageUri": {
    object (Uri)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
필드
id

string

선택사항입니다. 기프트 카드 클래스의 ID입니다.

issuerName

string

선택사항입니다. 기프트 카드 종류의 발행자 이름입니다.

localizedIssuerName

object (LocalizedString)

선택사항입니다. 기프트 카드 클래스의 현지화된 발급기관 이름입니다.

merchantName

string

선택사항입니다. 기프트 카드 클래스의 판매자 이름입니다.

localizedMerchantName

object (LocalizedString)

선택사항입니다. 기프트 카드 클래스의 현지화된 판매자 이름입니다.

programLogoUri

string

선택사항입니다. 기프트 카드 클래스의 프로그램 로고입니다.

hexBackgroundColor

string

선택사항입니다. 기프트 카드 클래스의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#RRGGBB').

heroImageUri

string

선택사항입니다. 기프트 카드 클래스의 앞면에 표시되는 배너 이미지입니다.

homePageUri

object (Uri)

선택사항입니다. 해당 애플리케이션의 홈페이지 웹사이트입니다.

classTemplateInfo

object (ClassTemplateInfo)

선택사항입니다. 기프트 카드 클래스를 표시하는 방법에 관한 템플릿 정보입니다.

OfferClass

JSON 표현
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "provider": string,
  "localizedProvider": {
    object (LocalizedString)
  },
  "title": string,
  "localizedTitle": {
    object (LocalizedString)
  },
  "titleImageUri": string,
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "redemptionChannel": enum (RedemptionChannel),
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
필드
id

string

선택사항입니다. 혜택 클래스의 ID입니다.

issuerName

string

선택사항입니다. 혜택 클래스의 발급기관 이름입니다.

localizedIssuerName

object (LocalizedString)

선택사항입니다. 혜택 등급의 현지화된 발급기관 이름입니다.

provider

string

선택사항입니다. 혜택 클래스의 제공자입니다.

localizedProvider

object (LocalizedString)

선택사항입니다. 쿠폰 클래스의 현지화된 제공업체입니다.

title

string

선택사항입니다. 혜택 클래스의 제목입니다.

localizedTitle

object (LocalizedString)

선택사항입니다. 오퍼 클래스의 현지화된 제목입니다.

titleImageUri

string

선택사항입니다. 쿠폰 등급의 제목 이미지입니다.

hexBackgroundColor

string

선택사항입니다. 혜택 클래스의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#RRGGBB').

heroImageUri

string

선택사항입니다. 혜택 클래스 앞면에 표시되는 배너 이미지입니다.

redemptionChannel

enum (RedemptionChannel)

선택사항입니다. 쿠폰 클래스의 사용 채널입니다.

classTemplateInfo

object (ClassTemplateInfo)

선택사항입니다. 혜택 클래스를 표시하는 방법에 관한 템플릿 정보입니다.

EventTicketClass

JSON 표현
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "logoUri": string,
  "eventName": {
    object (LocalizedString)
  },
  "venue": {
    object (EventVenue)
  },
  "dateTime": {
    object (EventDateTime)
  },
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
필드
id

string

선택사항입니다. 이벤트 티켓 클래스의 ID입니다.

issuerName

string

선택사항입니다. 이벤트 티켓 클래스의 발급기관 이름입니다.

localizedIssuerName

object (LocalizedString)

선택사항입니다. 이벤트 티켓 클래스의 현지화된 발급기관 이름입니다.

logoUri

string

선택사항입니다. 이벤트 티켓 클래스의 로고입니다.

eventName

object (LocalizedString)

선택사항입니다. 이벤트 이름

venue

object (EventVenue)

선택사항입니다. 이벤트의 장소입니다.

dateTime

object (EventDateTime)

선택사항입니다. 이벤트의 날짜 및 시간에 관한 정보입니다.

hexBackgroundColor

string

선택사항입니다. 이벤트 티켓 클래스의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#RRGGBB').

heroImageUri

string

선택사항입니다. 이벤트 티켓 앞면에 표시되는 배너 이미지.

classTemplateInfo

object (ClassTemplateInfo)

선택사항입니다. 이벤트 티켓 클래스를 표시하는 방법에 관한 템플릿 정보입니다.

EventVenue

JSON 표현
{
  "name": {
    object (LocalizedString)
  },
  "address": {
    object (LocalizedString)
  }
}
필드
name

object (LocalizedString)

선택사항입니다. 장소 이름입니다.

address

object (LocalizedString)

선택사항입니다. 장소의 주소입니다.

EventDateTime

JSON 표현
{
  "start": string,
  "end": string
}
필드
start

string

선택사항입니다. 이벤트 시작 날짜/시간. 이벤트가 여러 날에 걸쳐 진행되는 경우 첫째 날의 시작 날짜/시간이 되어야 합니다. 형식은 오프셋이 없는 ISO 8601 확장 형식 날짜/시간이며, 시간은 밀리초 단위까지 정확하게 지정할 수 있습니다(예: 2027-03-05T06:30:00).

end

string

선택사항입니다. 이벤트가 종료되는 날짜/시간입니다. 이벤트는 여러 날에 걸쳐 진행되므로 이 날짜/시간은 마지막 날의 종료 날짜/시간이어야 합니다. 형식은 오프셋이 없는 ISO 8601 확장 형식 날짜/시간이며, 시간은 밀리초 단위까지 정확하게 지정할 수 있습니다(예: 2027-03-05T06:30:00).

FlightClass

JSON 표현
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "flightHeader": {
    object (FlightHeader)
  },
  "origin": {
    object (AirportInfo)
  },
  "destination": {
    object (AirportInfo)
  },
  "localScheduledDepartureDateTime": string,
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
필드
id

string

선택사항입니다. 항공편 클래스의 ID입니다.

issuerName

string

선택사항입니다. 항공편 클래스의 발급기관 이름입니다.

localizedIssuerName

object (LocalizedString)

선택사항입니다. 항공편 등급의 현지화된 발급기관 이름입니다.

flightHeader

object (FlightHeader)

선택사항입니다. 항공사 및 항공편 번호에 대한 정보입니다.

origin

object (AirportInfo)

선택사항입니다. 출발 공항에 관한 정보입니다.

destination

object (AirportInfo)

선택사항입니다. 도착 공항에 관한 정보입니다.

localScheduledDepartureDateTime

string

선택사항입니다. 항공기가 활주로가 아니라 게이트에서 출발하는 예정 날짜 및 시간입니다. 형식은 오프셋이 없는 ISO 8601 확장 형식 날짜/시간이며 시간은 밀리초 단위까지 지정할 수 있습니다(예: 2027-03-05T06:30:00). 이 속성은 UTC 시간이 아니라 공항 현지의 날짜/시간이어야 합니다.

hexBackgroundColor

string

선택사항입니다. 항공편 등급의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#RRGGBB').

heroImageUri

string

선택사항입니다. 항공편 클래스 앞면에 표시되는 배너 이미지입니다.

classTemplateInfo

object (ClassTemplateInfo)

선택사항입니다. 항공편 클래스를 표시하는 방법에 관한 템플릿 정보입니다.

FlightHeader

JSON 표현
{
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string
}
필드
carrier

object (FlightCarrier)

선택사항입니다. 항공사에 대한 정보입니다.

flightNumber

string

선택사항입니다. 항공사 IATA 코드가 없는 항공편 번호입니다. 필드에 숫자만 포함됩니다(예: '123').

FlightCarrier

JSON 표현
{
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineLogoUri": string
}
필드
carrierIataCode

string

선택사항입니다. 항공사의 두 자리 IATA 항공사 코드입니다.

carrierIcaoCode

string

선택사항입니다. 항공사의 세 자리 ICAO 항공사 코드입니다.

airlineLogoUri

string

선택사항입니다. 항공사 IATA 코드로 설명된 항공사의 로고입니다.

AirportInfo

JSON 표현
{
  "airportIataCode": string,
  "terminal": string,
  "gate": string
}
필드
airportIataCode

string

선택사항입니다. 세 자리로 된 IATA 공항 코드, 예: "SFO".

terminal

string

선택사항입니다. 터미널 이름입니다(예: 'I').

gate

string

선택사항입니다. 게이트 이름(예: 'B59')

TransitClass

JSON 표현
{
  "id": string,
  "issuerName": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "hexBackgroundColor": string,
  "heroImageUri": string,
  "transitType": enum (TransitType),
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
필드
id

string

선택사항입니다. 환승 클래스의 ID입니다.

issuerName

string

선택사항입니다. 대중교통 클래스의 발급기관 이름입니다.

localizedIssuerName

object (LocalizedString)

선택사항입니다. 대중교통 클래스의 현지화된 발급기관 이름입니다.

hexBackgroundColor

string

선택사항입니다. 교통수단 클래스의 배경색입니다. 형식은 16진수 색상 문자열입니다(예: '#RRGGBB').

heroImageUri

string

선택사항입니다. 대중교통 클래스 앞면에 표시되는 배너 이미지입니다.

transitType

enum (TransitType)

선택사항입니다. 대중교통 클래스의 대중교통 유형입니다.

classTemplateInfo

object (ClassTemplateInfo)

선택사항입니다. 교통수단 등급이 어떻게 표시되어야 하는지에 대한 템플릿 정보입니다.

GenericClass

JSON 표현
{
  "id": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  }
}
필드
id

string

선택사항입니다. 제네릭 클래스의 ID입니다.

classTemplateInfo

object (ClassTemplateInfo)

선택사항입니다. 일반 클래스를 표시하는 방법에 대한 템플릿 정보입니다.

SharedDataType

가입 시 판매자와 공유할 사용자 데이터 유형입니다.

열거형
SHARED_DATA_TYPE_UNSPECIFIED 지정되지 않은 공유 데이터 유형입니다.
FIRST_NAME 사용자의 이름입니다.
LAST_NAME 사용자의 성입니다.
STREET_ADDRESS 사용자의 단일 행 주소입니다.
ADDRESS_LINE_ONE 사용자의 주소 입력란 1입니다.
ADDRESS_LINE_TWO 사용자 주소 입력란 2입니다.
ADDRESS_LINE_THREE 사용자의 주소 입력란 3입니다.
CITY 사용자의 도시입니다.
STATE 사용자의 주입니다.
ZIPCODE 사용자의 우편번호입니다.
COUNTRY 사용자의 국가입니다.
EMAIL 사용자의 이메일 주소
PHONE 사용자의 전화번호입니다.

검색 가능한 프로그램의 상태입니다.

열거형
STATE_UNSPECIFIED 상태가 지정되지 않았습니다.
TRUSTED_TESTERS 이 프로그램은 발급기관 계정에 액세스할 수 있는 테스터에게만 표시됩니다.
LIVE 이 프로그램은 모든 사용자에게 공개됩니다.
DISABLED 프로그램이 보이지 않습니다.

DateFormat

날짜/시간 필드를 표시하는 날짜 형식입니다.

열거형
DATE_FORMAT_UNSPECIFIED 날짜 형식은 지정되지 않았습니다.
DATE_TIME 예를 들어, 2018-12-14T13:00:00은 en_US에서 Dec 14, 1:00 PM으로 표시됩니다.
DATE_ONLY 예를 들어 2018-12-14T13:00:00을 en_US에서 12월 14일로 렌더링합니다.
TIME_ONLY 예를 들어 2018-12-14T13:00:00을 en_US에서 오후 1시로 렌더링합니다.
DATE_TIME_YEAR 예를 들어 en_US에서 2018-12-14T13:00:00을 2018년 12월 14일 오후 1시로 렌더링합니다.
DATE_YEAR 예를 들어, 2018-12-14T13:00:00은 en_US에서 2018년 12월 14일로 표시됩니다.
YEAR_MONTH 예를 들어, en_US에서는 2018-12-14T13:00:00을 2018-12로 렌더링합니다.
YEAR_MONTH_DAY 예를 들어, 2018-12-14T13:00:00은 en_US에서 2018-12-14로 표시됩니다.

PredefinedItem

표시할 사전 정의된 항목입니다.

열거형
PREDEFINED_ITEM_UNSPECIFIED 사전 정의된 항목이 지정되지 않았습니다.
FREQUENT_FLYER_PROGRAM_NAME_AND_NUMBER 사전 정의된 항목은 항공사 멤버십 프로그램 이름과 번호입니다.
FLIGHT_NUMBER_AND_OPERATING_FLIGHT_NUMBER 사전 정의된 항목은 항공편 번호와 운항 항공사 항공편 번호입니다.

TransitOption

표시할 대중교통 옵션입니다.

열거형
TRANSIT_OPTION_UNSPECIFIED 대중교통 옵션이 지정되지 않았습니다.
ORIGIN_AND_DESTINATION_NAMES 경유 옵션은 출발지와 목적지 이름입니다.
ORIGIN_AND_DESTINATION_CODES 대중교통 옵션은 출발지 및 목적지 코드입니다.
ORIGIN_NAME 전송 옵션은 원본 이름입니다.

RedemptionChannel

이 혜택에 해당하는 쿠폰 사용 채널입니다.

열거형
REDEMPTION_CHANNEL_UNSPECIFIED 사용 채널이 지정되지 않았습니다.
IN_STORE 이 혜택은 오프라인 매장에서만 사용할 수 있습니다.
ONLINE 해당 혜택은 온라인에서만 사용할 수 있습니다.
BOTH 해당 쿠폰은 매장 또는 온라인에서 사용하실 수 있습니다.
TEMPORARY_PRICE_REDUCTION 이 혜택은 일시적인 가격 인하입니다.

TransitType

대중교통 클래스의 대중교통 유형입니다.

열거형
TRANSIT_TYPE_UNSPECIFIED 운송 유형이 지정되지 않았습니다.
BUS 교통수단은 버스입니다.
RAIL 운송 수단은 철도입니다.
TRAM 대중교통 유형은 트램입니다.
FERRY 대중교통 유형은 페리입니다.
FLIGHT 대중교통 유형은 항공편입니다.
OTHER 대중교통 유형이 기타입니다.

도구 주석

도구 주석은 특정 도구의 기본 위험을 설명하기 위해 MCP 클라이언트로 전송됩니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만, 사용자에게 확인 메시지를 전송할 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 다음과 같이 정의됩니다.

  • readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true인 경우 도구가 파괴적인 작업을 실행할 수 있습니다. false인 경우 도구는 추가 작업만 실행할 수 있습니다. 기본값은 true입니다.
  • idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true인 경우 도구가 외부 엔티티의 '오픈 월드'와 상호작용할 수 있습니다. false인 경우 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌