Bu sayfa, Cloud Translation API ile çevrilmiştir.

Kartlar Sınıfları ve Kartlar Nesneleri Oluşturma

Son kullanıcıların Google Cüzdan'a kaydetmeleri için verebileceğiniz kartların neredeyse tamamı iki bileşenle tanımlanır: Kartlar Sınıfı ve Kartlar Nesnesi. Bir kullanıcıya her kart verdiğinizde, hem Kartlar Sınıfı hem de Kartlar Nesnesinin bir örneğine ihtiyacınız olacaktır. Bu örnekler, Google Cüzdan API'sine ne tür bir kart oluşturmanız gerektiğini ve kart üzerinde görüntülenecek, hediye kartının değeri veya bilet sahibinin adı gibi ayrıntıları bildirir.

Google Cüzdan API'si, örneklerini oluşturup ardından GiftCardClass, GiftCardObject, GenericClass ve GenericObject gibi kullanıcılara verilen bir kart oluşturmak için kullanabileceğiniz önceden tanımlanmış Kartlar Sınıfları ve Kartlar Nesneleri grubu sağlar.

Her Geçer Sınıfı ve Nesne Nesnesi örneği bir JSON nesnesi olarak tanımlanır. JSON nesnesi, söz konusu geçiş türü için amaçlanan belirli kullanım alanına karşılık gelen bir dizi zorunlu ve isteğe bağlı özelliğe sahiptir.

Kartlar Sınıfı Oluşturun

Kartlar Sınıfı, kartların oluşturulduğu paylaşılan bir şablon olarak düşünülebilir. Kartlar Sınıfı, kendisini kullanan tüm kartlara dahil edilecek belirli özellikleri tanımlar. Kartı veren kuruluş, her biri stil ve görünüm gibi özellikleri tanımlayan kendine özgü özelliklere ek olarak Akıllı Dokunma, Kayıt ve Oturum Açma gibi ek özelliklere sahip olan birden fazla sınıf oluşturabilir.

Kartlar Sınıfları Google Cüzdan REST API'si, Google Cüzdan Android SDK'sı veya Google Cüzdan İşletme Konsolu'nda oluşturulabilir.

Yeni kullanıcılar için Business Console, Kartlar Sınıfı oluşturmaya başlamanın en kolay yoludur. Bu araç, form alanlarını doldurarak ilk Kartlar Sınıfınızın çeşitli alanlarını tanımlayabileceğiniz basit bir kullanıcı arayüzü sunar.

İleri düzey kullanıcılar için Kartlar Sınıflarını programatik olarak oluşturmak en iyi yaklaşımdır.

Google Cüzdan İşletme Konsolu'nu kullanma

Google Cüzdan İşletme Konsolu'nda Kartlar Sınıfı oluşturmak için aşağıdakileri yapın:

Google Pay ve Wallet Business Console'a gidin ve Google Cüzdan API'si Veren Hesabınızla oturum açın.
"Google Cüzdan API'si" kartında "Kartları yönet" düğmesini tıklayın.
"Yayınlama erişimi elde edin" bölümünde "Sınıf oluştur" düğmesini tıklayın.
İletişim kutusundan geçiş türü seçin. Google Cüzdan çeşitli kart türleri (Etkinlik Bileti, Teklif, Bağlılık Kartı vb.) sunar. Esnek kullanım alanı için kart türü olarak "Genel"i seçin.
Zorunlu alanlar için uygun değerleri girin.
Sınıfınızı kaydetmek için "Sınıf oluştur" düğmesini tıklayın.

Google Cüzdan REST API'sini kullanma

Google Cüzdan REST API'sini kullanarak Kartlar Sınıfı oluşturmak için https://walletobjects.googleapis.com/walletobjects/v1/flightClass adresine POST isteği gönderin. Daha fazla bilgi için referans belgelerini inceleyin.

Java

Java entegrasyonunuzu başlatmak için GitHub'daki kod örneklerimizin tamamına bakın.

/**
 * 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.flightclass().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/boarding-passes/rest/v1/flightclass
  FlightClass newClass =
      new FlightClass()
          .setId(String.format("%s.%s", issuerId, classSuffix))
          .setIssuerName("Issuer name")
          .setReviewStatus("UNDER_REVIEW")
          .setLocalScheduledDepartureDateTime("2023-07-02T15:30:00")
          .setFlightHeader(
              new FlightHeader()
                  .setCarrier(new FlightCarrier().setCarrierIataCode("LX"))
                  .setFlightNumber("123"))
          .setOrigin(new AirportInfo().setAirportIataCode("LAX").setTerminal("1").setGate("A2"))
          .setDestination(
              new AirportInfo().setAirportIataCode("SFO").setTerminal("2").setGate("C3"));

  FlightClass response = service.flightclass().insert(newClass).execute();

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

  return response.getId();
}

PHP

PHP ile entegrasyonunuzu başlatmak için GitHub'daki kod örneklerimizin tamamına bakın.

/**
 * 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 {
    $response = $this->service->flightclass->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/boarding-passes/rest/v1/flightclass
  $newClass = new FlightClass([
    'id' => "{$issuerId}.{$classSuffix}",
    'issuerName' => 'Issuer name',
    'reviewStatus' => 'UNDER_REVIEW',
    'localScheduledDepartureDateTime' => '2023-07-02T15:30:00',
    'flightHeader' => new FlightHeader([
      'carrier' => new FlightCarrier([
        'carrierIataCode' => 'LX'
      ]),
      'flightNumber' => '123'
    ]),
    'origin' => new AirportInfo([
      'airportIataCode' => 'LAX',
      'terminal' => '1',
      'gate' => 'A2'
    ]),
    'destination' => new AirportInfo([
      'airportIataCode' => 'SFO',
      'terminal' => '2',
      'gate' => 'C3'
    ])
  ]);

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

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

  return $response->id;
}

Python

Python'da entegrasyonunuzu başlatmak için GitHub'daki kod örneklerimizin tamamına bakın.

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.flightclass().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 = {
        'id': f'{issuer_id}.{class_suffix}',
        'issuerName': 'Issuer name',
        'reviewStatus': 'UNDER_REVIEW',
        'localScheduledDepartureDateTime': '2023-07-02T15:30:00',
        'flightHeader': {
            'carrier': {
                'carrierIataCode': 'LX'
            },
            'flightNumber': '123'
        },
        'origin': {
            'airportIataCode': 'LAX',
            'terminal': '1',
            'gate': 'A2'
        },
        'destination': {
            'airportIataCode': 'SFO',
            'terminal': '2',
            'gate': 'C3'
        }
    }

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

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

    return f'{issuer_id}.{class_suffix}'

C#

C# ile entegrasyonunuzu başlatmak için GitHub'daki kod örneklerimizin tamamına bakın.

/// <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.Flightclass
      .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/boarding-passes/rest/v1/flightclass
  FlightClass newClass = new FlightClass
  {
    Id = $"{issuerId}.{classSuffix}",
    IssuerName = "Issuer name",
    ReviewStatus = "UNDER_REVIEW",
    LocalScheduledDepartureDateTime = "2023-07-02T15:30:00",
    FlightHeader = new FlightHeader
    {
      Carrier = new FlightCarrier
      {
        CarrierIataCode = "LX"
      },
      FlightNumber = "123"
    },
    Origin = new AirportInfo
    {
      AirportIataCode = "LAX",
      Terminal = "1",
      Gate = "A2"
    },
    Destination = new AirportInfo
    {
      AirportIataCode = "SFO",
      Terminal = "2",
      Gate = "C3"
    }
  };

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

Düğüm'de entegrasyonunuzu başlatmak için GitHub'daki kod örneklerimizin tamamına bakın.

/**
 * 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.flightclass.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/boarding-passes/rest/v1/flightclass
  let newClass = {
    'id': `${issuerId}.${classSuffix}`,
    'issuerName': 'Issuer name',
    'reviewStatus': 'UNDER_REVIEW',
    'localScheduledDepartureDateTime': '2023-07-02T15:30:00',
    'flightHeader': {
      'carrier': {
        'carrierIataCode': 'LX'
      },
      'flightNumber': '123'
    },
    'origin': {
      'airportIataCode': 'LAX',
      'terminal': '1',
      'gate': 'A2'
    },
    'destination': {
      'airportIataCode': 'SFO',
      'terminal': '2',
      'gate': 'C3'
    }
  };

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

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

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

Go

Go ile entegrasyonunuzu başlatmak için GitHub'daki GitHub'daki kod örneklerimizin tamamını içeren kod örneklerimize bakın.

// Create a class.
func (d *demoFlight) createClass(issuerId, classSuffix string) {
	flightClass := new(walletobjects.FlightClass)
	flightClass.Id = fmt.Sprintf("%s.%s", issuerId, classSuffix)
	flightClass.ReviewStatus = "UNDER_REVIEW"
	flightClass.IssuerName = "Issuer name"
	flightClass.Origin = &walletobjects.AirportInfo{
		Terminal:        "1",
		Gate:            "A2",
		AirportIataCode: "LAX",
	}
	flightClass.Destination = &walletobjects.AirportInfo{
		Terminal:        "2",
		Gate:            "C3",
		AirportIataCode: "SFO",
	}
	flightClass.FlightHeader = &walletobjects.FlightHeader{
		Carrier: &walletobjects.FlightCarrier{
			CarrierIataCode: "LX",
		},
		FlightNumber: "123",
	}
	flightClass.LocalScheduledDepartureDateTime = "2023-06-12T23:20:50"

	res, err := d.service.Flightclass.Insert(flightClass).Do()
	if err != nil {
		log.Fatalf("Unable to insert class: %v", err)
	} else {
		fmt.Printf("Class insert id:\n%v\n", res.Id)
	}
}

Kartlar Nesnesi Oluşturma

Kartlar Nesnesi, Kartlar Sınıfının bir örneğidir. Kartlar Nesnesi oluşturmak için aşağıdaki özellikleri sağlamanız gerekir:

classId: Kartlar Sınıfı arasında id.

id: Müşterinizin benzersiz bir kimliği

Bu özelliklerin biniş kartında nasıl gösterildiği hakkında daha fazla bilgi için Düzen şablonuna bakın.

Passes nesnesi oluşturmak için kod örneği: