लॉयल्टी टेंप्लेट

लॉयल्टी पास, टेंप्लेट रेंडरिंग में काम करता है. अगर कोई टेंप्लेट तय नहीं किया गया है, तो डिफ़ॉल्ट टेंप्लेट का इस्तेमाल किया जाता है.

टेंप्लेट की परिभाषा

पास टेंप्लेट, क्लास लेवल पर तय किया जाता है और इसका इस्तेमाल क्लास से जुड़े किसी भी ऑब्जेक्ट को दिखाने के लिए किया जाता है. टेंप्लेट से तय होता है कि पास के अलग-अलग सेक्शन में किन फ़ील्ड को दिखाना है.

टेंप्लेट को इन सेक्शन में बांटा गया है:

Android

टेंप्लेट की खास जानकारी

वेब

टेंप्लेट की खास जानकारी

कार्ड शीर्षक

Android

कार्ड के टाइटल के एलिमेंट कार्ड का डिफ़ॉल्ट टाइटल
  1. class.programLogo
  2. class.localizedIssuerName
    या class.issuerName
  3. class.localizedProgramName
    या class.programName
  4. class.hexBackgroundColor

वाइड-लोगो कार्ड का टाइटल
  1. class.wideProgramLogo
  2. class.localizedProgramName
    या class.programName
  3. class.hexBackgroundColor

वेब

कार्ड के टाइटल के एलिमेंट
  1. class.programLogo
  2. class.localizedIssuerName
    या class.issuerName
  3. class.localizedProgramName
    या class.programName
  4. class.hexBackgroundColor

कार्ड के टाइटल वाले सेक्शन में, लोगो, कार्ड जारी करने वाले का नाम, और कार्यक्रम का टाइटल दिखता है. कॉन्टेंट को पॉप्युलेट करने के लिए, न तो फ़ील्ड के रेफ़रंस का इस्तेमाल किया गया है और न ही उनकी पोज़िशन बदली जा सकती है.

जब चौड़े लोगो फ़ील्ड को सेट किया जाता है, तो Android डिवाइसों पर, डिफ़ॉल्ट टेंप्लेट हेडर को लोगो और जारी करने वाले के नाम के साथ, चौड़े लोगो से बदल दिया जाता है.

पास पर अपनी इमेज को बेहतर तरीके से दिखाने के लिए, चौड़ा हेडर लोगो बनाते समय, कृपया चौड़े लोगो की इमेज से जुड़े दिशा-निर्देशों का पालन करें.

कार्ड का टेंप्लेट

Android

टेंप्लेट की खास जानकारी

वेब

टेंप्लेट की खास जानकारी

कार्ड के टेंप्लेट वाले सेक्शन का इस्तेमाल, ज़्यादा लाइनें दिखाने के लिए किया जाता है. इन पंक्तियों में टेक्स्ट पर आधारित स्ट्रक्चर्ड डेटा फ़ील्ड या टेक्स्ट मॉड्यूल फ़ील्ड हो सकते हैं.

class.classTemplateInfo.cardTemplateOverride.cardRowTemplateInfos[] सूची में ऑब्जेक्ट की संख्या तय करने वाली लाइनों की संख्या तय की जा सकती है. सूची में कम से कम एक एलिमेंट की ज़रूरत है. साथ ही, हमारा सुझाव है कि आप ज़्यादा से ज़्यादा दो एलिमेंट का इस्तेमाल करें. हर एलिमेंट, इनमें से किसी एक टाइप का होना चाहिए:

  • oneItem, जिसमें एक आइटम स्वीकार किया जाता है:
    • item
  • twoItems, जिसमें दो आइटम स्वीकार किए जा सकते हैं:
    • startItem
    • endItem
  • threeItems, जिसमें तीन आइटम स्वीकार किए जा सकते हैं:
    • startItem
    • middleItem
    • endItem

हर आइटम को एक फ़ील्ड सिलेक्टर (.firstValue), दो फ़ील्ड सिलेक्टर (.firstValue और .secondValue) या पहले से तय किए गए आइटम (.predefinedItem) के तौर पर दिखाया जा सकता है. चुने गए फ़ील्ड की वैल्यू और उनसे जुड़े लेबल, दोनों दिखाए जाते हैं. दो फ़ील्ड सिलेक्टर तय करने पर, चुने गए फ़ील्ड की वैल्यू को "/" सेपरेटर के साथ दिखाया जाता है. यही बात, चुने गए फ़ील्ड के लेबल पर भी लागू होती है. पहले से तय आइटम का इस्तेमाल, ज़्यादा मुश्किल रेंडरिंग के बारे में बताने के लिए किया जाता है.

नीचे दिए गए कोड सैंपल में, कार्ड टेंप्लेट वाले कार्ड की लाइन वाले सेक्शन को बदलने का तरीका बताया गया है. इस तरीके से, दो लाइनें तय की जा सकती हैं. हर लाइन में तीन आइटम होते हैं. हर आइटम छह क्लास-लेवल के textModuleData कस्टम फ़ील्ड और उनके हेडर को लेबल के तौर पर बताता है:

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

यह कोड, इस कोड टेंप्लेट सेक्शन फ़ॉर्मैट का इस्तेमाल करके पास बनाता है:

लेबल बदलने का उदाहरण.

अगर कोई आइटम खाली है, तो वह नहीं दिखता है. ज़्यादा जानकारी के लिए, फ़ील्ड रेफ़रंस देखें. अगर किसी पंक्ति के सभी आइटम खाली हैं, तो वह लाइन नहीं दिखेगी. अगर एक पंक्ति में मौजूद सभी आइटम खाली हैं, लेकिन सभी आइटम खाली नहीं हैं, तो खाली आइटम फिर से व्यवस्थित कर दिए जाते हैं. साथ ही, कम आइटम के साथ एक पंक्ति में दिखाए जाते हैं.

अगर कार्ड टेंप्लेट को नहीं बदला जाता, तो लाइनों की डिफ़ॉल्ट संख्या, आइटम की डिफ़ॉल्ट संख्या, और फ़ील्ड के डिफ़ॉल्ट रेफ़रंस इस्तेमाल किए जाते हैं. ज़्यादा जानकारी के लिए, डिफ़ॉल्ट टेंप्लेट देखें.

हीरो इमेज तय करने के बाद, अगर cardRowTemplateInfos सूची में कई पंक्तियां हैं या अगर एक ही पंक्ति है, तो यह पहली लाइन के बाद दिख सकती है.

कार्ड बारकोड

Android

कार्ड बारकोड एलिमेंट
  1. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstTopDetail
  2. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .secondTopDetail
  3. object.barcode.type और object.barcode.value
    या object.accountId
  4. object.barcode.alternateText
    या object.accountId
    या 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.type और object.barcode.value
    या object.accountId
  4. object.barcode.alternateText
    या object.accountId
    या object.barcode.value
  5. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstBottomDetail

कार्ड बारकोड सेक्शन का इस्तेमाल, बारकोड के ऊपर और नीचे ज़्यादा टेक्स्ट या इमेज दिखाने के लिए किया जाता है. इस सेक्शन में किसी भी फ़ील्ड की ज़रूरत नहीं है.

तीन फ़ील्ड सिलेक्टर का इस्तेमाल किया जा सकता है, जिनका इस्तेमाल बारकोड के नीचे और ऊपर वाले दो फ़ील्ड के बारे में बताने के लिए किया जा सकता है. इन्हें बिना किसी लेबल के दिखाया जाता है. ये टेक्स्ट पर आधारित स्ट्रक्चर्ड डेटा फ़ील्ड, टेक्स्ट मॉड्यूल फ़ील्ड या इमेज मॉड्यूल फ़ील्ड हो सकते हैं. अगर इमेज का इस्तेमाल किया जाता है, तो इन्हें ब्रैंड से जुड़े दिशा-निर्देशों के मुताबिक होना चाहिए.

बारकोड को टाइप और वैल्यू के हिसाब से तय किया जाता है. इस्तेमाल किए जा सकने वाले बारकोड टाइप की सूची देखने के लिए, रेफ़रंस देखें. इसके अलावा, बारकोड के ठीक नीचे एक टेक्स्ट भी दिखाया जा सकता है. इस टेक्स्ट की मदद से, बारकोड को स्कैन करने के अन्य तरीकों के साथ-साथ, इसका इस्तेमाल करना भी आसान हो जाता है.

नीचे दिए गए कोड सैंपल में बताया गया है कि बारकोड के ऊपर इमेज दिखाने के लिए, पास के बारकोड सेक्शन को कैसे बदला जाता है:

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

कोड, इस बारकोड सेक्शन फ़ॉर्मैट के साथ एक पास बनाता है:

कार्ड बारकोड बदलने का उदाहरण.

अगर बारकोड सेक्शन को नहीं बदला जाता है, तो डिफ़ॉल्ट बारकोड फ़ील्ड का इस्तेमाल किया जाता है. ज़्यादा जानकारी के लिए, डिफ़ॉल्ट टेंप्लेट देखें.

जानकारी का टेंप्लेट

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
    

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
    

कोड, जानकारी वाले सेक्शन के इस फ़ॉर्मैट का इस्तेमाल करके पास बनाता है:

जानकारी में बदलाव करने का उदाहरण.

अगर कोई आइटम खाली है, तो वह नहीं दिखता है. ज़्यादा जानकारी के लिए, फ़ील्ड रेफ़रंस देखें.

अगर जानकारी वाले टेंप्लेट को नहीं बदला जाता, तो डिफ़ॉल्ट क्रम में मौजूद रेफ़रंस फ़ील्ड की डिफ़ॉल्ट सूची दिखती है. ज़्यादा जानकारी के लिए, डिफ़ॉल्ट टेंप्लेट देखें.

सूची टेम्प्लेट

टेंप्लेट के एलिमेंट की सूची बनाना
  1. class.classTemplateInfo.listTemplateOverride
      .firstRowOption.fieldOption.fields[]
  2. class.classTemplateInfo.listTemplateOverride
      .secondRowOption.fields[]
  3. class.programLogo
  4. class.hexBackgroundColor

सूची टेंप्लेट सेक्शन का इस्तेमाल यह चुनने के लिए किया जाता है कि Google Wallet ऐप्लिकेशन के "पास" व्यू में कौनसा फ़ील्ड दिखाना है. पास को सूची में लोगो, बैकग्राउंड के रंग, और तीन लाइनों में दिखाया जाता है.

नीचे दिए गए कोड सैंपल में, पास के लिस्ट टेंप्लेट को बदलने का तरीका बताया गया है. ऐसा करके, लिस्ट टेंप्लेट की पहली लाइन में, एक पास के ऑब्जेक्ट की समयसीमा खत्म होने की तारीख वाला फ़ील्ड दिखाया जाता है:

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
    

कोड, सूची टेंप्लेट के इस वर्शन का इस्तेमाल करके एक पास बनाता है:

लिस्ट बदलने का उदाहरण.

फ़ील्ड सिलेक्टर की मदद से, तीनों लाइन को तय किया जा सकता है. फ़ील्ड में कोई लेबल नहीं दिखता है.

लेबल

सभी स्ट्रक्चर्ड डेटा फ़ील्ड में, Google का दिया हुआ लेबल होता है. इनमें से हर लेबल का अनुवाद, इस्तेमाल की जा सकने वाली सभी भाषाओं में उपलब्ध कराने की ज़िम्मेदारी Google की है.

class.custom<name_of_the_field>Label फ़ील्ड में से किसी एक का इस्तेमाल करके, इनमें से कुछ लेबल को अपनी पसंद के मुताबिक बनाया जा सकता है. जब किसी लेबल को पसंद के मुताबिक बनाया जाता है, तो उस लेबल के लिए उन सभी भाषाओं में अनुवाद उपलब्ध कराने की ज़िम्मेदारी आपकी होती है जिन्हें आपको इस्तेमाल करना है.

फ़ील्ड के रेफ़रंस

फ़ील्ड रेफ़रंस का इस्तेमाल टेंप्लेट के अलग-अलग हिस्सों में, class.classTemplateInfo.*.fields[] फ़ॉर्म के साथ किया जाता है. फ़ील्ड रेफ़रंस में स्ट्रक्चर्ड डेटा फ़ील्ड, टेक्स्ट मॉड्यूल फ़ील्ड, लिंक मॉड्यूल फ़ील्ड, इमेज मॉड्यूल फ़ील्ड या मैसेज के पाथ की सूची होती है.

हर फ़ील्ड रेफ़रंस में, सभी तरह के पाथ की अनुमति नहीं है. उदाहरण के लिए, कुछ फ़ील्ड रेफ़रंस सिर्फ़ टेक्स्ट पर आधारित स्ट्रक्चर्ड डेटा फ़ील्ड या टेक्स्ट मॉड्यूल फ़ील्ड में जाने के लिए पाथ की अनुमति देते हैं. टेक्स्ट पर आधारित स्ट्रक्चर्ड फ़ील्ड, ऐसे स्ट्रक्चर्ड डेटा फ़ील्ड होते हैं जिनका टाइप स्ट्रिंग, स्थानीय जगह के हिसाब से बनी स्ट्रिंग, तारीख या पैसा होता है.

सूची का इस्तेमाल, फ़ॉलबैक लॉजिक को लागू करने के लिए किया जा सकता है. इसका मतलब है कि अगर सूची में मौजूद पहला पाथ किसी खाली फ़ील्ड में बदल जाता है, तो अगले पाथ का आकलन किया जाता है. फ़ॉलबैक लॉजिक को मुख्य रूप से टेक्स्ट पर आधारित स्ट्रक्चर्ड डेटा फ़ील्ड या टेक्स्ट मॉड्यूल फ़ील्ड पर टारगेट किया जाता है. एक ही सूची में अलग-अलग तरह के फ़ील्ड न मिलाएं. फ़ॉलबैक लॉजिक का इस्तेमाल सावधानी से करें. इसका इस्तेमाल सिर्फ़ खास स्थितियों में करें. ऐसा तब करें, जब आपको लगता है कि फ़ील्ड के एक जैसे पैटर्न कुछ ऑब्जेक्ट में मौजूद हैं, लेकिन दूसरे नहीं. ज़्यादातर मामलों में, इस्तेमाल के अलग-अलग उदाहरणों के लिए, अलग-अलग क्लास बनाना आसान होता है.

अगर फ़ील्ड रेफ़रंस सूची के सभी पाथ में कोई फ़ील्ड खाली हो जाता है, तो फ़ील्ड रेफ़रंस का इस्तेमाल करने वाला आइटम नहीं दिखाया जाता. अगर आपको फ़ील्ड रेफ़रंस का इस्तेमाल करने वाले आइटम को हमेशा मौजूद रखना है, तो पक्का करें कि कम से कम एक पाथ खाली न हो. हमारा सुझाव है कि आप किसी फ़ील्ड को शून्य वैल्यू दिखाने के लिए, उस खास वर्ण पर सेट करें, जैसे कि '-'. भले ही, कुछ फ़ील्ड में सिर्फ़ स्पेस हो.

सूची में शामिल किसी फ़ील्ड का रेफ़रंस देने के लिए, सूची में मौजूद फ़ील्ड के इंडेक्स का इस्तेमाल किया जा सकता है. ज़्यादातर मामलों में, रेफ़रंस आईडी का इस्तेमाल किया जा सकता है. सूची के ऐसे आइटम जिन्हें आईडी से रेफ़र किया जा सकता है उनमें .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.programLogo
  2. class.localizedIssuerName
    या class.issuerName
  3. class.localizedProgramName
    या class.programName
  4. POINTS
    या object.loyaltyPoints.localizedLabel
    या object.loyaltyPoints.label
  5. object.loyaltyPoints.balance
  6. इनाम
    या object.secondaryLoyaltyPoints.localizedLabel
    या object.secondaryLoyaltyPoints.label
  7. object.secondaryLoyaltyPoints.balance
  8. object.barcode.type और object.barcode.value
    या object.accountId
  9. object.barcode.alternateText
    या object.accountId
    या object.barcode.value
  10. object.heroImage
    या class.heroImage
  11. class.hexBackgroundColor
  12. MEMBER NAME
    या class.localizedAccountNameLabel
    या class.accountNameLabel
  13. object.accountName
  14. सदस्य आईडी
    या class.localizedAccountIdLabel
    या class.accountIdLabel
  15. object.accountId
  16. REWARDS TIER
    या class.localizedRewardsTierLabel
    या class.rewardsTierLabel
  17. class.localizedRewardsTier
    या class.rewardsTier
  18. सेकंडरी इनाम का टियर
    या class.localizedSecondaryRewardsTierLabel
    या class.secondaryRewardsTierLabel
  19. class.localizedSecondaryRewardsTier
    या class.secondaryRewardsTier
  20. class.imageModulesData[0].mainImage
  21. object.imageModulesData[0].mainImage
  22. class.messages[].header
  23. class.messages[].body
  24. object.messages[].header
  25. object.messages[].body
  26. class.textModulesData[0..9].header
  27. class.textModulesData[0..9].body
  28. object.textModulesData[0..9].header
  29. object.textModulesData[0..9].body
  30. class.linksModuleData.uris[].description
  31. object.linksModuleData.uris[].description
  32. class.homepageUri

वेब

टेंप्लेट के डिफ़ॉल्ट एलिमेंट
  1. class.programLogo
  2. class.localizedIssuerName
    या class.issuerName
  3. class.localizedProgramName
    या class.programName
  4. POINTS
    या object.loyaltyPoints.localizedLabel
    या object.loyaltyPoints.label
  5. object.loyaltyPoints.balance
  6. इनाम
    या object.secondaryLoyaltyPoints.localizedLabel
    या object.secondaryLoyaltyPoints.label
  7. object.secondaryLoyaltyPoints.balance
  8. object.barcode.type और object.barcode.value
    या object.accountId
  9. object.barcode.alternateText
    या object.accountId
    या object.barcode.value
  10. object.heroImage
    या class.heroImage
  11. class.hexBackgroundColor
  12. MEMBER NAME
    या class.localizedAccountNameLabel
    या class.accountNameLabel
  13. object.accountName
  14. सदस्य आईडी
    या class.localizedAccountIdLabel
    या class.accountIdLabel
  15. object.accountId
  16. REWARDS TIER
    या class.localizedRewardsTierLabel
    या class.rewardsTierLabel
  17. class.localizedRewardsTier
    या class.rewardsTier
  18. सेकंडरी इनाम का टियर
    या class.localizedSecondaryRewardsTierLabel
    या class.secondaryRewardsTierLabel
  19. class.localizedSecondaryRewardsTier
    या class.secondaryRewardsTier
  20. class.imageModulesData[0].mainImage
  21. object.imageModulesData[0].mainImage
  22. class.messages[].header
  23. class.messages[].body
  24. object.messages[].header
  25. object.messages[].body
  26. class.textModulesData[0..9].header
  27. class.textModulesData[0..9].body
  28. object.textModulesData[0..9].header
  29. object.textModulesData[0..9].body
  30. class.linksModuleData.uris[].description
  31. object.linksModuleData.uris[].description
  32. class.homepageUri

इमेज मॉड्यूल फ़ील्ड के लिए, हम क्लास से एक इमेज मॉड्यूल फ़ील्ड और ऑब्जेक्ट से सिर्फ़ एक इमेज मॉड्यूल फ़ील्ड दिखाते हैं. अगर आपको किसी भी लेवल पर एक से ज़्यादा इमेज मॉड्यूल फ़ील्ड की ज़रूरत है, तो डिफ़ॉल्ट टेंप्लेट को बदलें.

टेक्स्ट मॉड्यूल फ़ील्ड के लिए, हम क्लास से ज़्यादा से ज़्यादा 20 टेक्स्ट मॉड्यूल फ़ील्ड और ऑब्जेक्ट के लिए ज़्यादा से ज़्यादा 20 टेक्स्ट मॉड्यूल फ़ील्ड दिखाते हैं. फ़ील्ड उसी क्रम में दिखाए जाते हैं जिस क्रम में उन्हें कलेक्शन में दिखाया जाता है. अगर आपको किसी भी लेवल पर 20 से ज़्यादा टेक्स्ट मॉड्यूल फ़ील्ड की ज़रूरत है, तो डिफ़ॉल्ट टेंप्लेट को बदलें.

मैसेज के मामले में, हम क्लास के ज़्यादा से ज़्यादा 20 मैसेज और ऑब्जेक्ट से ज़्यादा से ज़्यादा 20 मैसेज दिखाते हैं. हम मैसेज के क्रम की गारंटी नहीं देते. अगर आपको किसी भी लेवल पर 20 से ज़्यादा मैसेज या किसी ऑर्डर के लिए गारंटी की ज़रूरत है, तो डिफ़ॉल्ट टेंप्लेट को बदल दें.

लिंक मॉड्यूल फ़ील्ड के लिए, तय किए जा सकने वाले यूआरआई की कोई सीमा नहीं है. हर लेवल (क्लास या ऑब्जेक्ट) के लिए, यूरिस को नीचे बताए गए क्रम में ग्रुप में दिखाया जाता है:

  1. मैप के निर्देशांक
  2. टेलीफ़ोन नंबर
  3. ईमेल पते
  4. वेब पेज

हर ग्रुप के लिए, यूआरआई उसी क्रम में दिखाए जाते हैं जिस क्रम में उन्हें ऐरे में तय किया गया है. अगर आपको किसी दूसरे टेंप्लेट की ज़रूरत है, तो डिफ़ॉल्ट टेंप्लेट को बदलें.

लिस्ट टेंप्लेट के डिफ़ॉल्ट एलिमेंट
  1. class.localizedIssuerName
    या class.issuerName
  2. class.localizedProgramName
    या class.programName
  3. class.programLogo
  4. class.hexBackgroundColor