탑승권 템플릿

탑승권은 템플릿 렌더링을 지원합니다. 템플릿이 정의되지 않으면 기본 템플릿이 사용됩니다.

템플릿 정의

패스 템플릿은 클래스 수준에서 정의되며 클래스와 연결된 모든 객체를 표시하는 데 사용됩니다. 템플릿은 패스의 여러 섹션에 표시할 필드를 정의합니다.

템플릿은 다음 섹션으로 나뉩니다.

Android

패스 템플릿 레이아웃 섹션 및 위치 개요

웹

패스 템플릿 레이아웃 섹션 및 위치 개요

카드 제목

Android

카드 제목 레이아웃 요소 및 필드 위치 기본 카드 제목
  1. class.flightHeader.carrier.airlineLogo
  2. class.flightHeader.carrier.airlineName
    또는 class.localizedIssuerName
    또는 class.issuerName
  3. (class.flightHeader.carrier.carrierIataCode
    또는 class.flightHeader.carrier.carrierIcaoCode)
    및 class.flightHeader.flightNumber
  4. 공항 도시(class.origin.airportIataCode에서 파생)
    또는 class.origin.airportNameOverride
  5. class.origin.airportIataCode
  6. 공항 도시(class.destination.airportIataCode에서 파생)
    또는 class.destination.airportNameOverride
  7. class.destination.airportIataCode
  8. object.hexBackgroundColor
    또는 class.hexBackgroundColor

와이드 로고 카드 제목
  1. class.flightHeader.wideAirlineLogo
  2. (class.flightHeader.carrier.carrierIataCode
    또는 class.flightHeader.carrier.carrierIcaoCode)
    및 class.flightHeader.flightNumber
  3. 공항 도시(class.origin.airportIataCode에서 파생)
    또는 class.origin.airportNameOverride
  4. class.origin.airportIataCode
  5. 공항 도시(class.destination.airportIataCode에서 파생)
    또는 class.destination.airportNameOverride
  6. class.destination.airportIataCode
  7. object.hexBackgroundColor
    또는 class.hexBackgroundColor

웹

카드 제목 레이아웃 요소 및 필드 위치 기본 카드 제목
  1. class.flightHeader.carrier.airlineLogo
  2. class.flightHeader.carrier.airlineName
    또는 class.localizedIssuerName
    또는 class.issuerName
  3. (class.flightHeader.carrier.carrierIataCode
    또는 class.flightHeader.carrier.carrierIcaoCode)
    및 class.flightHeader.flightNumber
  4. 공항 도시(class.origin.airportIataCode에서 파생)
    또는 class.origin.airportNameOverride
  5. class.origin.airportIataCode
  6. 공항 도시(class.destination.airportIataCode에서 파생)
    또는 class.destination.airportNameOverride
  7. class.destination.airportIataCode
  8. object.hexBackgroundColor
    또는 class.hexBackgroundColor

와이드 로고 카드 제목
  1. class.flightHeader.wideAirlineLogo
  2. (class.flightHeader.carrier.carrierIataCode
    또는 class.flightHeader.carrier.carrierIcaoCode)
    및 class.flightHeader.flightNumber
  3. 공항 도시(class.origin.airportIataCode에서 파생)
    또는 class.origin.airportNameOverride
  4. class.origin.airportIataCode
  5. 공항 도시(class.destination.airportIataCode에서 파생)
    또는 class.destination.airportNameOverride
  6. class.destination.airportIataCode
  7. object.hexBackgroundColor
    또는 class.hexBackgroundColor

카드 제목 섹션에는 로고, 항공사 이름, 항공편 요약이 표시됩니다. 이 세 가지 요소는 모두 필수이며, 이를 채우는 데 사용되는 필드 참조나 위치는 변경할 수 없습니다.

class.origin.airportNameOverride 또는 class.destination.airportNameOverride가 설정되지 않은 경우 공항의 도시 이름은 각각 class.origin.airportIataCode 및 class.destination.airportIataCode의 IATA 코드와 연결된 도시로 자동 채워집니다.

와이드 로고 필드가 설정되면 휴대기기에서 로고와 발행자 이름이 포함된 기본 템플릿 헤더가 와이드 로고로 대체됩니다.

패스에 이미지를 최적으로 표시하려면 와이드 헤더 로고를 만들 때 와이드 로고 이미지 가이드라인을 따르세요.

카드 템플릿

Android

카드 템플릿 행 레이아웃 요소 및 필드 위치

웹

카드 템플릿 행 레이아웃 요소 및 필드 위치

카드 템플릿 섹션은 추가 행을 표시하는 데 사용됩니다. 이러한 행에는 텍스트 기반 구조화된 데이터 필드 또는 텍스트 모듈 필드가 포함될 수 있습니다.

class.classTemplateInfo.cardTemplateOverride.cardRowTemplateInfos[] 목록에서 객체 수를 정의하는 행 수를 지정할 수 있습니다. 목록에는 하나 이상의 요소가 필요하며 최대 두 개의 요소를 사용하는 것이 좋습니다. 각 요소는 다음 유형 중 하나여야 합니다.

  • oneItem: 항목 하나를 허용합니다.
    • item
  • twoItems: 두 항목을 허용합니다.
    • startItem
    • endItem
  • threeItems: 세 가지 항목을 허용합니다.
    • startItem
    • middleItem
    • endItem

각 항목은 단일 필드 선택기(.firstValue), 두 개의 필드 선택기(.firstValue 및 .secondValue) 또는 사전 정의된 항목(.predefinedItem)으로 정의할 수 있습니다. 선택한 필드의 값과 해당 라벨이 모두 표시됩니다. 필드 선택기 두 개를 정의하면 선택한 필드의 값이 '/' 구분 기호와 함께 표시됩니다. 선택한 필드의 라벨도 마찬가지입니다. 사전 정의된 항목은 더 복잡한 렌더링을 정의하는 데 사용됩니다.

다음 코드 샘플은 카드 템플릿 카드 행 섹션을 재정의하여 두 행을 지정하는 방법을 보여줍니다. 각 행에는 6개의 클래스 수준 textModuleData 맞춤 필드와 헤더를 라벨로 참조하는 항목이 3개씩 포함됩니다.

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']"
                            }]
                        }
                    },
                }
            }]
        }
    }
}
    

자바

// 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);
    

이 코드는 다음 코드 템플릿 섹션 형식으로 패스를 만듭니다.

라벨 재정의 예시

항목이 비어 있으면 표시되지 않습니다. 자세한 내용은 필드 참조를 참고하세요. 행의 모든 항목이 비어 있으면 행이 표시되지 않습니다. 행의 일부 항목이 비어 있는 경우 비어 있지 않은 항목이 재정렬되고 항목이 더 적은 행으로 표시됩니다.

카드 템플릿을 재정의하지 않으면 기본 행 수, 기본 항목 수, 기본 필드 참조가 사용됩니다. 자세한 내용은 기본 템플릿을 참조하세요.

히어로 이미지를 정의하면 cardRowTemplateInfos 목록에 행이 여러 개 있는 경우 첫 번째 행 뒤에 표시되거나 행이 하나만 있는 경우 행 위에 표시될 수 있습니다.

카드 바코드

Android

카드 바코드 레이아웃 요소 및 위치
  1. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstTopDetail
  2. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .secondTopDetail
  3. object.barcode.type 및 object.barcode.value
    또는 object.reservationInfo.confirmationCode
  4. object.barcode.alternateText
  5. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstBottomDetail

웹

카드 바코드 레이아웃 요소 및 위치
  1. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstTopDetail
  2. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .secondTopDetail
  3. object.barcode.type 및 object.barcode.value
    또는 object.reservationInfo.confirmationCode
  4. object.barcode.alternateText
  5. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstBottomDetail

카드 바코드 섹션은 바코드 앞뒤에 추가 텍스트 또는 이미지를 표시하는 데 사용됩니다. 이 섹션의 입력란은 모두 필수 항목이 아닙니다.

바코드 앞의 나란히 표시되는 필드 2개와 뒤의 필드 1개를 정의하는 데 사용할 수 있는 필드 선택기가 3개 있습니다. 라벨 없이 표시되며 텍스트 기반 구조화된 데이터 필드, 텍스트 모듈 필드 또는 이미지 모듈 필드일 수 있습니다. 이미지를 사용하는 경우 브랜드 가이드라인을 따라야 합니다.

바코드는 유형과 값으로 정의됩니다. 지원되는 바코드 유형 목록은 참조를 확인하세요. 또한 바코드 바로 아래에 텍스트를 표시할 수 있습니다. 이 텍스트를 사용하면 바코드 스캔이 더 쉬워집니다.

다음 코드 샘플은 패스의 바코드 섹션을 재정의하여 바코드 위에 이미지를 표시하는 방법을 보여줍니다.

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"
                        }
                    ]
                }
            }
        }
    }
}
    

자바

//... 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);
    

이 코드는 다음 바코드 섹션 형식으로 패스를 만듭니다.

카드 바코드 재정의의 예

바코드 섹션을 재정의하지 않으면 기본 바코드 필드가 사용됩니다. 자세한 내용은 기본 템플릿을 참고하세요.

하단 섹션

Android

세부정보 템플릿 하단 섹션 및 항목
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[0].item
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[1].item
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[2].item
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[3].item
  • …

웹

세부정보 템플릿 하단 섹션 및 항목
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[0].item
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[1].item
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[2].item
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[3].item
  • …

하단 섹션은 항목 목록 class.classTemplateInfo.detailsTemplateOverride.detailsItemInfos[]입니다. 항목에는 모든 종류의 구조화된 데이터 필드, 텍스트 모듈 필드, 링크 모듈 필드, 이미지 모듈 필드 또는 메시지가 포함될 수 있습니다.

각 항목은 단일 필드 선택기(.firstValue), 두 개의 필드 선택기(.firstValue 및 .secondValue) 또는 사전 정의된 항목(.predefinedItem)으로 정의할 수 있습니다. 선택한 필드의 값과 해당 라벨이 모두 표시됩니다. 두 개의 필드 선택기를 정의하면 선택한 필드의 값이 '/' 구분 기호와 함께 표시됩니다. 선택한 필드의 라벨도 마찬가지입니다. 사전 정의된 항목은 더 복잡한 렌더링을 정의하는 데 사용됩니다. 이미지 모듈 필드는 라벨 없이 전체 너비로 렌더링됩니다.

다음 코드 샘플은 패스의 하단 섹션을 재정의하여 라벨과 함께 단일 linksModuleData 필드를 표시하는 방법을 보여줍니다.

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
    

자바

 //... 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
    

이 코드는 다음과 같은 하단 섹션 형식의 패스를 만듭니다.

하단 섹션 재정의의 예

항목이 비어 있으면 표시되지 않습니다. 자세한 내용은 필드 참조를 참고하세요.

하단 섹션을 재정의하지 않으면 기본 순서로 된 참조 필드의 기본 목록이 표시됩니다. 자세한 내용은 기본 템플릿을 참조하세요.

목록 템플릿

템플릿 요소 나열
  1. class.classTemplateInfo.listTemplateOverride
      .firstRowOption.fieldOption.fields[]
  2. class.localScheduledDepartureDateTime
      (날짜만)(그룹화됨)
    또는 class.classTemplateInfo.listTemplateOverride
      .secondRowOption.fields[]
  3. class.flightHeader.carrier.airlineLogo
  4. object.hexBackgroundColor
    또는 class.hexBackgroundColor
  5. <# passes>(그룹화됨)

목록 템플릿 섹션은 Google 월렛 앱의 '패스' 보기에 표시할 필드를 선택하는 데 사용됩니다. 패스는 로고, 배경 색상, 세 개의 행과 함께 목록에 표시됩니다.

다음 코드 샘플은 패스의 목록 템플릿을 재정의하여 목록 템플릿의 첫 번째 행에 단일 패스 객체의 만료일 필드를 표시하는 방법을 보여줍니다.

Python

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

자바

//... 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
    

이 코드는 다음 목록 템플릿 렌더링으로 패스를 만듭니다.

목록 재정의의 예시

세 행은 필드 선택기로 정의할 수 있습니다. 필드가 라벨 없이 표시됩니다. 그룹화된 패스의 경우 두 번째 행에는 항상 현지 예정 출발일이 표시되고 세 번째 행에는 항상 그룹화된 패스 수가 표시됩니다.

필드 참조

필드 참조는 class.classTemplateInfo.*.fields[] 형식으로 템플릿의 여러 부분에서 사용됩니다. 필드 참조에는 정형 데이터 필드, 텍스트 모듈 필드, 링크 모듈 필드, 이미지 모듈 필드 또는 메시지의 경로 목록이 포함됩니다.

모든 필드 참조에서 모든 유형의 경로가 허용되는 것은 아닙니다. 예를 들어 일부 필드 참조는 텍스트 기반 정형 데이터 필드 또는 텍스트 모듈 필드에 대한 경로만 허용합니다. 텍스트 기반 구조화된 필드는 문자열, 현지화된 문자열, 날짜 또는 금액 유형의 구조화된 데이터 필드입니다.

이 목록은 대체 로직을 구현하는 데 사용할 수 있습니다. 즉, 목록의 첫 번째 경로가 빈 필드로 확인되면 다음 경로가 평가됩니다. 대체 로직은 주로 텍스트 기반 구조화된 데이터 필드 또는 텍스트 모듈 필드를 타겟팅합니다. 동일한 목록에 서로 다른 유형의 필드를 혼합하지 마세요. 대체 로직은 주의해서 사용해야 하며, 일부 객체에는 존재하지만 다른 객체에는 존재하지 않는 일관된 필드 패턴이 예상되는 특정 상황에서만 사용해야 합니다. 대부분의 경우 별도의 사용 사례에 별도의 클래스를 만드는 것이 더 쉽습니다.

필드 참조 목록의 모든 경로가 빈 필드로 확인되면 필드 참조를 사용하는 항목이 표시되지 않습니다. 필드 참조를 사용하는 항목이 항상 표시되도록 하려면 하나 이상의 경로가 비어 있지 않아야 합니다. 일부 필드에서 공백만 있는 문자열을 허용하더라도 null 값을 나타내도록 필드를 '-'와 같은 특수문자로 설정하는 것이 좋습니다.

목록에 포함된 필드를 참조하려면 목록에서 필드의 색인을 사용하거나 대부분의 경우 참조 ID를 사용할 수 있습니다. ID로 참조할 수 있는 목록 항목에는 .id 필드가 있습니다. 가능한 경우 목록에 있는 필드의 색인 대신 참조 ID를 사용하는 것이 좋습니다.

다음은 목록에 포함된 필드를 참조하는 방법의 예입니다.

  • 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]

이 경우 패스의 세부정보 섹션에 있는 첫 번째 항목은 객체에 선언된 두 번째 이미지입니다. 패스의 세부정보 섹션에 있는 두 번째 항목은 객체에 선언된 첫 번째 이미지입니다.

기본 템플릿

Android

기본 패스 템플릿 레이아웃 요소 및 위치
  1. class.flightHeader.carrier.airlineLogo
  2. class.flightHeader.carrier.airlineName
    또는 class.localizedIssuerName
    또는 class.issuerName
  3. class.origin.airportIataCode
  4. class.destination.airportIataCode
  5. 공항 도시(class.origin.airportIataCode에서 파생)
    또는 class.origin.airportNameOverride
  6. 공항 도시(class.destination.airportIataCode에서 파생)
    또는 class.destination.airportNameOverride
  7. (class.flightHeader.carrier.carrierIataCode
    또는 class.flightHeader.carrier.carrierIcaoCode)
    및 class.flightHeader.flightNumber
  8. object.securityProgramLogo
  9. object.boardingAndSeatingInfo.boardingPrivilegeImage
  10. object.barcode.type 및 object.barcode.value
    또는 object.reservationInfo.confirmationCode
  11. object.barcode.alternateText
  12. class.flightHeader.carrier.airlineAllianceLogo
  13. PASSENGER
  14. object.passengerName
  15. ZONE(기본값) 또는 GROUP(
    class.boardingAndSeatingPolicy.boardingPolicy에 따라 다름)
  16. SEAT
  17. object.boardingAndSeatingInfo.boardingGroup 및
  18. object.boardingAndSeatingInfo.seatNumber
    또는 object.boardingAndSeatingInfo.seatAssignment
  19. 터미널
  20. GATE
  21. class.origin.terminal
  22. class.origin.gate
  23. 탑승
  24. class.localBoardingDateTime
  25. CABIN(기본값) 또는 CLASS 또는 TIER(
    class.boardingAndSeatingPolicy.SeatClassPolicy에 따라 다름)
  26. object.boardingAndSeatingInfo.SeatClass
  27. 출발
  28. class.localScheduledDepartureDateTime
  29. object.hexBackgroundColor
    또는 class.hexBackgroundColor
  30. object.heroImage
    또는 class.heroImage
  31. 확인 번호
  32. object.reservationInfo.confirmationCode
  33. 항공사 멤버십 번호
  34. object.reservationInfo.frequentFlyerInfo.frequentFlyerNumber
    및 object.reservationInfo.frequentFlyerInfo.frequentFlyerProgramName
  35. 예정 도착 시간
  36. class.localScheduledArrivalDateTime
  37. class.messages[].header
  38. class.messages[].body
  39. object.messages[].header
  40. object.messages[].body
  41. class.textModulesData[0..9].header
  42. class.textModulesData[0..9].body
  43. object.textModulesData[0..9].header
  44. object.textModulesData[0..9].body
  45. class.linksModuleData.uris[].description
  46. object.linksModuleData.uris[].description

웹

기본 패스 템플릿 레이아웃 요소 및 위치
  1. class.flightHeader.carrier.airlineLogo
  2. class.flightHeader.carrier.airlineName
    또는 class.localizedIssuerName
    또는 class.issuerName
  3. class.origin.airportIataCode
  4. class.destination.airportIataCode
  5. 공항 도시(class.origin.airportIataCode에서 파생)
    또는 class.origin.airportNameOverride
  6. 공항 도시(class.destination.airportIataCode에서 파생)
    또는 class.destination.airportNameOverride
  7. (class.flightHeader.carrier.carrierIataCode
    또는 class.flightHeader.carrier.carrierIcaoCode)
    및 class.flightHeader.flightNumber
  8. object.securityProgramLogo
  9. object.boardingAndSeatingInfo.boardingPrivilegeImage
  10. object.barcode.type 및 object.barcode.value
    또는 object.reservationInfo.confirmationCode
  11. object.barcode.alternateText
  12. class.flightHeader.carrier.airlineAllianceLogo
  13. PASSENGER
  14. object.passengerName
  15. ZONE(기본값) 또는 GROUP(
    class.boardingAndSeatingPolicy.boardingPolicy에 따라 다름)
  16. SEAT
  17. object.boardingAndSeatingInfo.boardingGroup 및
  18. object.boardingAndSeatingInfo.seatNumber
    또는 object.boardingAndSeatingInfo.seatAssignment
  19. 터미널
  20. GATE
  21. class.origin.terminal
  22. class.origin.gate
  23. 탑승
  24. class.localBoardingDateTime
  25. CABIN(기본값) 또는 CLASS 또는 TIER(
    class.boardingAndSeatingPolicy.SeatClassPolicy에 따라 다름)
  26. object.boardingAndSeatingInfo.SeatClass
  27. 출발
  28. class.localScheduledDepartureDateTime
  29. object.hexBackgroundColor
    또는 class.hexBackgroundColor
  30. object.heroImage
    또는 class.heroImage
  31. 확인 번호
  32. object.reservationInfo.confirmationCode
  33. 항공사 멤버십 번호
  34. object.reservationInfo.frequentFlyerInfo.frequentFlyerNumber
    및 object.reservationInfo.frequentFlyerInfo.frequentFlyerProgramName
  35. 예정 도착 시간
  36. class.localScheduledArrivalDateTime
  37. class.messages[].header
  38. class.messages[].body
  39. object.messages[].header
  40. object.messages[].body
  41. class.textModulesData[0..9].header
  42. class.textModulesData[0..9].body
  43. object.textModulesData[0..9].header
  44. object.textModulesData[0..9].body
  45. class.linksModuleData.uris[].description
  46. object.linksModuleData.uris[].description

기본적으로 카드 섹션이 재정의되고 이러한 필드가 더 이상 카드 섹션에 없으면 하단 섹션에도 object.boardingAndSeatingInfo.boardingGroup, object.boardingAndSeatingInfo.seatClass, object.boardingAndSeatingInfo.seatNumber가 표시됩니다.

이미지 모듈 필드의 경우 클래스의 이미지 모듈 필드 하나와 객체의 이미지 모듈 필드 하나만 표시됩니다. 두 수준 중 하나에서 이미지 모듈 필드가 두 개 이상 필요한 경우 기본 템플릿을 재정의합니다.

텍스트 모듈 필드의 경우 클래스의 텍스트 모듈 필드 최대 20개와 객체의 텍스트 모듈 필드 20개만 표시됩니다. 필드는 배열에 정의된 순서와 동일한 순서로 표시됩니다. 두 수준 중 하나에서 텍스트 모듈 필드가 20개 넘게 필요한 경우 기본 템플릿을 재정의합니다.

메시지의 경우 클래스에서 최대 20개의 메시지와 객체에서 최대 20개의 메시지만 표시됩니다. 메시지의 순서는 보장되지 않습니다. 두 수준 중 하나에서 20개 이상의 메시지가 필요하거나 주문에 대한 보장이 필요한 경우 기본 템플릿을 재정의합니다.

링크 모듈 필드의 경우 정의할 수 있는 URI 수에 제한이 없습니다. URI는 각 수준(클래스 또는 객체)에 대해 다음 순서로 그룹화되어 표시됩니다.

  1. 지도 좌표
  2. 전화번호
  3. 이메일 주소
  4. 웹페이지

각 그룹의 URI는 배열에 정의된 순서대로 표시됩니다. 다른 순서가 필요한 경우 기본 템플릿을 재정의합니다.

기본 목록 템플릿 레이아웃 요소 및 위치
  1. class.origin.airportIataCode
    및 class.destination.airportIataCode
  2. class.localScheduledDepartureDateTime
    (날짜만)
  3. class.flightHeader.carrier.airlineLogo
  4. object.hexBackgroundColor
    또는 class.hexBackgroundColor
  5. <# passes>(그룹화됨)