बोर्डिंग पास का टेंप्लेट

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

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

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

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

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 में आईएटीए कोड से जुड़े शहर के नाम से अपने-आप भर जाता है.

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

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

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

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

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

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

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

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

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.localScheduledDepartureDateTime
      (सिर्फ़ तारीख) (ग्रुप किया गया)
    या class.classTemplateInfo.listTemplateOverride
      .secondRowOption.fields[]
  3. class.flightHeader.carrier.airlineLogo
  4. object.hexBackgroundColor
    या class.hexBackgroundColor
  5. <# passes> (ग्रुप में)

सूची वाले टेंप्लेट सेक्शन का इस्तेमाल करके, यह चुना जाता है कि 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
    

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

सूची को बदलने का उदाहरण.

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

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

फ़ील्ड रेफ़रंस का इस्तेमाल, टेंप्लेट के अलग-अलग हिस्सों में 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.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. यात्री
  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. यात्री
  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 से ज़्यादा मैसेज की ज़रूरत है या किसी ऑर्डर की गारंटी चाहिए, तो डिफ़ॉल्ट टेंप्लेट को बदलें.

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

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

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

डिफ़ॉल्ट सूची टेंप्लेट के लेआउट एलिमेंट और उनकी पोज़िशन
  1. class.origin.airportIataCode
    और class.destination.airportIataCode
  2. class.localScheduledDepartureDateTime
    (सिर्फ़ तारीख)
  3. class.flightHeader.carrier.airlineLogo
  4. object.hexBackgroundColor
    या class.hexBackgroundColor
  5. <# passes> (ग्रुप में)