Araç: list_pass_classes
Kimliği doğrulanmış kullanıcıyla ilişkili Google Cüzdan işletme konsolunda kayıtlı tüm kart sınıflarının kapsamlı bir listesini alır. Bu araç, bağlılık kartları, hediye kartları veya uçuşlar gibi Cüzdan kartlarını yöneten geliştiriciler için gerekli bilgileri sağlar.
Aşağıdaki örnekte, curl kullanılarak list_pass_classes MCP aracının nasıl çağrılacağı gösterilmektedir.
| Curl İsteği |
|---|
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 }' |
Giriş Şeması
Bir kartı veren kuruluşun geçiş kartı sınıflarını listelemek için istek mesajı.
ListPassClassesRequest
| JSON gösterimi |
|---|
{ "issuerId": string, "passType": enum ( |
| Alanlar | |
|---|---|
issuerId |
Zorunlu. Kart sınıflarının listeleneceği veren kuruluşun benzersiz tanımlayıcısı. |
passType |
İsteğe bağlı. Listelenecek geçiş kartı sınıfının türü. Belirtilmezse tüm kart sınıfı türleri döndürülür. |
view |
İsteğe bağlı. Her geçiş sınıfı için döndürülecek ayrıntı düzeyini belirtir. |
Çıkış şeması
Bir veren kuruluşun kart sınıflarını listeleme yanıtı mesajı.
ListPassClassesResponse
| JSON gösterimi |
|---|
{
"passClasses": [
{
object ( |
| Alanlar | |
|---|---|
passClasses[] |
Kartı veren kuruluşun kart sınıfları. |
PassClass
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
|
|
loyaltyClass |
İsteğe bağlı. Kartı veren kuruluşun bağlılık sınıfı. |
giftCardClass |
İsteğe bağlı. Kartı veren kuruluşun hediye kartı sınıfı. |
offerClass |
İsteğe bağlı. Kartı veren kuruluşun teklif sınıfı. |
eventTicketClass |
İsteğe bağlı. Düzenleyenin etkinlik bileti sınıfı. |
flightClass |
İsteğe bağlı. Kartı veren kuruluşun uçuş sınıfı. |
transitClass |
İsteğe bağlı. Kartı veren kuruluşun transit sınıfı. |
genericClass |
İsteğe bağlı. Yayıncının genel sınıfı. |
LoyaltyClass
| JSON gösterimi |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Alanlar | |
|---|---|
id |
İsteğe bağlı. Bağlılık sınıfının kimliği. |
issuerName |
İsteğe bağlı. Bağlılık sınıfının veren kuruluş adı. |
localizedIssuerName |
İsteğe bağlı. Bağlılık sınıfının yerelleştirilmiş veren adı. |
programName |
İsteğe bağlı. Bağlılık sınıfının program adı. |
localizedProgramName |
İsteğe bağlı. Bağlılık sınıfının yerelleştirilmiş program adı. |
programLogoUri |
İsteğe bağlı. Bağlılık sınıfının program logosu. |
hexBackgroundColor |
İsteğe bağlı. Bağlılık sınıfının arka plan rengi. Biçim, onaltılık renk dizesidir (ör. "#RRGGBB"). |
heroImageUri |
İsteğe bağlı. Bağlılık programı sınıfının ön yüzünde gösterilen banner resmi. |
discoverableProgram |
İsteğe bağlı. Bağlılık sınıfının Google Cüzdan'da nasıl bulunup oluşturulabileceğiyle ilgili bilgiler. |
classTemplateInfo |
İsteğe bağlı. Bağlılık sınıfının nasıl gösterileceğiyle ilgili şablon bilgileri. |
LocalizedString
| JSON gösterimi |
|---|
{ "translatedValues": [ { object ( |
| Alanlar | |
|---|---|
translatedValues[] |
İsteğe bağlı. Dizenin çevrilmiş dizeleri. |
defaultValue |
İsteğe bağlı. Uygun bir çeviri yoksa gösterilecek dize. |
TranslatedString
| JSON gösterimi |
|---|
{ "languageCode": string, "value": string } |
| Alanlar | |
|---|---|
languageCode |
İsteğe bağlı. BCP 47 dil etiketi. Örnek değerler "en-US", "en-GB", "de" veya "de-AT" şeklindedir. |
value |
İsteğe bağlı. UTF-8 kodlu çevrilmiş dize. |
DiscoverableProgram
| JSON gösterimi |
|---|
{ "merchantSignupInfo": { object ( |
| Alanlar | |
|---|---|
merchantSignupInfo |
İsteğe bağlı. Bir satıcı sitesi üzerinden bu keşfedilebilir programa kaydolma ve değerli öğe ekleme özelliğiyle ilgili bilgiler. |
merchantSigninInfo |
İsteğe bağlı. Bir satıcı sitesi üzerinden bu keşfedilebilir programa giriş yapma ve değerli öğe ekleme özelliğiyle ilgili bilgiler. |
state |
Yalnızca çıkış. Bulunabilir programın durumu. |
MerchantSignupInfo
| JSON gösterimi |
|---|
{ "signupWebsite": { object ( |
| Alanlar | |
|---|---|
signupWebsite |
İsteğe bağlı. Bulunabilir programa kaydolmak için kullanılan web sitesi. |
signupSharedDatas[] |
İsteğe bağlı. Kayıt web sitesi URL'sine POST isteğiyle gönderilen kullanıcı verileri. Bu bilgiler, satıcının web sitesinin kullanıcıyı keşfedilebilir programa kaydetmek için kullanılan alanları önceden doldurabilmesi amacıyla kodlanıp paylaşılır. |
Uri
| JSON gösterimi |
|---|
{
"uri": string,
"description": string,
"localizedDescription": {
object ( |
| Alanlar | |
|---|---|
uri |
İsteğe bağlı. URI. |
description |
İsteğe bağlı. Google Cüzdan'da metin olarak görünen URI'nin başlığı. |
localizedDescription |
İsteğe bağlı. Google Cüzdan'da metin olarak görünen URI'nin başlığının çevrilmiş dizeleri. |
MerchantSigninInfo
| JSON gösterimi |
|---|
{
"signinWebsite": {
object ( |
| Alanlar | |
|---|---|
signinWebsite |
İsteğe bağlı. Bulunabilir programa kaydolmak için kullanılan web sitesi. |
ClassTemplateInfo
| JSON gösterimi |
|---|
{ "cardBarcodeSectionDetails": { object ( |
| Alanlar | |
|---|---|
cardBarcodeSectionDetails |
İsteğe bağlı. Barkodun üstünde ve altında gösterilecek ek bilgiler. |
cardTemplateOverride |
İsteğe bağlı. Kart görünümü için şablon geçersiz kılma. |
detailsTemplateOverride |
İsteğe bağlı. Ayrıntılar görünümü için şablon geçersiz kılma. |
listTemplateOverride |
İsteğe bağlı. Kart listesi görünümü için şablon geçersiz kılma. |
CardBarcodeSectionDetails
| JSON gösterimi |
|---|
{ "firstTopDetail": { object ( |
| Alanlar | |
|---|---|
firstTopDetail |
İsteğe bağlı. Barkodun üzerinde gösterilecek isteğe bağlı bilgiler. secondTopDetail tanımlanmışsa bu, ayrıntı bölümünün başlangıç tarafında gösterilir. |
firstBottomDetail |
İsteğe bağlı. Barkodun altında gösterilecek isteğe bağlı bilgiler. |
secondTopDetail |
İsteğe bağlı. Barkodun üzerinde gösterilecek isteğe bağlı ikinci bilgi. firstTopDetail tanımlanmışsa bu, ayrıntı bölümünün son tarafında gösterilir. |
BarcodeSectionDetail
| JSON gösterimi |
|---|
{
"fieldSelector": {
object ( |
| Alanlar | |
|---|---|
fieldSelector |
İsteğe bağlı. Gösterilecek mevcut bir metin tabanlı veya resim alanına yapılan referans. |
FieldSelector
| JSON gösterimi |
|---|
{
"fields": [
{
object ( |
| Alanlar | |
|---|---|
fields[] |
İsteğe bağlı. Alan geçersiz kılmalarıyla kullanılacak alan referansları. Birden fazla referans sağlanırsa boş olmayan bir alanı referans veren ilk referans görüntülenir. |
FieldReference
| JSON gösterimi |
|---|
{
"fieldPath": string,
"dateFormat": enum ( |
| Alanlar | |
|---|---|
fieldPath |
İsteğe bağlı. Referans verilen alanın yolu. "object" veya "class" ile başlar ve noktalarla ayrılır. |
dateFormat |
İsteğe bağlı. Tarih/saat alanlarını oluşturmak için kullanılan tarih biçimi. |
CardTemplateOverride
| JSON gösterimi |
|---|
{
"cardRowTemplateInfos": [
{
object ( |
| Alanlar | |
|---|---|
cardRowTemplateInfos[] |
İsteğe bağlı. Kart görünümündeki satırlarla ilgili şablon bilgileri. En fazla üç satır belirtilebilir. |
CardRowTemplateInfo
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
row_template birleşik alanı. Bir, iki veya üç öğe içeren bir satırın şablonu. row_template aşağıdakilerden yalnızca biri olabilir: |
|
oneItem |
İsteğe bağlı. Bir öğe içeren satırın şablonu. |
twoItems |
İsteğe bağlı. İki öğe içeren bir satırın şablonu. |
threeItems |
İsteğe bağlı. Üç öğe içeren bir satırın şablonu. |
CardRowOneItem
| JSON gösterimi |
|---|
{
"item": {
object ( |
| Alanlar | |
|---|---|
item |
İsteğe bağlı. Satırda gösterilecek öğe. Bu öğe ortalanır. |
TemplateItem
| JSON gösterimi |
|---|
{ "firstValue": { object ( |
| Alanlar | |
|---|---|
firstValue |
İsteğe bağlı. Gösterilecek ilk alanın referansı. |
secondValue |
İsteğe bağlı. Gösterilecek ikinci alana yapılan referans. |
predefinedItem |
İsteğe bağlı. Gösterilecek önceden tanımlanmış öğe. |
CardRowTwoItems
| JSON gösterimi |
|---|
{ "startItem": { object ( |
| Alanlar | |
|---|---|
startItem |
İsteğe bağlı. Satırın başında gösterilecek öğe. Bu öğe sola hizalanır. |
endItem |
İsteğe bağlı. Satırın sonunda gösterilecek öğe. Bu öğe sağa hizalanır. |
CardRowThreeItems
| JSON gösterimi |
|---|
{ "startItem": { object ( |
| Alanlar | |
|---|---|
startItem |
İsteğe bağlı. Satırın başında gösterilecek öğe. Bu öğe sola hizalanır. |
middleItem |
İsteğe bağlı. Satırın ortasında gösterilecek öğe. Bu öğe, başlangıç ve bitiş öğeleri arasında ortalanır. |
endItem |
İsteğe bağlı. Satırın sonunda gösterilecek öğe. Bu öğe sağa hizalanır. |
DetailsTemplateOverride
| JSON gösterimi |
|---|
{
"detailsItemInfos": [
{
object ( |
| Alanlar | |
|---|---|
detailsItemInfos[] |
İsteğe bağlı. Ayrıntılar listesinde gösterilen öğelerle ilgili şablon bilgileri. |
DetailsItemInfo
| JSON gösterimi |
|---|
{
"item": {
object ( |
| Alanlar | |
|---|---|
item |
İsteğe bağlı. Ayrıntılar listesinde gösterilecek öğe. |
ListTemplateOverride
| JSON gösterimi |
|---|
{ "firstRowOption": { object ( |
| Alanlar | |
|---|---|
firstRowOption |
İsteğe bağlı. İlk satırda gösterilecek alana yapılan referans. |
secondRowOption |
İsteğe bağlı. İkinci satırda gösterilecek alana yapılan referans. |
FirstRowOption
| JSON gösterimi |
|---|
{ "transitOption": enum ( |
| Alanlar | |
|---|---|
transitOption |
İsteğe bağlı. İlk satırda gösterilecek toplu taşıma seçeneği. |
fieldOption |
İsteğe bağlı. İlk satırda gösterilecek alana yapılan referans. |
GiftCardClass
| JSON gösterimi |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Alanlar | |
|---|---|
id |
İsteğe bağlı. Hediye kartı sınıfının kimliği. |
issuerName |
İsteğe bağlı. Hediye kartı sınıfının veren kuruluş adı. |
localizedIssuerName |
İsteğe bağlı. Hediye kartı sınıfının yerelleştirilmiş veren kuruluş adı. |
merchantName |
İsteğe bağlı. Hediye kartı sınıfının satıcı adı. |
localizedMerchantName |
İsteğe bağlı. Hediye kartı sınıfının yerelleştirilmiş satıcı adı. |
programLogoUri |
İsteğe bağlı. Hediye kartı sınıfının program logosu. |
hexBackgroundColor |
İsteğe bağlı. Hediye kartı sınıfının arka plan rengi. Biçim, onaltılık renk dizesidir (ör. "#RRGGBB"). |
heroImageUri |
İsteğe bağlı. Hediye kartı sınıfının ön yüzünde gösterilen banner resmi. |
homePageUri |
İsteğe bağlı. Uygulamanın ana sayfasının web sitesi. |
classTemplateInfo |
İsteğe bağlı. Hediye kartı sınıfının nasıl gösterilmesi gerektiğiyle ilgili şablon bilgileri. |
OfferClass
| JSON gösterimi |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Alanlar | |
|---|---|
id |
İsteğe bağlı. Teklif sınıfının kimliği. |
issuerName |
İsteğe bağlı. Teklif sınıfının veren kuruluş adı. |
localizedIssuerName |
İsteğe bağlı. Teklif sınıfının yerelleştirilmiş yayıncı adı. |
provider |
İsteğe bağlı. Teklif sınıfının sağlayıcısı. |
localizedProvider |
İsteğe bağlı. Teklif sınıfının yerelleştirilmiş sağlayıcısı. |
title |
İsteğe bağlı. Teklif sınıfının başlığı. |
localizedTitle |
İsteğe bağlı. Teklif sınıfının yerelleştirilmiş başlığı. |
titleImageUri |
İsteğe bağlı. Teklif sınıfının başlık resmi. |
hexBackgroundColor |
İsteğe bağlı. Fırsat sınıfının arka plan rengi. Biçim, onaltılık renk dizesidir (ör. "#RRGGBB"). |
heroImageUri |
İsteğe bağlı. Fırsat sınıfının ön yüzünde gösterilen banner resmi. |
redemptionChannel |
İsteğe bağlı. Teklif sınıfının kullanıldığı kanal. |
classTemplateInfo |
İsteğe bağlı. Fırsat sınıfının nasıl gösterileceğiyle ilgili şablon bilgileri. |
EventTicketClass
| JSON gösterimi |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Alanlar | |
|---|---|
id |
İsteğe bağlı. Etkinlik bileti sınıfının kimliği. |
issuerName |
İsteğe bağlı. Etkinlik bileti sınıfının veren kuruluş adı. |
localizedIssuerName |
İsteğe bağlı. Etkinlik bileti sınıfının yerelleştirilmiş yayıncı adı. |
logoUri |
İsteğe bağlı. Etkinlik bileti sınıfının logosu. |
eventName |
İsteğe bağlı. Etkinliğin adı. |
venue |
İsteğe bağlı. Etkinliğin düzenleneceği yer. |
dateTime |
İsteğe bağlı. Etkinliğin tarihi ve saatiyle ilgili bilgiler. |
hexBackgroundColor |
İsteğe bağlı. Etkinlik bileti sınıfının arka plan rengi. Biçim, onaltılık renk dizesidir (ör. "#RRGGBB"). |
heroImageUri |
İsteğe bağlı. Etkinlik bileti sınıfının ön yüzünde gösterilen banner resmi. |
classTemplateInfo |
İsteğe bağlı. Etkinlik bileti sınıfının nasıl gösterilmesi gerektiğiyle ilgili şablon bilgileri. |
EventVenue
| JSON gösterimi |
|---|
{ "name": { object ( |
| Alanlar | |
|---|---|
name |
İsteğe bağlı. Yerin adı. |
address |
İsteğe bağlı. Mekanın adresi. |
EventDateTime
| JSON gösterimi |
|---|
{ "start": string, "end": string } |
| Alanlar | |
|---|---|
start |
İsteğe bağlı. Etkinliğin başladığı tarih/saat. Etkinlik birden fazla gün sürüyorsa ilk günün başlangıç tarihi/saati olmalıdır. Biçim, ISO 8601 genişletilmiş biçiminde bir tarih/saat olup saat farkı içermez.Saat, milisaniye hassasiyetinde belirtilebilir (ör. 2027-03-05T06:30:00). |
end |
İsteğe bağlı. Etkinliğin sona erdiği tarih/saat. Etkinlik birden fazla gün sürüyorsa son günün bitiş tarihi/saati olmalıdır. Biçim, ISO 8601 genişletilmiş biçiminde bir tarih/saat olup saat farkı içermez.Saat, milisaniye hassasiyetinde belirtilebilir (ör. 2027-03-05T06:30:00). |
FlightClass
| JSON gösterimi |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Alanlar | |
|---|---|
id |
İsteğe bağlı. Uçuş sınıfının kimliği. |
issuerName |
İsteğe bağlı. Uçuş sınıfının düzenleyen adı. |
localizedIssuerName |
İsteğe bağlı. Uçuş sınıfının yerelleştirilmiş düzenleyen adı. |
flightHeader |
İsteğe bağlı. Uçuş taşıyıcısı ve numarasıyla ilgili bilgiler. |
origin |
İsteğe bağlı. Kalkış havaalanı hakkında bilgiler. |
destination |
İsteğe bağlı. Varış havaalanı hakkında bilgiler. |
localScheduledDepartureDateTime |
İsteğe bağlı. Uçağın kapıdan (pistten değil) kalkması beklenen planlanmış tarih ve saat. Biçim, ISO 8601 genişletilmiş biçiminde bir tarih/saat olup saat farkı içermez.Saat, milisaniye hassasiyetinde belirtilebilir (ör. 2027-03-05T06:30:00). Bu, havaalanındaki yerel tarih/saat olmalıdır (UTC saati değil). |
hexBackgroundColor |
İsteğe bağlı. Uçuş sınıfının arka plan rengi. Biçim, onaltılık renk dizesidir (ör. "#RRGGBB"). |
heroImageUri |
İsteğe bağlı. Uçuş sınıfının önünde gösterilen banner resmi. |
classTemplateInfo |
İsteğe bağlı. Uçuş sınıfının nasıl gösterilmesi gerektiğiyle ilgili şablon bilgileri. |
FlightHeader
| JSON gösterimi |
|---|
{
"carrier": {
object ( |
| Alanlar | |
|---|---|
carrier |
İsteğe bağlı. Uçuş operatörüyle ilgili bilgiler. |
flightNumber |
İsteğe bağlı. Hava yolu şirketinin IATA kodu olmadan uçuş numarası. Alan yalnızca rakam içeriyor (ör. "123"). |
FlightCarrier
| JSON gösterimi |
|---|
{ "carrierIataCode": string, "carrierIcaoCode": string, "airlineLogoUri": string } |
| Alanlar | |
|---|---|
carrierIataCode |
İsteğe bağlı. Hava yolu şirketinin iki karakterlik IATA hava yolu kodu. |
carrierIcaoCode |
İsteğe bağlı. Hava yolu şirketinin üç karakterli ICAO kodu. |
airlineLogoUri |
İsteğe bağlı. Hava yolu şirketinin logosu (taşıyıcı IATA koduyla açıklanır). |
AirportInfo
| JSON gösterimi |
|---|
{ "airportIataCode": string, "terminal": string, "gate": string } |
| Alanlar | |
|---|---|
airportIataCode |
İsteğe bağlı. Üç karakterlik IATA havaalanı kodu (ör. "SFO"). |
terminal |
İsteğe bağlı. Terminal adı (ör. "I"). |
gate |
İsteğe bağlı. Kapı adı (ör. "B59"). |
TransitClass
| JSON gösterimi |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Alanlar | |
|---|---|
id |
İsteğe bağlı. Toplu taşıma sınıfının kimliği. |
issuerName |
İsteğe bağlı. Toplu taşıma kartının veren kuruluş adı. |
localizedIssuerName |
İsteğe bağlı. Toplu taşıma sınıfının yerelleştirilmiş veren adı. |
hexBackgroundColor |
İsteğe bağlı. Toplu taşıma kartının arka plan rengi. Biçim, onaltılık renk dizesidir (ör. "#RRGGBB"). |
heroImageUri |
İsteğe bağlı. Toplu taşıma kartının ön yüzünde gösterilen banner resmi. |
transitType |
İsteğe bağlı. Toplu taşıma kartının toplu taşıma türü. |
classTemplateInfo |
İsteğe bağlı. Toplu taşıma kartının nasıl gösterilmesi gerektiğiyle ilgili şablon bilgileri. |
GenericClass
| JSON gösterimi |
|---|
{
"id": string,
"classTemplateInfo": {
object ( |
| Alanlar | |
|---|---|
id |
İsteğe bağlı. Genel sınıfın kimliği. |
classTemplateInfo |
İsteğe bağlı. Genel sınıfın nasıl gösterilmesi gerektiğiyle ilgili şablon bilgileri. |
Araç Ek Açıklamaları
Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌