इस पेज का अनुवाद Cloud Translation API से किया गया है.

पास क्लास और पास ऑब्जेक्ट बनाएं

असली उपयोगकर्ता के Google Wallet में सेव करने के लिए, आपके पास करीब-करीब सभी पास की जानकारी होती है. ये दो कॉम्पोनेंट होते हैं: पास की क्लास और पास ऑब्जेक्ट. किसी उपयोगकर्ता को पास जारी करने के लिए, आपको पास क्लास और पास ऑब्जेक्ट, दोनों के इंस्टेंस की ज़रूरत होगी. इससे Google Wallet API को पता चलता है कि किस तरह का पास बनाना है. साथ ही, पास पर दिखाने के लिए उपहार कार्ड की वैल्यू या टिकटधारक के नाम जैसी जानकारी भी देनी होगी.

Google Wallet API, पास की क्लास और पास से जुड़े ऑब्जेक्ट का पहले से तय सेट उपलब्ध कराता है, जिनके इंस्टेंस बनाए जाते हैं. इसके बाद, इसका इस्तेमाल किसी उपयोगकर्ता के लिए जारी किया जाने वाला पास बनाने के लिए किया जाता है. जैसे, GiftCardClass, GiftCardObject, GenericClass, और GenericObject वगैरह.

हर पास क्लास और पास ऑब्जेक्ट इंस्टेंस को JSON ऑब्जेक्ट के तौर पर तय किया जाता है. इसमें ज़रूरी और वैकल्पिक प्रॉपर्टी का एक सेट होता है. यह सेट, उस पास टाइप के इस्तेमाल के खास उदाहरण से मेल खाता है.

पास की क्लास बनाएं

पास क्लास को शेयर किया गया ऐसा टेंप्लेट माना जा सकता है जिसका इस्तेमाल करके पास बनाए जाते हैं. पास क्लास से कुछ प्रॉपर्टी के बारे में पता चलता है. इन्हें इस्तेमाल करने वाले सभी पास में शामिल किया जाएगा. पास जारी करने वाला व्यक्ति, कई क्लास बना सकता है. हर क्लास में प्रॉपर्टी का ऐसा खास सेट होता है जो स्टाइल और लुक जैसे एट्रिब्यूट के बारे में बताता है. साथ ही, इसमें स्मार्ट टैप, रजिस्ट्रेशन, और साइन इन जैसी अतिरिक्त सुविधाएं भी मिलती हैं.

पास क्लास, Google Wallet REST API, Google Wallet Android SDK या Google Wallet Business Console का इस्तेमाल करके बनाई जा सकती हैं.

नए उपयोगकर्ताओं के लिए, Business Console, पास की कैटगरी बनाने का सबसे आसान तरीका है. इससे, एक आसान यूज़र इंटरफ़ेस मिलता है. इसमें फ़ॉर्म फ़ील्ड भरकर, पहली पास क्लास के अलग-अलग फ़ील्ड तय किए जा सकते हैं.

ज़्यादा जानकार उपयोगकर्ताओं के लिए, प्रोग्राम के हिसाब से पास की क्लास बनाना सबसे सही तरीका है.

Google Wallet Business Console का इस्तेमाल करना

Google Wallet Business कंसोल में पास की क्लास बनाने के लिए, ये काम करें:

Google Pay और Wallet Business Console पर जाएं और अपने Google Wallet API जारी करने वाले खाते से साइन इन करें.
"Google Wallet API" कार्ड पर मौजूद, "पास मैनेज करें" बटन पर क्लिक करें.
'पब्लिश करने का ऐक्सेस पाएं' में जाकर, 'क्लास बनाएं' बटन पर क्लिक करें.
डायलॉग से पास का टाइप चुनें. Google Wallet कई तरह के पास ऑफ़र करता है, जैसे कि इवेंट का टिकट, ऑफ़र, लॉयल्टी कार्ड वगैरह. सुविधाजनक इस्तेमाल के उदाहरण के लिए, अपने पास टाइप के तौर पर "सामान्य" को चुनें.
ज़रूरी फ़ील्ड में सही वैल्यू भरें.
अपनी क्लास सेव करने के लिए, 'क्लास बनाएं' बटन पर क्लिक करें.

Google Wallet REST API का इस्तेमाल करना

Google Wallet REST API का इस्तेमाल करके पास की क्लास बनाने के लिए, https://walletobjects.googleapis.com/walletobjects/v1/loyaltyClass को POST का अनुरोध भेजें. ज़्यादा जानकारी के लिए, रेफ़रंस दस्तावेज़ देखें.

Java

Java में इंटिग्रेशन शुरू करने के लिए, GitHub पर हमारे सभी कोड सैंपल देखें.

/**
 * Create a class.
 *
 * @param issuerId The issuer ID being used for this request.
 * @param classSuffix Developer-defined unique ID for this pass class.
 * @return The pass class ID: "{issuerId}.{classSuffix}"
 */
public String createClass(String issuerId, String classSuffix) throws IOException {
  // Check if the class exists
  try {
    service.loyaltyclass().get(String.format("%s.%s", issuerId, classSuffix)).execute();

    System.out.printf("Class %s.%s already exists!%n", issuerId, classSuffix);
    return String.format("%s.%s", issuerId, classSuffix);
  } catch (GoogleJsonResponseException ex) {
    if (ex.getStatusCode() != 404) {
      // Something else went wrong...
      ex.printStackTrace();
      return String.format("%s.%s", issuerId, classSuffix);
    }
  }

  // See link below for more information on required properties
  // https://developers.google.com/wallet/retail/loyalty-cards/rest/v1/loyaltyclass
  LoyaltyClass newClass =
      new LoyaltyClass()
          .setId(String.format("%s.%s", issuerId, classSuffix))
          .setIssuerName("Issuer name")
          .setReviewStatus("UNDER_REVIEW")
          .setProgramName("Program name")
          .setProgramLogo(
              new Image()
                  .setSourceUri(
                      new ImageUri()
                          .setUri(
                              "https://farm4.staticflickr.com/3723/11177041115_6e6a3b6f49_o.jpg"))
                  .setContentDescription(
                      new LocalizedString()
                          .setDefaultValue(
                              new TranslatedString()
                                  .setLanguage("en-US")
                                  .setValue("Logo description"))));

  LoyaltyClass response = service.loyaltyclass().insert(newClass).execute();

  System.out.println("Class insert response");
  System.out.println(response.toPrettyString());

  return response.getId();
}

PHP

PHP में अपना इंटिग्रेशन शुरू करने के लिए, GitHub पर हमारे सभी कोड सैंपल देखें.

/**
 * Create a class.
 *
 * @param string $issuerId The issuer ID being used for this request.
 * @param string $classSuffix Developer-defined unique ID for this pass class.
 *
 * @return string The pass class ID: "{$issuerId}.{$classSuffix}"
 */
public function createClass(string $issuerId, string $classSuffix)
{
  // Check if the class exists
  try {
    $this->service->loyaltyclass->get("{$issuerId}.{$classSuffix}");

    print("Class {$issuerId}.{$classSuffix} already exists!");
    return "{$issuerId}.{$classSuffix}";
  } catch (Google\Service\Exception $ex) {
    if (empty($ex->getErrors()) || $ex->getErrors()[0]['reason'] != 'classNotFound') {
      // Something else went wrong...
      print_r($ex);
      return "{$issuerId}.{$classSuffix}";
    }
  }

  // See link below for more information on required properties
  // https://developers.google.com/wallet/retail/loyalty-cards/rest/v1/loyaltyclass
  $newClass = new LoyaltyClass([
    'id' => "{$issuerId}.{$classSuffix}",
    'issuerName' => 'Issuer name',
    'reviewStatus' => 'UNDER_REVIEW',
    'programName' => 'Program name',
    'programLogo' => new Image([
      'sourceUri' => new ImageUri([
        'uri' => 'http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg'
      ]),
      'contentDescription' => new LocalizedString([
        'defaultValue' => new TranslatedString([
          'language' => 'en-US',
          'value' => 'Logo description'
        ])
      ])
    ])
  ]);

  $response = $this->service->loyaltyclass->insert($newClass);

  print "Class insert response\n";
  print_r($response);

  return $response->id;
}

Python

Python में इंटिग्रेशन शुरू करने के लिए, GitHub पर हमारे सभी कोड सैंपल देखें.

def create_class(self, issuer_id: str, class_suffix: str) -> str:
    """Create a class.

    Args:
        issuer_id (str): The issuer ID being used for this request.
        class_suffix (str): Developer-defined unique ID for this pass class.

    Returns:
        The pass class ID: f"{issuer_id}.{class_suffix}"
    """

    # Check if the class exists
    try:
        self.client.loyaltyclass().get(resourceId=f'{issuer_id}.{class_suffix}').execute()
    except HttpError as e:
        if e.status_code != 404:
            # Something else went wrong...
            print(e.error_details)
            return f'{issuer_id}.{class_suffix}'
    else:
        print(f'Class {issuer_id}.{class_suffix} already exists!')
        return f'{issuer_id}.{class_suffix}'

    # See link below for more information on required properties
    # https://developers.google.com/wallet/retail/loyalty-cards/rest/v1/loyaltyclass
    new_class = {
        'id': f'{issuer_id}.{class_suffix}',
        'issuerName': 'Issuer name',
        'reviewStatus': 'UNDER_REVIEW',
        'programName': 'Program name',
        'programLogo': {
            'sourceUri': {
                'uri':
                    'http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg'
            },
            'contentDescription': {
                'defaultValue': {
                    'language': 'en-US',
                    'value': 'Logo description'
                }
            }
        }
    }

    response = self.client.loyaltyclass().insert(body=new_class).execute()

    print('Class insert response')
    print(response)

    return f'{issuer_id}.{class_suffix}'

C#

C# में इंटिग्रेशन शुरू करने के लिए, GitHub पर हमारे सभी कोड सैंपल देखें.

/// <summary>
/// Create a class.
/// </summary>
/// <param name="issuerId">The issuer ID being used for this request.</param>
/// <param name="classSuffix">Developer-defined unique ID for this pass class.</param>
/// <returns>The pass class ID: "{issuerId}.{classSuffix}"</returns>
public string CreateClass(string issuerId, string classSuffix)
{
  // Check if the class exists
  Stream responseStream = service.Loyaltyclass
      .Get($"{issuerId}.{classSuffix}")
      .ExecuteAsStream();

  StreamReader responseReader = new StreamReader(responseStream);
  JObject jsonResponse = JObject.Parse(responseReader.ReadToEnd());

  if (!jsonResponse.ContainsKey("error"))
  {
    Console.WriteLine($"Class {issuerId}.{classSuffix} already exists!");
    return $"{issuerId}.{classSuffix}";
  }
  else if (jsonResponse["error"].Value<int>("code") != 404)
  {
    // Something else went wrong...
    Console.WriteLine(jsonResponse.ToString());
    return $"{issuerId}.{classSuffix}";
  }

  // See link below for more information on required properties
  // https://developers.google.com/wallet/retail/loyalty-cards/rest/v1/loyaltyclass
  LoyaltyClass newClass = new LoyaltyClass
  {
    Id = $"{issuerId}.{classSuffix}",
    IssuerName = "Issuer name",
    ReviewStatus = "UNDER_REVIEW",
    ProgramName = "Program name",
    ProgramLogo = new Image
    {
      SourceUri = new ImageUri
      {
        Uri = "http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg"
      },
      ContentDescription = new LocalizedString
      {
        DefaultValue = new TranslatedString
        {
          Language = "en-US",
          Value = "Logo description"
        }
      }
    }
  };

  responseStream = service.Loyaltyclass
      .Insert(newClass)
      .ExecuteAsStream();

  responseReader = new StreamReader(responseStream);
  jsonResponse = JObject.Parse(responseReader.ReadToEnd());

  Console.WriteLine("Class insert response");
  Console.WriteLine(jsonResponse.ToString());

  return $"{issuerId}.{classSuffix}";
}

Node.js

नोड में इंटिग्रेशन शुरू करने के लिए, GitHub पर हमारे सभी कोड सैंपल देखें.

/**
 * Create a class.
 *
 * @param {string} issuerId The issuer ID being used for this request.
 * @param {string} classSuffix Developer-defined unique ID for this pass class.
 *
 * @returns {string} The pass class ID: `${issuerId}.${classSuffix}`
 */
async createClass(issuerId, classSuffix) {
  let response;

  // Check if the class exists
  try {
    response = await this.client.loyaltyclass.get({
      resourceId: `${issuerId}.${classSuffix}`
    });

    console.log(`Class ${issuerId}.${classSuffix} already exists!`);

    return `${issuerId}.${classSuffix}`;
  } catch (err) {
    if (err.response && err.response.status !== 404) {
      // Something else went wrong...
      console.log(err);
      return `${issuerId}.${classSuffix}`;
    }
  }

  // See link below for more information on required properties
  // https://developers.google.com/wallet/retail/loyalty-cards/rest/v1/loyaltyclass
  let newClass = {
    'id': `${issuerId}.${classSuffix}`,
    'issuerName': 'Issuer name',
    'reviewStatus': 'UNDER_REVIEW',
    'programName': 'Program name',
    'programLogo': {
      'sourceUri': {
        'uri': 'http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg'
      },
      'contentDescription': {
        'defaultValue': {
          'language': 'en-US',
          'value': 'Logo description'
        }
      }
    }
  };

  response = await this.client.loyaltyclass.insert({
    requestBody: newClass
  });

  console.log('Class insert response');
  console.log(response);

  return `${issuerId}.${classSuffix}`;
}

शुरू करें

Go में अपना इंटिग्रेशन शुरू करने के लिए, GitHub पर हमारे पूरे कोड सैंपल देखें GitHub पर कोड सैंपल.

// Create a class.
func (d *demoLoyalty) createClass(issuerId, classSuffix string) {
	logo := walletobjects.Image{
		SourceUri: &walletobjects.ImageUri{
			Uri: "http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg",
		},
	}
	loyaltyClass := new(walletobjects.LoyaltyClass)
	loyaltyClass.Id = fmt.Sprintf("%s.%s", issuerId, classSuffix)
	loyaltyClass.ProgramName = "Program name"
	loyaltyClass.IssuerName = "Issuer name"
	loyaltyClass.ReviewStatus = "UNDER_REVIEW"
	loyaltyClass.ProgramLogo = &logo
	res, err := d.service.Loyaltyclass.Insert(loyaltyClass).Do()
	if err != nil {
		log.Fatalf("Unable to insert class: %v", err)
	} else {
		fmt.Printf("Class insert id:\n%v\n", res.Id)
	}
}

पास ऑब्जेक्ट बनाएं

पास्स ऑब्जेक्ट, पास क्लास का एक इंस्टेंस है. पास ऑब्जेक्ट बनाने के लिए, आपको ये एट्रिब्यूट देने होंगे:

classId: पास की कैटगरी का id

id: आपके ग्राहक के लिए एक यूनीक आईडी

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

पास ऑब्जेक्ट बनाने के लिए कोड सैंपल: