Outil : list_pass_classes
Récupère une liste complète de toutes les classes de cartes enregistrées dans la console d'entreprise Google Wallet associées à l'utilisateur authentifié. Cet outil fournit des informations essentielles aux développeurs qui gèrent des cartes Wallet, comme des cartes de fidélité, des cartes cadeaux ou des cartes de vol.
L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP list_pass_classes.
| Requête 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 }' |
Schéma d'entrée
Message de requête pour lister les classes de pass d'un émetteur.
ListPassClassesRequest
| Représentation JSON |
|---|
{ "issuerId": string, "passType": enum ( |
| Champs | |
|---|---|
issuerId |
Obligatoire. Identifiant unique de l'émetteur pour lequel lister les classes de cartes. |
passType |
Facultatif. Type de classe de carte à lister. Si aucune valeur n'est spécifiée, tous les types de classes de pass sont renvoyés. |
view |
Facultatif. Spécifie le niveau de détail à renvoyer pour chaque classe de pass. |
PassType
Type de classe de carte.
| Enums | |
|---|---|
PASS_TYPE_UNSPECIFIED |
Le type de carte n'est pas spécifié. |
LOYALTY |
Le type de carte est "Fidélité". |
GIFT_CARD |
Le type de carte est "Carte cadeau". |
OFFER |
Le type de carte est "Offre". |
EVENT_TICKET |
Le type de carte est "Billet d'événement". |
FLIGHT |
Le type de carte est "Vol". |
TRANSIT |
Le type de carte est "Transport". |
GENERIC |
Le type de carte est "Générique". |
PassClassView
Niveau de détail à renvoyer pour chaque classe de pass.
| Enums | |
|---|---|
PASS_CLASS_VIEW_UNSPECIFIED |
Valeur par défaut / non définie. L'API affichera par défaut la vue BASIC. |
BASIC |
Incluez des informations de base sur la classe de pass. |
FULL |
Incluez tous les détails sur la classe de pass. |
Schéma de sortie
Message de réponse pour la liste des classes de pass d'un émetteur.
ListPassClassesResponse
| Représentation JSON |
|---|
{
"passClasses": [
{
object ( |
| Champs | |
|---|---|
passClasses[] |
Classes de cartes de l'émetteur. |
PassClass
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union
|
|
loyaltyClass |
Facultatif. Classe de fidélité de l'émetteur. |
giftCardClass |
Facultatif. Classe de carte cadeau de l'émetteur. |
offerClass |
Facultatif. Classe d'offre de l'émetteur. |
eventTicketClass |
Facultatif. Classe de billets pour un événement de l'émetteur. |
flightClass |
Facultatif. Classe de vol de l'émetteur. |
transitClass |
Facultatif. Classe de transports en commun de l'émetteur. |
genericClass |
Facultatif. Classe générique de l'émetteur. |
LoyaltyClass
| Représentation JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Champs | |
|---|---|
id |
Facultatif. ID de la classe de fidélité. |
issuerName |
Facultatif. Nom de l'émetteur de la classe de fidélité. |
localizedIssuerName |
Facultatif. Nom localisé de l'émetteur de la classe de fidélité. |
programName |
Facultatif. Nom du programme de la classe de fidélité. |
localizedProgramName |
Facultatif. Nom localisé du programme de fidélité. |
programLogoUri |
Facultatif. Logo du programme de fidélité. |
hexBackgroundColor |
Facultatif. Couleur d'arrière-plan de la classe de fidélité. Le format est une chaîne de couleur hexadécimale, par exemple "#RRGGBB". |
heroImageUri |
Facultatif. Image de bannière affichée à l'avant de la classe de fidélité. |
discoverableProgram |
Facultatif. Informations sur la façon dont la classe de fidélité peut être découverte et instanciée dans Google Wallet. |
classTemplateInfo |
Facultatif. Informations du modèle sur la façon dont la classe de fidélité doit être affichée. |
LocalizedString
| Représentation JSON |
|---|
{ "translatedValues": [ { object ( |
| Champs | |
|---|---|
translatedValues[] |
Facultatif. Chaînes traduites pour la chaîne. |
defaultValue |
Facultatif. Chaîne à afficher si aucune traduction appropriée n'est disponible. |
TranslatedString
| Représentation JSON |
|---|
{ "languageCode": string, "value": string } |
| Champs | |
|---|---|
languageCode |
Facultatif. Tag de langue BCP 47. Exemples de valeurs : "en-US", "en-GB", "de" ou "de-AT". |
value |
Facultatif. Chaîne traduite encodée en UTF-8. |
DiscoverableProgram
| Représentation JSON |
|---|
{ "merchantSignupInfo": { object ( |
| Champs | |
|---|---|
merchantSignupInfo |
Facultatif. Informations sur la possibilité de s'inscrire et d'ajouter un avantage à ce programme détectable sur le site d'un marchand. |
merchantSigninInfo |
Facultatif. Informations sur la possibilité de se connecter et d'ajouter un avantage pour ce programme détectable sur le site d'un marchand. |
state |
Uniquement en sortie. État du programme visible. |
MerchantSignupInfo
| Représentation JSON |
|---|
{ "signupWebsite": { object ( |
| Champs | |
|---|---|
signupWebsite |
Facultatif. Site Web permettant de s'inscrire au programme visible. |
signupSharedDatas[] |
Facultatif. Données utilisateur envoyées dans une requête POST à l'URL du site Web d'inscription. Ces informations sont encodées, puis partagées afin que le site Web du marchand puisse préremplir les champs utilisés pour inscrire l'utilisateur au programme de découverte. |
URI
| Représentation JSON |
|---|
{
"uri": string,
"description": string,
"localizedDescription": {
object ( |
| Champs | |
|---|---|
uri |
Facultatif. URI. |
description |
Facultatif. Titre de l'URI qui apparaît dans Google Wallet sous forme de texte. |
localizedDescription |
Facultatif. Chaînes traduites du titre de l'URI qui apparaît dans Google Wallet sous forme de texte. |
MerchantSigninInfo
| Représentation JSON |
|---|
{
"signinWebsite": {
object ( |
| Champs | |
|---|---|
signinWebsite |
Facultatif. Site Web permettant de se connecter au programme visible. |
ClassTemplateInfo
| Représentation JSON |
|---|
{ "cardBarcodeSectionDetails": { object ( |
| Champs | |
|---|---|
cardBarcodeSectionDetails |
Facultatif. Informations supplémentaires à afficher au-dessus et en dessous du code-barres. |
cardTemplateOverride |
Facultatif. Remplacement du modèle pour la vue Fiche. |
detailsTemplateOverride |
Facultatif. Remplacement du modèle pour la vue Détails. |
listTemplateOverride |
Facultatif. Remplacement du modèle pour la vue Liste des cartes. |
CardBarcodeSectionDetails
| Représentation JSON |
|---|
{ "firstTopDetail": { object ( |
| Champs | |
|---|---|
firstTopDetail |
Facultatif. Informations facultatives à afficher au-dessus du code-barres. Si secondTopDetail est défini, il s'affiche au début de cette section d'informations. |
firstBottomDetail |
Facultatif. Informations facultatives à afficher sous le code-barres. |
secondTopDetail |
Facultatif. Deuxième information facultative à afficher au-dessus du code-barres. Si firstTopDetail est défini, il s'affiche à la fin de cette section d'informations. |
BarcodeSectionDetail
| Représentation JSON |
|---|
{
"fieldSelector": {
object ( |
| Champs | |
|---|---|
fieldSelector |
Facultatif. Référence à un champ de texte ou d'image existant à afficher. |
FieldSelector
| Représentation JSON |
|---|
{
"fields": [
{
object ( |
| Champs | |
|---|---|
fields[] |
Facultatif. Références de champ à utiliser avec les remplacements de champ. Si plusieurs références sont fournies, la première qui fait référence à un champ non vide sera affichée. |
FieldReference
| Représentation JSON |
|---|
{
"fieldPath": string,
"dateFormat": enum ( |
| Champs | |
|---|---|
fieldPath |
Facultatif. Chemin d'accès au champ référencé, précédé de "object" ou "class" et séparé par des points. |
dateFormat |
Facultatif. Format de date pour afficher les champs de date/heure. |
CardTemplateOverride
| Représentation JSON |
|---|
{
"cardRowTemplateInfos": [
{
object ( |
| Champs | |
|---|---|
cardRowTemplateInfos[] |
Facultatif. Informations sur les lignes du modèle dans la vue Carte. Vous pouvez spécifier un maximum de trois lignes. |
CardRowTemplateInfo
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union row_template. Modèle pour une ligne contenant un, deux ou trois éléments. row_template ne peut être qu'un des éléments suivants : |
|
oneItem |
Facultatif. Modèle pour une ligne contenant un élément. |
twoItems |
Facultatif. Modèle pour une ligne contenant deux éléments. |
threeItems |
Facultatif. Modèle pour une ligne contenant trois éléments. |
CardRowOneItem
| Représentation JSON |
|---|
{
"item": {
object ( |
| Champs | |
|---|---|
item |
Facultatif. Élément à afficher dans la ligne. Cet élément sera centré. |
TemplateItem
| Représentation JSON |
|---|
{ "firstValue": { object ( |
| Champs | |
|---|---|
firstValue |
Facultatif. Référence au premier champ à afficher. |
secondValue |
Facultatif. Référence au deuxième champ à afficher. |
predefinedItem |
Facultatif. Élément prédéfini à afficher. |
CardRowTwoItems
| Représentation JSON |
|---|
{ "startItem": { object ( |
| Champs | |
|---|---|
startItem |
Facultatif. Élément à afficher au début de la ligne. Cet élément sera aligné à gauche. |
endItem |
Facultatif. Élément à afficher à la fin de la ligne. Cet élément sera aligné à droite. |
CardRowThreeItems
| Représentation JSON |
|---|
{ "startItem": { object ( |
| Champs | |
|---|---|
startItem |
Facultatif. Élément à afficher au début de la ligne. Cet élément sera aligné à gauche. |
middleItem |
Facultatif. Élément à afficher au milieu de la ligne. Cet élément sera centré entre les éléments de début et de fin. |
endItem |
Facultatif. Élément à afficher à la fin de la ligne. Cet élément sera aligné à droite. |
DetailsTemplateOverride
| Représentation JSON |
|---|
{
"detailsItemInfos": [
{
object ( |
| Champs | |
|---|---|
detailsItemInfos[] |
Facultatif. Informations sur le modèle concernant les éléments affichés dans la liste des détails. |
DetailsItemInfo
| Représentation JSON |
|---|
{
"item": {
object ( |
| Champs | |
|---|---|
item |
Facultatif. Élément à afficher dans la liste des détails. |
ListTemplateOverride
| Représentation JSON |
|---|
{ "firstRowOption": { object ( |
| Champs | |
|---|---|
firstRowOption |
Facultatif. Référence au champ à afficher dans la première ligne. |
secondRowOption |
Facultatif. Référence au champ à afficher sur la deuxième ligne. |
FirstRowOption
| Représentation JSON |
|---|
{ "transitOption": enum ( |
| Champs | |
|---|---|
transitOption |
Facultatif. Option de transport en commun à afficher dans la première ligne. |
fieldOption |
Facultatif. Référence au champ à afficher dans la première ligne. |
GiftCardClass
| Représentation JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Champs | |
|---|---|
id |
Facultatif. ID de la classe de carte cadeau. |
issuerName |
Facultatif. Nom de l'émetteur de la classe de carte cadeau. |
localizedIssuerName |
Facultatif. Nom localisé de l'émetteur de la classe de cartes cadeaux. |
merchantName |
Facultatif. Nom du marchand de la classe de cartes cadeaux. |
localizedMerchantName |
Facultatif. Nom localisé du marchand de la catégorie de cartes. |
programLogoUri |
Facultatif. Logo du programme de la classe de carte. |
hexBackgroundColor |
Facultatif. Couleur d'arrière-plan de la classe de carte cadeau. Le format est une chaîne de couleur hexadécimale, par exemple "#RRGGBB". |
heroImageUri |
Facultatif. Image de bannière affichée sur le recto de la carte cadeau. |
homePageUri |
Facultatif. Site Web de la page d'accueil de l'application. |
classTemplateInfo |
Facultatif. Informations du modèle sur la façon dont la classe de la carte cadeau doit être affichée. |
OfferClass
| Représentation JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Champs | |
|---|---|
id |
Facultatif. Identifiant de la classe d'offre. |
issuerName |
Facultatif. Nom de l'émetteur de la classe d'offre. |
localizedIssuerName |
Facultatif. Nom de l'émetteur localisé de la classe d'offre. |
provider |
Facultatif. Fournisseur de la classe d'offre. |
localizedProvider |
Facultatif. Fournisseur localisé de la classe d'offre. |
title |
Facultatif. Titre de la classe d'offres. |
localizedTitle |
Facultatif. Titre localisé de la classe d'offre. |
titleImageUri |
Facultatif. Image de titre de la classe d'offre. |
hexBackgroundColor |
Facultatif. Couleur d'arrière-plan de la classe d'offre. Le format est une chaîne de couleur hexadécimale, par exemple "#RRGGBB". |
heroImageUri |
Facultatif. Image de bannière affichée sur la page de l'offre. |
redemptionChannel |
Facultatif. Canal d'utilisation de la classe d'offre. |
classTemplateInfo |
Facultatif. Informations du modèle sur la façon dont la classe d'offre doit être affichée. |
EventTicketClass
| Représentation JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Champs | |
|---|---|
id |
Facultatif. ID de la classe de billets pour des événements. |
issuerName |
Facultatif. Nom de l'émetteur de la classe de billets pour un événement. |
localizedIssuerName |
Facultatif. Nom de l'émetteur localisé de la classe de billets pour un événement. |
logoUri |
Facultatif. Logo de la classe de billets pour un événement. |
eventName |
Facultatif. Nom de l'événement. |
venue |
Facultatif. Lieu de l'événement. |
dateTime |
Facultatif. Informations sur la date et l'heure de l'événement. |
hexBackgroundColor |
Facultatif. Couleur d'arrière-plan de la classe de billets pour des événements. Le format est une chaîne de couleur hexadécimale, par exemple "#RRGGBB". |
heroImageUri |
Facultatif. Image de bannière affichée sur le devant de la classe de billets pour un événement. |
classTemplateInfo |
Facultatif. Informations sur le modèle indiquant comment la classe de billets pour un événement doit être affichée. |
EventVenue
| Représentation JSON |
|---|
{ "name": { object ( |
| Champs | |
|---|---|
name |
Facultatif. Nom du lieu. |
address |
Facultatif. Adresse du lieu. |
EventDateTime
| Représentation JSON |
|---|
{ "start": string, "end": string } |
| Champs | |
|---|---|
start |
Facultatif. Date et heure de début de l'événement. S'il s'étend sur plusieurs jours, il doit s'agir de la date et de l'heure de début du premier jour. Le format est une date/heure au format étendu ISO 8601 sans décalage. L'heure peut être spécifiée avec une précision allant jusqu'à la milliseconde (par exemple, 2027-03-05T06:30:00). |
end |
Facultatif. Date et heure de fin de l'événement. Si l'événement se déroule sur plusieurs jours, il s'agit de la date et de l'heure de fin du dernier jour. Le format est une date/heure au format étendu ISO 8601 sans décalage. L'heure peut être spécifiée avec une précision allant jusqu'à la milliseconde (par exemple, 2027-03-05T06:30:00). |
FlightClass
| Représentation JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Champs | |
|---|---|
id |
Facultatif. Identifiant de la classe de vol. |
issuerName |
Facultatif. Nom de l'émetteur de la classe de vol. |
localizedIssuerName |
Facultatif. Nom localisé de l'émetteur de la classe de vol. |
flightHeader |
Facultatif. Informations sur la compagnie aérienne et le numéro de vol |
origin |
Facultatif. Informations sur l'aéroport de départ. |
destination |
Facultatif. Informations sur l'aéroport de destination. |
localScheduledDepartureDateTime |
Facultatif. Date et heure prévues du départ de l'avion de la porte d'embarquement (et non de la piste). Le format est une date/heure au format étendu ISO 8601 sans décalage. L'heure peut être spécifiée avec une précision allant jusqu'à la milliseconde (par exemple, 2027-03-05T06:30:00). Il doit s'agir de la date et de l'heure locales à l'aéroport (et non d'une heure UTC). |
hexBackgroundColor |
Facultatif. Couleur d'arrière-plan de la classe de vol. Le format est une chaîne de couleur hexadécimale, par exemple "#RRGGBB". |
heroImageUri |
Facultatif. Image de bannière affichée sur la page d'accueil du cours de vol. |
classTemplateInfo |
Facultatif. Informations du modèle sur la façon dont la classe de vol doit être affichée. |
FlightHeader
| Représentation JSON |
|---|
{
"carrier": {
object ( |
| Champs | |
|---|---|
carrier |
Facultatif. Informations sur la compagnie aérienne. |
flightNumber |
Facultatif. Numéro de vol sans le code IATA de la compagnie aérienne. Le champ ne contient que des chiffres (par exemple, "123"). |
FlightCarrier
| Représentation JSON |
|---|
{ "carrierIataCode": string, "carrierIcaoCode": string, "airlineLogoUri": string } |
| Champs | |
|---|---|
carrierIataCode |
Facultatif. Code IATA à deux caractères de la compagnie aérienne. |
carrierIcaoCode |
Facultatif. Code OACI à trois caractères de la compagnie aérienne. |
airlineLogoUri |
Facultatif. Logo de la compagnie aérienne décrit par le code IATA du transporteur. |
AirportInfo
| Représentation JSON |
|---|
{ "airportIataCode": string, "terminal": string, "gate": string } |
| Champs | |
|---|---|
airportIataCode |
Facultatif. Code IATA de l'aéroport à trois caractères (par exemple, "SFO"). |
terminal |
Facultatif. Nom du terminal, par exemple "I". |
gate |
Facultatif. Nom de la porte, par exemple "B59". |
TransitClass
| Représentation JSON |
|---|
{ "id": string, "issuerName": string, "localizedIssuerName": { object ( |
| Champs | |
|---|---|
id |
Facultatif. Identifiant de la classe de transport en commun. |
issuerName |
Facultatif. Nom de l'émetteur de la classe de transport en commun. |
localizedIssuerName |
Facultatif. Nom localisé de l'émetteur de la classe de transport en commun. |
hexBackgroundColor |
Facultatif. Couleur d'arrière-plan de la classe de transport en commun. Le format est une chaîne de couleur hexadécimale, par exemple "#RRGGBB". |
heroImageUri |
Facultatif. Image de bannière affichée à l'avant de la classe de transit. |
transitType |
Facultatif. Type de transport en commun de la classe de transport en commun. |
classTemplateInfo |
Facultatif. Informations du modèle sur la façon dont la classe de transport doit être affichée. |
GenericClass
| Représentation JSON |
|---|
{
"id": string,
"classTemplateInfo": {
object ( |
| Champs | |
|---|---|
id |
Facultatif. ID de la classe générique. |
classTemplateInfo |
Facultatif. Informations du modèle sur la façon dont la classe générique doit être affichée. |
| Enums | |
|---|---|
SHARED_DATA_TYPE_UNSPECIFIED |
|
FIRST_NAME |
Nom d'utilisateur. |
LAST_NAME |
|
STREET_ADDRESS |
Adresse de l'utilisateur sur une seule ligne. |
ADDRESS_LINE_ONE |
Adresse de l'utilisateur sur plusieurs lignes. |
ADDRESS_LINE_TWO |
|
ADDRESS_LINE_THREE |
|
CITY |
|
STATE |
|
ZIPCODE |
|
COUNTRY |
|
EMAIL |
|
PHONE |
|
État
État du programme visible.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
L'état n'est pas spécifié. |
TRUSTED_TESTERS |
Le programme n'est visible que par les testeurs ayant accès au compte de l'émetteur. |
LIVE |
Le programme est visible par tous les utilisateurs. |
DISABLED |
Le programme n'est pas visible. |
DateFormat
Format de date pour afficher les champs de date/heure.
| Enums | |
|---|---|
DATE_FORMAT_UNSPECIFIED |
Le format de date n'est pas spécifié. |
DATE_TIME |
Par exemple, 2018-12-14T13:00:00 s'affiche sous la forme "14 déc. 13:00" en français. |
DATE_ONLY |
Par exemple, 2018-12-14T13:00:00 s'affiche sous la forme "14 déc." dans la langue en_US. |
TIME_ONLY |
Par exemple, 2018-12-14T13:00:00 s'affiche sous la forme "13:00" dans fr_FR. |
DATE_TIME_YEAR |
Par exemple, 2018-12-14T13:00:00 s'affiche sous la forme "14 déc. 2018, 13:00" en français. |
DATE_YEAR |
Par exemple, 2018-12-14T13:00:00 s'affiche sous la forme "14 déc. 2018" en français. |
YEAR_MONTH |
Par exemple, 2018-12-14T13:00:00 s'affiche sous la forme 2018-12 dans en_US. |
YEAR_MONTH_DAY |
Par exemple, 2018-12-14T13:00:00 s'affiche sous la forme 2018-12-14 en anglais (États-Unis). |
PredefinedItem
Élément prédéfini à afficher.
| Enums | |
|---|---|
PREDEFINED_ITEM_UNSPECIFIED |
L'élément prédéfini n'est pas spécifié. |
FREQUENT_FLYER_PROGRAM_NAME_AND_NUMBER |
L'élément prédéfini est un nom et un numéro de programme de fidélité. |
FLIGHT_NUMBER_AND_OPERATING_FLIGHT_NUMBER |
L'élément prédéfini est un numéro de vol et un numéro de vol opérationnel. |
TransitOption
Option de transport en commun à afficher.
| Enums | |
|---|---|
TRANSIT_OPTION_UNSPECIFIED |
L'option de transport en commun n'est pas spécifiée. |
ORIGIN_AND_DESTINATION_NAMES |
L'option de transit correspond aux noms de l'origine et de la destination. |
ORIGIN_AND_DESTINATION_CODES |
L'option de transit correspond aux codes d'origine et de destination. |
ORIGIN_NAME |
L'option de transit correspond au nom de l'origine. |
RedemptionChannel
Canaux d'utilisation applicables à cette offre.
| Enums | |
|---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
Le canal d'échange n'est pas spécifié. |
IN_STORE |
L'offre ne peut être utilisée qu'en magasin. |
ONLINE |
L'offre ne peut être utilisée qu'en ligne. |
BOTH |
L'offre peut être utilisée en magasin ou en ligne. |
TEMPORARY_PRICE_REDUCTION |
L'offre est une réduction de prix temporaire. |
TransitType
Type de transport en commun de la classe de transport en commun.
| Enums | |
|---|---|
TRANSIT_TYPE_UNSPECIFIED |
Le type de transport en commun n'est pas spécifié. |
BUS |
Le type de transport en commun est "bus". |
RAIL |
Le type de transport en commun est "train". |
TRAM |
Le type de transport en commun est "tramway". |
FERRY |
Le type de transport en commun est "ferry". |
FLIGHT |
Le type de transport en commun est "vol". |
OTHER |
Le type de transport en commun est "Autre". |
Annotations d'outils
Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌