本頁面由 Cloud Translation API 翻譯而成。

建立票證類別和票證物件

讓使用者儲存至 Google 錢包的票證幾乎全都是由「票證類別」和「票證物件」這兩個元件定義。每次向使用者核發票證時，您都必須同時擁有票證類別和票證物件的例項，用於向 Google Wallet API 說明要建立哪種類型的票證，以及要顯示在票證上的詳細資料，例如禮物卡值或票券持有人的姓名。

Google Wallet API 提供了一組預先定義的票證類別和票證物件，可讓您建立這些例項，然後用來建立核發給使用者的票證，例如 GiftCardClass、GiftCardObject、GenericClass 和 GenericObject 等。

每個票證類別和票證物件執行個體都定義為 JSON 物件，其中包含一組必要屬性和選用屬性，對應到該票證類型的特定用途。

建立票證類別

票證類別可視為票證建立時使用的共用範本。票證類別會定義使用於其所有票證中的特定屬性。票證核發者可以建立多個類別，每一種類別都有各自的專屬屬性組合，用於定義樣式和外觀等屬性，以及智慧感應、註冊和登入等其他功能。

您可以使用 Google Wallet REST API、Google Wallet Android SDK 或 Google 錢包商家主控台建立票證類別。

如果您是新使用者，只要商家主控台提供簡易的使用者介面，即可在表單欄位中定義第一個票證類別的各個欄位，因此是首次建立票證類別最簡單的方法。

如果是進階使用者，最佳做法是透過程式輔助建立票證類別。

使用 Google 錢包商家主控台

如要在 Google 錢包商家主控台中建立票證類別，請按照下列步驟操作：

前往 Google Pay 和錢包商家主控台，並使用您的 Google Wallet API 發卡機構帳戶登入。
在「Google Wallet API」資訊卡上，按一下「管理票證」按鈕。
按一下「取得發布權限」下方的「建立課程」按鈕。
從對話方塊中選擇票證類型。Google 錢包提供多種票證類型 (活動票券、優惠、會員卡等)。如需彈性使用情境，請選取「一般」做為票證類型。
在必填欄位填入適當的值。
按一下「建立課程」按鈕即可儲存課程。

使用 Google Wallet REST API

如要使用 Google Wallet REST API 建立票證類別，請將 POST 要求傳送至 https://walletobjects.googleapis.com/walletobjects/v1/giftCardClass。詳情請參閱參考說明文件。

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.giftcardclass().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/gift-cards/rest/v1/giftcardclass
  GiftCardClass newClass =
      new GiftCardClass()
          .setId(String.format("%s.%s", issuerId, classSuffix))
          .setIssuerName("Issuer name")
          .setReviewStatus("UNDER_REVIEW");

  GiftCardClass response = service.giftcardclass().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->giftcardclass->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/gift-cards/rest/v1/giftcardclass
  $newClass = new GiftCardClass([
    'id' => "{$issuerId}.{$classSuffix}",
    'issuerName' => 'Issuer name',
    'reviewStatus' => 'UNDER_REVIEW'
  ]);

  $response = $this->service->giftcardclass->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.giftcardclass().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/gift-cards/rest/v1/giftcardclass
    new_class = {
        'id': f'{issuer_id}.{class_suffix}',
        'issuerName': 'Issuer name',
        'reviewStatus': 'UNDER_REVIEW'
    }

    response = self.client.giftcardclass().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.Giftcardclass
      .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/gift-cards/rest/v1/giftcardclass
  GiftCardClass newClass = new GiftCardClass
  {
    Id = $"{issuerId}.{classSuffix}",
    IssuerName = "Issuer name",
    ReviewStatus = "UNDER_REVIEW"
  };

  responseStream = service.Giftcardclass
      .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.giftcardclass.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/gift-cards/rest/v1/giftcardclass
  let newClass = {
    'id': `${issuerId}.${classSuffix}`,
    'issuerName': 'Issuer name',
    'reviewStatus': 'UNDER_REVIEW',
  };

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

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

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

查看

如要在 Go 中開始整合作業，請參閱 GitHub 上的完整程式碼範例 GitHub 上的程式碼範例。

// Create a class.
func (d *demoGiftcard) createClass(issuerId, classSuffix string) {
	giftcardClass := new(walletobjects.GiftCardClass)
	giftcardClass.Id = fmt.Sprintf("%s.%s", issuerId, classSuffix)
	giftcardClass.IssuerName = "Issuer name"
	giftcardClass.ReviewStatus = "UNDER_REVIEW"
	res, err := d.service.Giftcardclass.Insert(giftcardClass).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：客戶的專屬 ID

如要進一步瞭解這些屬性在禮物卡中的表示方式，請參閱版面配置範本。

建立票證物件的程式碼範例：