Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Plantilla de entrada para evento

Las entradas para eventos admiten la renderización de plantillas. Si no se define ninguna plantilla, se usa la predeterminada.

Definición de la plantilla

Una plantilla de pase se define a nivel de la clase y se usa para mostrar cualquier objeto asociado a la clase. La plantilla define qué campos se mostrarán en las diferentes secciones del pase.

La plantilla se divide en las siguientes secciones:

Android

Descripción general de las secciones y posiciones del diseño de la plantilla de pase

Web

Título de la tarjeta

Android

Título de la tarjeta predeterminada

class.logo
class.localizedIssuerName
o class.issuerName
class.eventName
class.venue.name
object.hexBackgroundColor
o class.hexBackgroundColor

Título de la tarjeta con logotipo ancho

class.wideLogo
class.eventName
class.venue.name
object.hexBackgroundColor
o class.hexBackgroundColor

Web

Título de la tarjeta predeterminada

class.logo
class.localizedIssuerName
o class.issuerName
class.eventName
class.venue.name
object.hexBackgroundColor
o class.hexBackgroundColor

Título de la tarjeta con logotipo ancho

class.wideLogo
class.eventName
class.venue.name
object.hexBackgroundColor
o class.hexBackgroundColor

En la sección del título de la tarjeta, se muestran el logotipo, el nombre del evento y el lugar del evento. No se pueden cambiar las referencias de campo que se usan para completarlos ni su posición.

Cuando se configura el campo del logotipo ancho, en los dispositivos Android, el encabezado de la plantilla predeterminada con el logotipo y el nombre del emisor se reemplaza por el logotipo ancho.

Sigue los lineamientos de imagen de logotipo ancho cuando crees el logotipo ancho del encabezado para mostrar de forma óptima tu imagen en los pases.

Plantilla de tarjeta

Android

Web

La sección de la plantilla de tarjeta se usa para mostrar filas adicionales. Estas filas pueden contener campos de datos estructurados basados en texto o campos de módulos de texto.

Puedes especificar la cantidad de filas que definen la cantidad de objetos en la lista class.classTemplateInfo.cardTemplateOverride.cardRowTemplateInfos[]. La lista requiere al menos un elemento y recomendamos usar como máximo dos. Cada elemento debe ser de uno de los siguientes tipos:

oneItem, que acepta un elemento:
- item
twoItems, que acepta dos elementos:
- startItem
- endItem
threeItems, que acepta tres elementos:
- startItem
- middleItem
- endItem

Cada elemento se puede definir como un solo selector de campo (.firstValue), dos selectores de campo (.firstValue y .secondValue) o un elemento predefinido (.predefinedItem). Se muestran los valores del campo seleccionado y sus etiquetas respectivas. Cuando defines dos selectores de campo, los valores de los campos seleccionados se muestran con un separador "/". Lo mismo sucede con las etiquetas de los campos seleccionados. Los elementos predefinidos se usan para definir una renderización más compleja.

En la siguiente muestra de código, se muestra cómo anular las secciones de filas de la tarjeta de plantilla de tarjeta para especificar dos filas. Cada fila incluye tres elementos que hacen referencia a seis campos personalizados textModuleData a nivel de la clase y sus encabezados como etiquetas:

Python

 {
   ... //Rest of class
   "textModulesData": [
        {
            "header": "Label 1",
            "body": "Some info 1",
            "id": "myfield1"
        },
        {
            "header": "Label 2",
            "body": "Some info 2",
            "id": "myfield2"
        },
        {
            "header": "Label 3",
            "body": "Some info 3",
            "id": "myfield3"
        },
        {
            "header": "Label 4",
            "body": "Some info 4",
            "id": "myfield4"
        },
        {
            "header": "Label 5",
            "body": "Some info 5",
            "id": "myfield5"
        },
        {
            "header": "Label 6",
            "body": "Some info 6",
            "id": "myfield6"
        }
    ],
   "classTemplateInfo": {
        "cardTemplateOverride": {
            "cardRowTemplateInfos": [{
                "threeItems": {
                    "startItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield1']"
                            }]
                        }
                    },
                    "middleItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield2']"
                            }]
                        }
                    },
                    "endItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield3']"
                            }]
                        }
                    },
                }
            },{
                "threeItems": {
                    "startItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield4']"
                            }]
                        }
                    },
                    "middleItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield5']"
                            }]
                        }
                    },
                    "endItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield6']"
                            }]
                        }
                    },
                }
            }]
        }
    }
}

Java

// Rest of class
  .setTextModulesData((new ArrayList<TextModuleData>() {
    {
      add((new TextModuleData()).setHeader("Label 1")
        .setBody("Some info 1")
        .setId("myfield1"));
      add((new TextModuleData()).setHeader("Label 2")
        .setBody("Some info 1")
        .setId("myfield2"));
      add((new TextModuleData()).setHeader("Label 3")
        .setBody("Some info 3")
        .setId("myfield3"));
      add((new TextModuleData()).setHeader("Label 4")
        .setBody("Some info 4")
        .setId("myfield4"));
      add((new TextModuleData()).setHeader("Label 5")
        .setBody("Some info 5")
        .setId("myfield5"));
      add((new TextModuleData()).setHeader("Label 6")
        .setBody("Some info 5")
        .setId("myfield6"));
    }
  }))
  .setClassTemplateInfo((new ClassTemplateInfo())
    .setCardTemplateOverride((new CardTemplateOverride())
      .setCardRowTemplateInfos(new ArrayList<CardRowTemplateInfo>() {
        {
          add((new CardRowTemplateInfo()).setThreeItems((new CardRowThreeItems())
            .setStartItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield1']"));
              }
            })))
            .setMiddleItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield2']"));
              }
            })))
            .setEndItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield3']"));
              }
            })))
          ));
          add((new CardRowTemplateInfo()).setThreeItems((new CardRowThreeItems())
            .setStartItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield4']"));
              }
            })))
            .setMiddleItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield5']"));
              }
            })))
            .setEndItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield6']"));
              }
            })))
          ));
          }
  })))

PHP

// Rest of class
    $textModulesData1 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData1->setBody("Some info 1");
    $textModulesData1->setHeader("Label 1");
    $textModulesData1->setId("myfield1");

    $textModulesData2 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData2->setBody("Some info 2");
    $textModulesData2->setHeader("Label 2");
    $textModulesData2->setId("myfield2");

    $textModulesData3 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData3->setBody("Some info 3");
    $textModulesData3->setHeader("Label 3");
    $textModulesData3->setId("myfield3");

    $textModulesData4 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData4->setBody("Some info 4");
    $textModulesData4->setHeader("Label 4");
    $textModulesData4->setId("myfield4");

    $textModulesData5 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData5->setBody("Some info 5");
    $textModulesData5->setHeader("Label 5");
    $textModulesData5->setId("myfield5");

    $textModulesData6 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData6->setBody("Some info 6");
    $textModulesData6->setHeader("Label 6");
    $textModulesData6->setId("myfield6");

    $textModulesDatas = array($textModulesData1, $textModulesData2, $textModulesData3,
                  $textModulesData4, $textModulesData5, $textModulesData6);

    $startItemField = new Google_Service_Walletobjects_FieldReference();
    $startItemField->setFieldPath("class.textModulesData['myfield1']");

    $startItemFirstValue = new Google_Service_Walletobjects_FieldSelector();
    $startItemFirstValue->setFields(array($startItemField));

    $startItem = new Google_Service_Walletobjects_TemplateItem();
    $startItem->setFirstValue($startItemFirstValue);

    $middleItemField = new Google_Service_Walletobjects_FieldReference();
    $middleItemField->setFieldPath("class.textModulesData['myfield2']");

    $middleItemFirstValue = new Google_Service_Walletobjects_FieldSelector();
    $middleItemFirstValue->setFields(array($middleItemField));

    $middleItem = new Google_Service_Walletobjects_TemplateItem();
    $middleItem->setFirstValue($middleItemFirstValue);

    $endItemField = new Google_Service_Walletobjects_FieldReference();
    $endItemField->setFieldPath("class.textModulesData['myfield3']");

    $endItemFirstValue = new Google_Service_Walletobjects_FieldSelector();
    $endItemFirstValue->setFields(array($endItemField));

    $endItem = new Google_Service_Walletobjects_TemplateItem();
    $endItem->setFirstValue($endItemFirstValue);

    $cardRowTemplate = new Google_Service_Walletobjects_CardRowThreeItems();
    $cardRowTemplate->setStartItem($startItem);
    $cardRowTemplate->setMiddleItem($middleItem);
    $cardRowTemplate->setEndItem($endItem);

    $cardRowTemplateInfo1 = new Google_Service_Walletobjects_CardRowTemplateInfo();
    $cardRowTemplateInfo1->setThreeItems($cardRowTemplate);

    $startItemField2 = new Google_Service_Walletobjects_FieldReference();
    $startItemField2->setFieldPath("class.textModulesData['myfield4']");

    $startItemFirstValue2 = new Google_Service_Walletobjects_FieldSelector();
    $startItemFirstValue2->setFields(array($startItemField2));

    $startItem2 = new Google_Service_Walletobjects_TemplateItem();
    $startItem2->setFirstValue($startItemFirstValue2);

    $middleItemField2 = new Google_Service_Walletobjects_FieldReference();
    $middleItemField2->setFieldPath("class.textModulesData['myfield5']");

    $middleItemFirstValue2 = new Google_Service_Walletobjects_FieldSelector();
    $middleItemFirstValue2->setFields(array($middleItemField2));

    $middleItem2 = new Google_Service_Walletobjects_TemplateItem();
    $middleItem2->setFirstValue($middleItemFirstValue2);

    $endItemField2 = new Google_Service_Walletobjects_FieldReference();
    $endItemField2->setFieldPath("class.textModulesData['myfield6']");

    $endItemFirstValue2 = new Google_Service_Walletobjects_FieldSelector();
    $endItemFirstValue2->setFields(array($endItemField2));

    $endItem2 = new Google_Service_Walletobjects_TemplateItem();
    $endItem2->setFirstValue($endItemFirstValue2);

    $cardRowTemplate2 = new Google_Service_Walletobjects_CardRowThreeItems();
    $cardRowTemplate2->setStartItem($startItem2);
    $cardRowTemplate2->setMiddleItem($middleItem2);
    $cardRowTemplate2->setEndItem($endItem2);

    $cardRowTemplateInfo2 = new Google_Service_Walletobjects_CardRowTemplateInfo();
    $cardRowTemplateInfo2->setThreeItems($cardRowTemplate2);

    $cardTemplateOverride = new Google_Service_Walletobjects_CardTemplateOverride();
    $cardTemplateOverride->setCardRowTemplateInfos(array($cardRowTemplateInfo1,
                  $cardRowTemplateInfo2));

    $classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
    $classTemplateInfo->setCardTemplateOverride($cardTemplateOverride);

    $payload->setTextModulesData($textModulesDatas);
    $payload->setClassTemplateInfo($classTemplateInfo);

El código crea un pase con el siguiente formato de sección de plantilla de código:

Si un elemento está vacío, no se muestra. Para obtener más detalles, consulta Referencias de campos. Si todos los elementos de una fila están vacíos, no se muestra la fila. Si algunos, pero no todos, los elementos de una fila están vacíos, los elementos no vacíos se reorganizan y se muestran como una fila con menos elementos.

Si no anulas la plantilla de tarjeta, se usan la cantidad predeterminada de filas, la cantidad predeterminada de elementos y las referencias de campo predeterminadas. Para obtener más detalles, consulta Plantilla predeterminada.

Después de definir una imagen de héroe, esta puede aparecer después de la primera fila, si hay varias filas en la lista de cardRowTemplateInfos, o sobre la fila, si solo hay una.

Código de barras de la tarjeta

Android

class.classTemplateInfo
.cardBarcodeSectionDetails
.firstTopDetail
class.classTemplateInfo
.cardBarcodeSectionDetails
.secondTopDetail
object.barcode.type y object.barcode.value
o object.ticketNumber
object.barcode.alternateText
class.classTemplateInfo
.cardBarcodeSectionDetails
.firstBottomDetail
object.heroImage
o class.heroImage

Web

class.classTemplateInfo
.cardBarcodeSectionDetails
.firstTopDetail
class.classTemplateInfo
.cardBarcodeSectionDetails
.secondTopDetail
object.barcode.type y object.barcode.value
o object.ticketNumber
object.barcode.alternateText
class.classTemplateInfo
.cardBarcodeSectionDetails
.firstBottomDetail

La sección del código de barras de la tarjeta se usa para mostrar texto o imágenes adicionales antes y después del código de barras. Ninguno de los campos de esta sección es obligatorio.

Hay tres selectores de campos que se pueden usar para definir dos campos uno al lado del otro antes del código de barras y uno después. Estos se muestran sin etiqueta y pueden ser campos de datos estructurados basados en texto, campos de módulos de texto o campos de módulos de imágenes. Si usas imágenes, estas deben cumplir con los lineamientos de la marca.

El código de barras se define por un tipo y un valor. Para obtener una lista de los tipos de códigos de barras admitidos, consulta la Referencia. Además, se puede mostrar un texto justo debajo del código de barras. Este texto puede facilitar el escaneo de códigos de barras, entre otros usos.

En la siguiente muestra de código, se muestra cómo anular la sección del código de barras de un pase para mostrar una imagen sobre el código de barras:

Python

#... rest of class
    "imageModulesData": [
        {
            "mainImage": {
                "sourceUri": {
                    "uri":  "http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg",
                    "description": "Coffee"
                }
            },
            "id": "myimage"
        }
    ],
    "classTemplateInfo": {
        "cardBarcodeSectionDetails": {
            "firstTopDetail": {
                "fieldSelector": {
                    "fields": [
                        {
                        "fieldPath": "class.imageModulesData['myimage'].mainImage"
                        }
                    ]
                }
            }
        }
    }
}

Java

//... rest of class
  .setImageModulesData((new ArrayList<ImageModuleData>() {
    {
      add((new ImageModuleData())
        .setId("myimage")
        .setMainImage((new Image()).setSourceUri((new ImageUri()).setDescription("Coffee beans")
          .setUri("http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg"))));
        }
      }))
      .setClassTemplateInfo((new ClassTemplateInfo())
        .setCardBarcodeSectionDetails((new CardBarcodeSectionDetails())
          .setFirstTopDetail((new BarcodeSectionDetail())
            .setFieldSelector((new FieldSelector())
              .setFields((new ArrayList<FieldReference>(){
                {
                  add((new FieldReference()).setFieldPath("class.imageModulesData['myimage'].mainImage"));
                }
            })))))
      }

PHP

//... rest of class
    $imageUri = new Google_Service_Walletobjects_ImageUri();
    $imageUri->setUri("https://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg");
    $imageUri->setDescription("Baconrista flights image");
    $image = new Google_Service_Walletobjects_Image();
    $image->setSourceUri($imageUri);
    $imageModulesData = new Google_Service_Walletobjects_ImageModuleData();
    $imageModulesData->setMainImage($image);
            $imageModulesData->setId("myimage");

    $cardBarcodeFieldReference = new Google_Service_Walletobjects_FieldReference();
    $cardBarcodeFieldReference->setFieldPath("class.imageModulesData['myimage'].mainImage");

    $cardBarcodeFieldSelector = new Google_Service_Walletobjects_FieldSelector();
    $cardBarcodeFieldSelector->setFields(array($cardBarcodeFieldReference));

    $cardBarcodeDetail = new Google_Service_Walletobjects_BarcodeSectionDetail();
    $cardBarcodeDetail->setFieldSelector($cardBarcodeFieldSelector);

    $cardBarcodeSectionDetails = new Google_Service_Walletobjects_CardBarcodeSectionDetails();
    $cardBarcodeSectionDetails->setFirstTopDetail($cardBarcodeDetail);

    $classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
    $classTemplateInfo->setCardBarcodeSectionDetails($cardBarcodeSectionDetails);

    $payload->setClassTemplateInfo($classTemplateInfo);
            $payload->setImageModuleData($imageModulesData);

El código crea un pase con el siguiente formato de sección de código de barras:

Ejemplo de anulación del código de barras de una tarjeta.

Si no anulas la sección del código de barras, se usarán los campos predeterminados del código de barras. Para obtener más información, consulta Plantilla predeterminada.

Sección inferior

Android

Secciones y elementos inferiores de la plantilla de detalles

class.classTemplateInfo.detailsTemplateOverride
.detailsItemInfos[0].item
class.classTemplateInfo.detailsTemplateOverride
.detailsItemInfos[1].item
class.classTemplateInfo.detailsTemplateOverride
.detailsItemInfos[2].item
class.classTemplateInfo.detailsTemplateOverride
.detailsItemInfos[3].item
…

Web

class.classTemplateInfo.detailsTemplateOverride
.detailsItemInfos[0].item
class.classTemplateInfo.detailsTemplateOverride
.detailsItemInfos[1].item
class.classTemplateInfo.detailsTemplateOverride
.detailsItemInfos[2].item
class.classTemplateInfo.detailsTemplateOverride
.detailsItemInfos[3].item
…

La sección inferior es una lista de elementos class.classTemplateInfo.detailsTemplateOverride.detailsItemInfos[]. Los elementos pueden contener cualquier tipo de campos de datos estructurados, campos de módulos de texto, campos de módulos de vínculos, campos de módulos de imágenes o mensajes.

Cada elemento se puede definir como un selector de campo único (.firstValue), dos selectores de campo (.firstValue y .secondValue) o un elemento predefinido (.predefinedItem). Se muestran los valores del campo seleccionado y sus etiquetas respectivas. Cuando defines dos selectores de campo, los valores de los campos seleccionados se muestran con un separador "/". Lo mismo sucede con las etiquetas de los campos seleccionados. Los elementos predefinidos se usan para definir una renderización más compleja. Los campos del módulo de imagen se renderizan en todo el ancho sin una etiqueta.

En el siguiente ejemplo de código, se muestra cómo anular la sección inferior del pase para mostrar un solo campo linksModuleData con su etiqueta:

Python

//... rest of class
   "linksModuleData": {
        "uris": [
            {
                "uri": "http://maps.google.com/",
                "description": "Nearby Locations",
                "id":"mylink"
            }
        ]
    },
   "classTemplateInfo": {
        "detailsTemplateOverride": {
            "detailsItemInfos": [
                {
                    "item":{
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.linksModuleData.uris['mylink']"
                            }]
                        }
                    }
                }
            ]
        }
     }
//... rest of class

Java

 //... rest of class
  .setLinksModuleData((new ArrayList<LinksModuleData>() {
    {
      add((new LinksModuleData()).setDescription("Nearby Locations")
        .setUri("http://maps.google.com/")
        .setId("mylink"));
      }))
      .setClassTemplateInfo((new ClassTemplateInfo())
        .setDetailsTemplateOverride((new DetailsTemplateOverride())
          .setDetailsItemInfos(new ArrayList<DetailsItemInfo>(){
            {
              add((new DetailsItemInfo())
                .setItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
                  {
                    add((new FieldReference()).setFieldPath("class.linksModuleData.uris['mylink']"));
                  }
                }))));
              }
            }))
//... rest of class

PHP

    //... rest of class building
    $locationUri = new Google_Service_Walletobjects_Uri();
    $locationUri->setUri("http://maps.google.com/");
    $locationUri->setDescription("Nearby Locations");
    $locationUri->setId("mylink");

    $linksModuleData = new Google_Service_Walletobjects_LinksModuleData();
    $linksModuleData->setUris(array($locationUri));

    $detailItemFieldReference = new Google_Service_Walletobjects_FieldReference();
    $detailItemFieldReference->setFieldPath("class.linksModuleData.uris['mylink']");
    $detailItemFieldSelector = new Google_Service_Walletobjects_FieldSelector();
    $detailItemFieldSelector->setFields(array($detailItemFieldReference));

    $detailItem = new Google_Service_Walletobjects_TemplateItem();
    $detailItem->setFirstValue($detailItemFieldSelector);

    $detailsItemInfo = new Google_Service_Walletobjects_DetailsItemInfo();
    $detailsItemInfo->setItem($detailItem);

    $cardDetailsTemplateOverride = new Google_Service_Walletobjects_DetailsTemplateOverride();
    $cardDetailsTemplateOverride->setDetailsItemInfos(array($detailsItemInfo));

    $classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
    $classTemplateInfo->setDetailsTemplateOverride($cardDetailsTemplateOverride);

    $payload->setClassTemplateInfo($classTemplateInfo);
    $payload->setLinksModuleData($linksModuleData);
    //... rest of class

El código crea un pase con el siguiente formato de sección inferior:

Ejemplo de una sección inferior con anulación.

Si un elemento está vacío, no se muestra. Para obtener más detalles, consulta Referencias de campos.

Si no anulas la sección inferior, se mostrará la lista predeterminada de campos de referencia en el orden predeterminado. Para obtener más información, consulta Plantilla predeterminada.

Plantilla de lista

class.classTemplateInfo.listTemplateOverride
.firstRowOption.fieldOption.fields[]
class.dateTime.start (agrupado)
o class.classTemplateInfo.listTemplateOverride
.secondRowOption.fields[]
class.logo
object.hexBackgroundColor
o class.hexBackgroundColor
<# passes> (agrupado)

La sección de plantillas de lista se usa para seleccionar qué campo se mostrará en la vista "Pases" de la app de Billetera de Google. El pase se representa en la lista con el logotipo, el color de fondo y tres filas.

En el siguiente ejemplo de código, se muestra cómo anular la plantilla de lista de un pase para mostrar el campo de fecha de vencimiento del objeto de un solo pase en la primera fila de la plantilla de lista:

Python

#... rest of class definition
   "classTemplateInfo": {
        "listTemplateOverride":{
            "firstRowOption": {
                "fieldOption":{
                    "fields": [{
                        "fieldPath": "object.validTimeInterval.end"
                    }]
                }
            }
        }
   }
}

Java

//... rest of class
  .setClassTemplateInfo((new ClassTemplateInfo())
    .setListTemplateOverride((new ListTemplateOverride())
      .setFirstRowOption((new FirstRowOption())
        .setFieldOption((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
          {
            add((new FieldReference()).setFieldPath("object.validTimeInterval.end"));
          }
        }))))
//... rest of class

PHP

    //... rest of class
    $fieldReference = new Google_Service_Walletobjects_FieldReference();
    $fieldReference->setFieldPath("object.validTimeInterval.end");

    $fieldOption = new Google_Service_Walletobjects_FieldSelector();
    $fieldOption->setFields(array($fieldReference));

    $firstRowOption = new Google_Service_Walletobjects_FirstRowOption();
    $firstRowOption->setFieldOption($fieldOption);

    $listTemplateOverride = new Google_Service_Walletobjects_ListTemplateOverride();
    $listTemplateOverride->setFirstRowOption($firstRowOption);

    $classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
    $classTemplateInfo->setListTemplateOverride($listTemplateOverride);

    $payload->setClassTemplateInfo($classTemplateInfo);
    //... rest of class

El código crea un pase con la siguiente representación de la plantilla de lista:

Las tres filas se pueden definir con un selector de campos. Los campos se muestran sin etiqueta. En el caso de los pases agrupados, la segunda fila siempre muestra la fecha de inicio y la tercera, la cantidad de pases agrupados.

Etiquetas

Todos los campos de datos estructurados tienen una etiqueta proporcionada por Google. Google es responsable de proporcionar una traducción para cada una de estas etiquetas en todos los idiomas admitidos.

Puedes personalizar algunas de estas etiquetas con uno de los campos class.custom<name_of_the_field>Label. Cuando personalizas una etiqueta, te conviertes en el responsable de proporcionar traducciones para esa etiqueta específica en todos los idiomas que desees admitir.

Referencias de campos

Las referencias de campo se usan en diferentes partes de la plantilla con la forma class.classTemplateInfo.*.fields[]. Una referencia de campo contiene una lista de rutas de acceso a campos de datos estructurados, campos de módulos de texto, campos de módulos de vínculos, campos de módulos de imágenes o mensajes.

No todos los tipos de rutas de acceso se permiten en todas las referencias de campos. Por ejemplo, algunas referencias de campos solo permiten rutas de acceso a campos de datos estructurados basados en texto o campos de módulos de texto. Los campos estructurados basados en texto son campos de datos estructurados de tipo cadena, cadena localizada, fecha o dinero.

La lista se puede usar para implementar una lógica de resguardo. Esto significa que, si la primera ruta de acceso de la lista se resuelve en un campo vacío, se evalúa la siguiente ruta de acceso. La lógica de resguardo se dirige principalmente a los campos de datos estructurados basados en texto o a los campos de módulos de texto. No mezcles diferentes tipos de campos en la misma lista. Usa la lógica de resguardo con precaución y solo en situaciones específicas cuando esperes un patrón coherente de campos que existen en algunos objetos, pero no en otros. La mayoría de las veces, es más fácil crear clases separadas para casos de uso separados.

Si todas las rutas de una lista de referencias de campos se resuelven en campos vacíos, no se muestra el elemento que usa la referencia de campo. Si quieres que el elemento que usa la referencia de campo esté siempre presente, asegúrate de que al menos una ruta no esté vacía. Te recomendamos que establezcas un campo en un carácter especial, como "-", para representar un valor nulo, incluso si algunos campos permiten cadenas con solo un espacio.

Para hacer referencia a un campo incluido en una lista, puedes usar el índice del campo en la lista o, en la mayoría de los casos, puedes usar un ID de referencia. Los elementos de una lista a los que se puede hacer referencia por ID tienen un campo .id. Te recomendamos que uses un ID de referencia en lugar del índice del campo en la lista cuando esté disponible.

A continuación, se muestra un ejemplo de cómo hacer referencia a los campos incluidos en una lista.

object.imageModulesData[0].id = my-first-id
object.imageModulesData[1].id = my-second-id
class.detailsTemplateOverride.detailsItemInfos[0].item.firstValue.fields[0].fieldPath = object.imageModulesData[‘my-second-id’]
class.detailsTemplateOverride.detailsItemInfos[1].item.firstValue.fields[0].fieldPath = object.imageModulesData[0]

En este caso, el primer elemento de la sección de detalles del pase es la segunda imagen declarada en el objeto. Mientras que el segundo elemento de la sección de detalles del pase es la primera imagen declarada en el objeto.

Plantilla predeterminada

Android

Elementos y posiciones predeterminados del diseño de la plantilla de pase

class.logo
class.localizedIssuerName
o class.issuerName
class.eventName
class.venue.name
object.barcode.type y
object.barcode.value
object.barcode.alternateText
FECHA
class.dateTime.start (solo fecha)
TIME
class.dateTime.start (solo hora)
SECTION (predeterminado) o ENTRANCE
(depende de class.sectionLabel)
o class.customSectionLabel
ROW o class.customRowLabel
object.seatInfo.section
ROW o class.customRowLabel
SEAT o class.customSeatLabel
object.seatInfo.seat
object.heroImage
o class.heroImage
object.hexBackgroundColor
o class.hexBackgroundColor
TITULAR DEL BOLETO
object.ticketHolderName
class.venue.name
class.venue.address
CÓDIGO DE CONFIRMACIÓN (predeterminado)
o NÚMERO DE CONFIRMACIÓN
o NÚMERO DE PEDIDO
o NÚMERO DE RESERVACIÓN
(depende de class.confirmationCodeLabel)
o class.customConfirmationCodeLabel
object.reservationInfo.confirmationCode
TÉRMINOS Y CONDICIONES
class.finePrint
class.messages[].header
class.messages[].body
object.messages[].header
object.messages[].body
class.textModulesData[0..9].header
class.textModulesData[0..9].body
object.textModulesData[0..9].header
object.textModulesData[0..9].body
class.linksModuleData.uris[].description
object.linksModuleData.uris[].description

Web

class.logo
class.localizedIssuerName
o class.issuerName
class.eventName
class.venue.name
object.barcode.type y
object.barcode.value
object.barcode.alternateText
FECHA
class.dateTime.start (solo fecha)
TIME
class.dateTime.start (solo hora)
SECTION (predeterminado) o ENTRANCE
(depende de class.sectionLabel)
o class.customSectionLabel
ROW o class.customRowLabel
object.seatInfo.section
ROW o class.customRowLabel
SEAT o class.customSeatLabel
object.seatInfo.seat
object.heroImage
o class.heroImage
object.hexBackgroundColor
o class.hexBackgroundColor
TITULAR DEL BOLETO
object.ticketHolderName
class.venue.name
class.venue.address
CÓDIGO DE CONFIRMACIÓN (predeterminado)
o NÚMERO DE CONFIRMACIÓN
o NÚMERO DE PEDIDO
o NÚMERO DE RESERVACIÓN
(depende de class.confirmationCodeLabel)
o class.customConfirmationCodeLabel
object.reservationInfo.confirmationCode
TÉRMINOS Y CONDICIONES
class.finePrint
class.messages[].header
class.messages[].body
object.messages[].header
object.messages[].body
class.textModulesData[0..9].header
class.textModulesData[0..9].body
object.textModulesData[0..9].header
object.textModulesData[0..9].body
class.linksModuleData.uris[].description
object.linksModuleData.uris[].description

Nota: Esta imagen incluye todos los campos necesarios para completar la plantilla predeterminada de entradas para eventos. Sin embargo, no todos estos campos son obligatorios para crear un EventClass o un EventObject válidos. Consulta los métodos EventClass, insert y EventObject insert para obtener una lista de los campos obligatorios.

En el caso de los campos del módulo de imagen, mostramos un solo campo del módulo de imagen de la clase y un solo campo del módulo de imagen del objeto. Si necesitas más de un campo de módulo de imagen en cualquiera de los niveles, anula la plantilla predeterminada.

En el caso de los campos del módulo de texto, solo mostramos un máximo de 20 campos del módulo de texto de la clase y 20 campos del módulo de texto del objeto. Los campos se muestran en el mismo orden en que se definen en el array. Si necesitas más de 20 campos de módulos de texto en cualquiera de los niveles, anula la plantilla predeterminada.

En el caso de los mensajes, solo mostramos un máximo de 20 mensajes de la clase y 20 mensajes del objeto. No garantizamos el orden de los mensajes. Si necesitas más de 20 mensajes en cualquiera de los niveles o una garantía para cualquier pedido, anula la plantilla predeterminada.

En el campo del módulo de vínculos, no hay límite en la cantidad de URIs que puedes definir. Las URIs se muestran agrupadas en el siguiente orden para cada nivel (clase u objeto):

Coordenadas del mapa
Números de teléfono
Direcciones de correo electrónico
Páginas web

Para cada grupo, los URIs se muestran en el mismo orden en que se definen en el array. Si necesitas un orden diferente, anula la plantilla predeterminada.

Diseño predeterminado de la plantilla de lista: elementos y posiciones

class.eventName
class.dateTime.start
class.logo
object.hexBackgroundColor
o class.hexBackgroundColor
<# passes> (agrupado)

Plantilla de entrada para evento Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Definición de la plantilla

Android

Web

Título de la tarjeta

Android

Web

Plantilla de tarjeta

Android

Web

Python

Java

PHP

Código de barras de la tarjeta

Android

Web

Python

Java

PHP

Sección inferior

Android

Web

Python

Java

PHP

Plantilla de lista

Python

Java

PHP

Etiquetas

Referencias de campos

Plantilla predeterminada

Android

Web

Plantilla de entrada para evento