Diese Seite wurde von der Cloud Translation API übersetzt.

Karten-/Ticketklassen und Karten-/Ticketobjekte erstellen

Fast alle Karten/Tickets, die Sie einem Endnutzer zum Speichern in Google Wallet ausstellen können, werden durch zwei Komponenten definiert: eine Karten-/Ticketklasse und ein Karten-/Ticketobjekt. Jedes Mal, wenn Sie einem Nutzer eine Karte bzw. ein Ticket ausstellen, benötigen Sie eine Instanz einer Karten-/Ticketklasse und eines Karten-/Ticketobjekts, das der Google Wallet API mitteilt, welche Art von Karte/Ticket erstellt werden soll. Außerdem werden Details auf der Karte bzw. dem Ticket angezeigt, z. B. der Wert einer Geschenkkarte oder der Name des Ticketinhabers.

Die Google Wallet API bietet einen vordefinierten Satz von Karten-/Ticketklassen und Karten-/Ticketobjekten, für die du Instanzen erstellst und mit denen du dann eine Karte bzw. ein Ticket für einen Nutzer erstellst, z. B. GiftCardClass und GiftCardObject, GenericClass und GenericObject.

Jede Karten-/Ticketklasse und jede Karten-/Ticketobjektinstanz sind als JSON-Objekt mit einer Reihe von erforderlichen und optionalen Attributen definiert, die dem spezifischen Anwendungsfall entsprechen, der für diesen Karten-/Tickettyp vorgesehen ist.

Karten-/Ticketklasse erstellen

Eine Karten-/Ticketklasse kann als eine freigegebene Vorlage betrachtet werden, aus der Karten/Tickets erstellt werden. Mit einer Karten-/Ticketklasse werden bestimmte Attribute definiert, die in allen Karten/Tickets enthalten sind, in denen sie verwendet wird. Ein Karten-/Ticketaussteller kann mehrere Klassen mit jeweils eigenen charakteristischen Eigenschaften erstellen, die Attribute wie Stil und Erscheinungsbild definieren, sowie zusätzliche Funktionen wie Smart-Bonus und die Registrierung und Anmeldung.

Karten-/Ticketklassen können mit der Google Wallet REST API, dem Google Wallet Android SDK oder in der Google Wallet Business Console erstellt werden.

Für neue Nutzer ist die Business Console die einfachste Möglichkeit, eine Karten-/Ticketklasse zu erstellen. Sie bietet eine einfache Benutzeroberfläche, auf der Sie die verschiedenen Felder Ihrer ersten Karten-/Ticketklasse definieren können, indem Sie Formularfelder ausfüllen.

Für fortgeschrittene Nutzer ist das programmatische Erstellen von Karten-/Ticketklassen die beste Methode.

Google Wallet Business Console verwenden

So erstellen Sie eine Karten-/Ticketklasse in der Google Wallet Business Console:

Rufe die Google Pay & Wallet Business Console auf und melde dich mit deinem Google Wallet API-Ausstellerkonto an.
Über die „Google Wallet API“ klicken Sie auf die Schaltfläche „Karten/Tickets verwalten“ Schaltfläche.
Klicken Sie unter „Veröffentlichungszugriff erhalten“ auf die Schaltfläche „Kurs erstellen“. Schaltfläche.
Wählen Sie im Dialogfeld einen Karten-/Tickettyp aus. Google Wallet bietet verschiedene Arten von Karten/Tickets (Veranstaltungsticket, Angebot, Kundenkarte usw.). Für flexible Anwendungsfälle „Allgemein“ auswählen als Karten-/Tickettyp aus.
Geben Sie die entsprechenden Werte in die erforderlichen Felder ein.
Klicken Sie auf „Klasse erstellen“. um den Kurs zu speichern.

Google Wallet REST API verwenden

Sende eine POST-Anfrage an https://walletobjects.googleapis.com/walletobjects/v1/offerClass, um mit der Google Wallet REST API eine Karten-/Ticketklasse zu erstellen. Weitere Informationen finden Sie in der Referenzdokumentation.

Java

Um Ihre Integration in Java zu starten, lesen Sie unsere vollständige <ph type="x-smartling-placeholder"></ph> Codebeispiele auf 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.offerclass().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/offers/rest/v1/offerclass
  OfferClass newClass =
      new OfferClass()
          .setId(String.format("%s.%s", issuerId, classSuffix))
          .setIssuerName("Issuer name")
          .setReviewStatus("UNDER_REVIEW")
          .setProvider("Provider name")
          .setTitle("Offer title")
          .setRedemptionChannel("ONLINE");

  OfferClass response = service.offerclass().insert(newClass).execute();

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

  return response.getId();
}

PHP

Um mit der Integration in PHP zu beginnen, lesen Sie unsere vollständigen <ph type="x-smartling-placeholder"></ph> Codebeispiele auf 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->offerclass->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/offers/rest/v1/offerclass
  $newClass = new OfferClass([
    'id' => "{$issuerId}.{$classSuffix}",
    'issuerName' => 'Issuer name',
    'reviewStatus' => 'UNDER_REVIEW',
    'provider' => 'Provider name',
    'title' => 'Offer title',
    'redemptionChannel' => 'ONLINE'
  ]);

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

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

  return $response->id;
}

Python

Informationen zum Starten Ihrer Integration in Python finden Sie in unserer vollständigen <ph type="x-smartling-placeholder"></ph> Codebeispiele auf 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.offerclass().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/offers/rest/v1/offerclass
    new_class = {
        'id': f'{issuer_id}.{class_suffix}',
        'issuerName': 'Issuer name',
        'reviewStatus': 'UNDER_REVIEW',
        'provider': 'Provider name',
        'title': 'Offer title',
        'redemptionChannel': 'ONLINE'
    }

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

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

    return f'{issuer_id}.{class_suffix}'

C#

Informationen zum Starten Ihrer Integration in C# finden Sie in unserer vollständigen <ph type="x-smartling-placeholder"></ph> Codebeispiele auf 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.Offerclass
      .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/offers/rest/v1/offerclass
  OfferClass newClass = new OfferClass
  {
    Id = $"{issuerId}.{classSuffix}",
    IssuerName = "Issuer name",
    ReviewStatus = "UNDER_REVIEW",
    Provider = "Provider name",
    Title = "Offer title",
    RedemptionChannel = "ONLINE"
  };

  responseStream = service.Offerclass
      .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

Informationen zum Starten Ihrer Integration in Node.js finden Sie in unserer vollständigen <ph type="x-smartling-placeholder"></ph> Codebeispiele auf 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.offerclass.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/offers/rest/v1/offerclass
  let newClass = {
    'id': `${issuerId}.${classSuffix}`,
    'issuerName': 'Issuer name',
    'reviewStatus': 'UNDER_REVIEW',
    'provider': 'Provider name',
    'title': 'Offer title',
    'redemptionChannel': 'ONLINE'
  };

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

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

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

Ok

Informationen zum Starten der Integration in Go finden Sie in unseren vollständigen Codebeispielen auf GitHub <ph type="x-smartling-placeholder"></ph> Codebeispiele auf GitHub

// Create a class.
func (d *demoOffer) createClass(issuerId, classSuffix string) {
	offerClass := new(walletobjects.OfferClass)
	offerClass.Id = fmt.Sprintf("%s.%s", issuerId, classSuffix)
	offerClass.RedemptionChannel = "ONLINE"
	offerClass.ReviewStatus = "UNDER_REVIEW"
	offerClass.Title = "Offer title"
	offerClass.IssuerName = "Issuer name"
	offerClass.Provider = "Provider name"
	res, err := d.service.Offerclass.Insert(offerClass).Do()
	if err != nil {
		log.Fatalf("Unable to insert class: %v", err)
	} else {
		fmt.Printf("Class insert id:\n%v\n", res.Id)
	}
}

Karten-/Ticketobjekt erstellen

Ein Karten-/Ticketobjekt ist eine Instanz einer Karten-/Ticketklasse. So erstellen Sie Karten/Tickets Objekt enthält, müssen Sie die folgenden Attribute angeben:

classId: Die id der Karten-/Ticketklasse

id: Eine eindeutige ID für Ihren Kunden

Weitere Informationen finden Sie im Layoutvorlage finden Sie weitere Informationen zur Darstellung dieser Attribute in der zu bieten.

Codebeispiel zum Erstellen eines Karten-/Ticketobjekts: