쿠폰 템플릿

쿠폰 패스에는 템플릿 렌더링이 지원됩니다. 템플릿이 정의되지 않으면 기본 템플릿이 사용됩니다.

템플릿 정의

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

템플릿은 다음 섹션으로 나뉘어 있습니다.

Android

템플릿 개요

템플릿 개요

카드 제목

Android

카드 제목 요소 기본 카드 제목
  1. class.titleImage
  2. class.localizedIssuerName
    또는 class.issuerName
  3. class.localizedTitle
    또는 class.title
  4. class.hexBackgroundColor

와이드 로고 카드 제목
  1. class.wideTitleImage
  2. class.localizedTitle
    또는 class.title
  3. class.hexBackgroundColor

카드 제목 요소
  1. class.titleImage
  2. class.localizedIssuerName
    또는 class.issuerName
  3. class.localizedTitle
    또는 class.title
  4. class.hexBackgroundColor

카드 제목 섹션에는 로고, 발급기관 이름, 쿠폰 제목이 표시됩니다. 이 필드를 채우는 데 사용된 필드 참조와 위치 모두 변경할 수 없습니다.

넓은 로고 필드가 설정되면 Android 기기에서 로고가 있는 기본 템플릿 헤더와 발급기관 이름이 넓은 로고로 대체됩니다.

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

카드 템플릿

Android

템플릿 개요

템플릿 개요

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

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

  • 항목 1개를 사용하는 oneItem:
    • item
  • 항목 2개를 사용하는 twoItems:
    • startItem
    • endItem
  • 항목 3개를 사용하는 threeItems:
    • startItem
    • middleItem
    • endItem

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

다음 코드 샘플은 카드 템플릿 카드 행 섹션을 재정의하여 두 개의 행을 지정하는 방법을 보여줍니다. 각 행에는 각각 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']"
                            }]
                        }
                    },
                }
            }]
        }
    }
}
    

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

2,399필리핀

// 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.typeobject.barcode.value
  4. object.barcode.alternateText
    또는 object.barcode.value
  5. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstBottomDetail
  6. object.heroImage
    또는 class.heroImage

카드 바코드 요소
  1. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstTopDetail
  2. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .secondTopDetail
  3. object.barcode.typeobject.barcode.value
  4. object.barcode.alternateText
    또는 object.barcode.value
  5. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstBottomDetail

카드 바코드 섹션을 사용하여 바코드 위아래에 추가 텍스트나 이미지를 표시할 수 있습니다. 이 섹션에는 필수 입력란이 없습니다.

3개의 필드 선택기를 사용하여 바코드 위에 필드 2개를 나란히 정의하고 바코드 아래에 필드 1개를 정의할 수 있습니다. 이러한 필드는 라벨 없이 표시되며 텍스트 기반의 구조화된 데이터 필드, 텍스트 모듈 필드, 이미지 모듈 필드 중 하나입니다. 이미지를 사용하는 경우 브랜드 가이드라인을 준수해야 합니다.

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

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

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"));
                }
            })))))
      }
    

2,399필리핀

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

다음 코드 샘플은 패스의 세부정보 섹션을 재정의하여 라벨이 있는 단일 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
    

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
    

2,399필리핀



    //... 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.classTemplateInfo.listTemplateOverride
      .secondRowOption.fields[]
  3. class.titleImage
  4. class.hexBackgroundColor

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

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

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
    

2,399필리핀

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

코드는 다음 목록 템플릿 렌더링을 사용하여 패스를 만듭니다.

목록 재정의 예시

3개 행은 필드 선택기로 정의할 수 있습니다. 필드는 라벨 없이 표시됩니다.

라벨

모든 구조화된 데이터 필드에는 Google에서 제공하는 라벨이 있습니다. Google은 이러한 각 라벨의 번역을 지원되는 모든 언어로 제공할 책임이 있습니다.

class.custom<name_of_the_field>Label 필드 중 하나를 사용하여 이러한 라벨 중 일부를 맞춤설정할 수 있습니다. 라벨을 맞춤설정하면 지원하려는 모든 언어로 특정 라벨에 대한 번역을 제공해야 합니다.

필드 참조

필드 참조는 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.titleImage
  2. class.localizedIssuerName
    또는 class.issuerName
  3. class.localizedTitle
    또는 class.title
  4. object.barcode.typeobject.barcode.value
  5. object.barcode.alternateText
    또는 object.barcode.value
  6. object.heroImage
    또는 class.heroImage
  7. class.hexBackgroundColor
  8. 만료일
  9. object.validTimeInterval.end
  10. FROM
  11. class.localizedProvider
    또는 class.provider
  12. class.imageModulesData[0].mainImage
  13. object.imageModulesData[0].mainImage
  14. 세부정보
  15. class.localizedDetails
    또는 class.details
  16. 면책조항
  17. class.localizedFinePrint
    또는 class.finePrint
  18. class.messages[].header
  19. class.messages[].body
  20. object.messages[].header
  21. object.messages[].body
  22. class.textModulesData[0..9].header
  23. class.textModulesData[0..9].body
  24. object.textModulesData[0..9].header
  25. object.textModulesData[0..9].body
  26. class.linksModuleData.uris[].description
  27. object.linksModuleData.uris[].description
  28. class.homepageUri
  29. class.helpUri

기본 템플릿 요소
  1. class.titleImage
  2. class.localizedIssuerName
    또는 class.issuerName
  3. class.localizedTitle
    또는 class.title
  4. object.barcode.typeobject.barcode.value
  5. object.barcode.alternateText
    또는 object.barcode.value
  6. object.heroImage
    또는 class.heroImage
  7. class.hexBackgroundColor
  8. 만료일
  9. object.validTimeInterval.end
  10. FROM
  11. class.localizedProvider
    또는 class.provider
  12. class.imageModulesData[0].mainImage
  13. object.imageModulesData[0].mainImage
  14. 세부정보
  15. class.localizedDetails
    또는 class.details
  16. 면책조항
  17. class.localizedFinePrint
    또는 class.finePrint
  18. class.messages[].header
  19. class.messages[].body
  20. object.messages[].header
  21. object.messages[].body
  22. class.textModulesData[0..9].header
  23. class.textModulesData[0..9].body
  24. object.textModulesData[0..9].header
  25. object.textModulesData[0..9].body
  26. class.linksModuleData.uris[].description
  27. object.linksModuleData.uris[].description
  28. class.homepageUri
  29. class.helpUri

이미지 모듈 필드는 클래스의 이미지 모듈 필드 1개, 객체의 이미지 모듈 필드 1개만 표시됩니다. 각 수준에서 2개 이상의 이미지 모듈 필드가 필요하면 기본 템플릿을 재정의합니다.

텍스트 모듈 필드는 클래스의 텍스트 모듈 필드 최대 20개, 객체의 텍스트 모듈 필드 최대 20개만 표시됩니다. 필드는 배열에 정의된 순서와 동일하게 표시됩니다. 각 수준에서 20개를 초과하는 텍스트 모듈 필드가 필요하면 기본 템플릿을 재정의합니다.

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

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

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

각 그룹에서 URI는 배열에 정의된 순서와 동일하게 표시됩니다. 다른 순서가 필요한 경우 기본 템플릿을 재정의하세요.

기본 목록 템플릿 요소
  1. class.localizedIssuerName
    또는 class.issuerName
  2. class.localizedShortTitle
    또는 class.shortTitle
    또는 class.localizedTitle
    또는 class.title
  3. class.titleImage
  4. class.hexBackgroundColor