Diese Seite wurde von der Cloud Translation API übersetzt.

Karten-/Ticketklassen und Karten-/Ticketobjekte erstellen

Fast alle Karten/Tickets, die du für einen Endnutzer zum Speichern in seinem Google Wallet-Konto ausstellen kannst, werden durch zwei Komponenten definiert: eine Karten-/Ticketklasse und ein Karten-/Ticketobjekt. Wenn du eine Karte bzw. ein Ticket für einen Nutzer ausstellst, benötigst du eine Instanz einer Karten-/Ticketklasse und eines Karten-/Ticketobjekts, das der Google Wallet API mitteilt, welche Art von Karte/Ticket erstellt werden soll, sowie Details, die auf der Karte bzw. dem Ticket angezeigt werden sollen, z. B. der Wert einer Geschenkkarte oder der Name eines Ticketinhabers.

Die Google Wallet API bietet einen vordefinierten Satz von Karten-/Ticketklassen und Karten-/Ticketobjekten, für die du Instanzen erstellst. Mit diesen kannst du dann Karten/Tickets erstellen, die für einen Nutzer ausgestellt werden, z. B. GiftCardClass und GiftCardObject, GenericClass und GenericObject.

Jede Instanz der Karten-/Ticketklasse und des Karten-/Ticketobjekts ist als JSON-Objekt mit einer Reihe erforderlicher und optionaler Eigenschaften definiert, die dem spezifischen Anwendungsfall entsprechen, der für diesen Karten-/Tickettyp vorgesehen ist.

Karten-/Ticketklasse erstellen

Eine Karten-/Ticketklasse kann als gemeinsame Vorlage betrachtet werden, aus der Karten/Tickets erstellt werden. Eine Karten-/Ticketklasse definiert bestimmte Eigenschaften, die in allen Karten/Tickets enthalten sind, die sie verwenden. Ein Karten-/Ticketaussteller kann mehrere Klassen mit jeweils eigenen Eigenschaften erstellen, die Attribute wie Stil und Design sowie zusätzliche Funktionen wie Smart-Bonus sowie die Registrierung und Anmeldung definieren.

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 der einfachste Weg, eine Karten-/Ticketklasse zu erstellen. Sie bietet eine einfache Benutzeroberfläche, in der Sie die verschiedenen Felder der ersten Karten-/Ticketklasse definieren können, indem Sie Formularfelder ausfüllen.

Für fortgeschrittene Nutzer ist es am besten, Karten-/Ticketklassen programmatisch zu erstellen.

Google Wallet Business Console verwenden

So erstellst du 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.
Klicken Sie auf der Karte „Google Wallet API“ auf die Schaltfläche „Karten/Tickets verwalten“.
Klicken Sie unter „Veröffentlichungszugriff erhalten“ auf die Schaltfläche „Kurs erstellen“.
Wählen Sie im Dialogfeld einen Karten-/Tickettyp aus. Google Wallet bietet verschiedene Arten von Karten/Tickets (Veranstaltungsticket, Angebot, Kundenkarte usw.). Wähle für einen flexiblen Anwendungsfall „Allgemein“ als Karten-/Tickettyp aus.
Geben Sie die entsprechenden Werte in die Pflichtfelder ein.
Klicken Sie auf „Kurs erstellen“, um Ihren Kurs zu speichern.

Google Wallet REST API verwenden

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

Java

Sehen Sie sich zum Starten der Einbindung in Java unsere vollständigen Codebeispiele auf GitHub an.

/**
 * 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.eventticketclass().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/tickets/events/rest/v1/eventticketclass
  EventTicketClass newClass =
      new EventTicketClass()
          .setEventId(String.format("%s.%s", issuerId, classSuffix))
          .setEventName(
              new LocalizedString()
                  .setDefaultValue(
                      new TranslatedString().setLanguage("en-US").setValue("Event name")))
          .setId(String.format("%s.%s", issuerId, classSuffix))
          .setIssuerName("Issuer name")
          .setReviewStatus("UNDER_REVIEW");

  EventTicketClass response = service.eventticketclass().insert(newClass).execute();

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

  return response.getId();
}

PHP

Sehen Sie sich zum Starten der Einbindung in PHP unsere vollständigen Codebeispiele auf GitHub an.

/**
 * 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->eventticketclass->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/tickets/events/rest/v1/eventticketclass
  $newClass = new EventTicketClass([
    'eventId' => "{$issuerId}.{$classSuffix}",
    'eventName' => new LocalizedString([
      'defaultValue' => new TranslatedString([
        'language' => 'en-US',
        'value' => 'Event name'
      ])
    ]),
    'id' => "{$issuerId}.{$classSuffix}",
    'issuerName' => 'Issuer name',
    'reviewStatus' => 'UNDER_REVIEW'
  ]);

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

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

  return $response->id;
}

Python

Sehen Sie sich zum Starten der Integration in Python unsere vollständigen Codebeispiele auf GitHub an.

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.eventticketclass().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/tickets/events/rest/v1/eventticketclass
    new_class = {
        'eventId': f'{issuer_id}.{class_suffix}',
        'eventName': {
            'defaultValue': {
                'language': 'en-US',
                'value': 'Event name'
            }
        },
        'id': f'{issuer_id}.{class_suffix}',
        'issuerName': 'Issuer name',
        'reviewStatus': 'UNDER_REVIEW'
    }

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

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

    return f'{issuer_id}.{class_suffix}'

C#

Sehen Sie sich zum Starten der Einbindung in C# unsere vollständigen Codebeispiele auf GitHub an.

/// <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.Eventticketclass
      .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/tickets/events/rest/v1/eventticketclass
  EventTicketClass newClass = new EventTicketClass
  {
    EventId = $"{issuerId}.{classSuffix}",
    EventName = new LocalizedString
    {
      DefaultValue = new TranslatedString
      {
        Language = "en-US",
        Value = "Event name"
      }
    },
    Id = $"{issuerId}.{classSuffix}",
    IssuerName = "Issuer name",
    ReviewStatus = "UNDER_REVIEW"
  };

  responseStream = service.Eventticketclass
      .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 der Einbindung in Node finden Sie in unseren vollständigen Codebeispielen 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.eventticketclass.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/tickets/events/rest/v1/eventticketclass
  let newClass = {
    'eventId': `${issuerId}.${classSuffix}`,
    'eventName': {
      'defaultValue': {
        'language': 'en-US',
        'value': 'Event name'
      }
    },
    'id': `${issuerId}.${classSuffix}`,
    'issuerName': 'Issuer name',
    'reviewStatus': 'UNDER_REVIEW'
  };

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

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

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

Ok

Informationen zu den vollständigen Codebeispielen findest du in den Codebeispielen auf GitHub (in englischer Sprache).

// Create a class.
func (d *demoEventticket) createClass(issuerId, classSuffix string) {
	eventticketClass := new(walletobjects.EventTicketClass)
	eventticketClass.Id = fmt.Sprintf("%s.%s", issuerId, classSuffix)
	eventticketClass.EventName = &walletobjects.LocalizedString{
		DefaultValue: &walletobjects.TranslatedString{
			Language: "en-us",
			Value:    "Event name",
		},
	}
	eventticketClass.IssuerName = "Issuer name"
	eventticketClass.ReviewStatus = "UNDER_REVIEW"
	res, err := d.service.Eventticketclass.Insert(eventticketClass).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. Zum Erstellen eines Karten-/Ticketobjekts musst du die folgenden Attribute angeben:

classId: Die id der Karten-/Ticketklasse

id: Eine eindeutige ID für deinen Kunden

In der Layoutvorlage findest du weitere Informationen zur Darstellung dieser Attribute auf dem Veranstaltungsticket.

Codebeispiel zum Erstellen eines Karten-/Ticketobjekts: