Trang này được dịch bởi Cloud Translation API.

Tạo các lớp và đối tượng thẻ và vé

Hầu hết các thẻ và vé mà bạn có thể cấp cho người dùng cuối lưu trong Google Wallet của họ đều được xác định bởi hai thành phần: Lớp thẻ và vé và Đối tượng thẻ và vé. Bất cứ khi nào cấp thẻ và vé cho người dùng, bạn sẽ cần một bản sao của cả Loại thẻ và vé để Đối tượng thẻ và vé cho API Google Wallet biết loại thẻ và vé cần tạo, cũng như thông tin chi tiết cần hiển thị trên thẻ/vé, chẳng hạn như giá trị của thẻ quà tặng hoặc tên chủ vé.

Google Wallet API cung cấp một tập hợp được xác định trước gồm các Lớp và Đối tượng thẻ và vé mà bạn tạo các thực thể, sau đó dùng để tạo thẻ và vé được cấp cho người dùng, chẳng hạn như GiftCardClass và GiftCardObject, GenericClass và GenericObject, v.v.

Mỗi thực thể của Lớp truyền và Đối tượng truyền được định nghĩa là một đối tượng JSON. Đối tượng này có một tập hợp các thuộc tính bắt buộc và không bắt buộc tương ứng với trường hợp sử dụng cụ thể dành cho loại truyền đó.

Tạo một lớp Thẻ và vé

Lớp Thẻ và vé có thể được coi là một mẫu dùng chung dùng để tạo thẻ và vé. Lớp Thẻ và vé xác định một số thuộc tính sẽ được thêm vào tất cả các thẻ và vé sử dụng thuộc tính này. Tổ chức phát hành thẻ và vé có thể tạo nhiều lớp, mỗi lớp có một bộ thuộc tính riêng để xác định các thuộc tính như kiểu và giao diện, cũng như các tính năng bổ sung như Chạm thông minh, Đăng ký và Đăng nhập.

Bạn có thể tạo lớp Thẻ và vé bằng cách sử dụng API REST của Google Wallet, SDK Android của Google Wallet hoặc trong Google Wallet Business Console.

Đối với người dùng mới, Business Console là cách dễ dàng nhất để bắt đầu tạo Lớp thẻ và vé, vì phiên bản này cung cấp một giao diện người dùng đơn giản, nơi bạn có thể xác định nhiều trường của Lớp thẻ và vé đầu tiên bằng cách điền thông tin vào các trường trong biểu mẫu.

Đối với người dùng thành thạo, việc tạo Lớp thẻ và vé theo phương thức lập trình là phương pháp hay nhất.

Sử dụng Google Wallet Business Console

Để tạo Lớp thẻ và vé trong bảng điều khiển Google Wallet Business, hãy làm như sau:

Truy cập vào Google Pay và Wallet Business Console rồi đăng nhập bằng Tài khoản nhà phát hành API Google Wallet của bạn.
Trên thẻ "API Google Wallet", hãy nhấp vào nút "Quản lý thẻ và vé".
Trong phần "Nhận quyền phát hành", hãy nhấp vào nút "Tạo lớp học".
Chọn một loại thẻ và vé trong hộp thoại. Google Wallet cung cấp nhiều loại thẻ và vé (Vé xem sự kiện, Ưu đãi, Thẻ khách hàng thân thiết, v.v.). Đối với trường hợp sử dụng linh hoạt, hãy chọn "Chung" làm loại thẻ và vé.
Điền vào các giá trị thích hợp vào các trường bắt buộc.
Nhấp vào nút "Tạo lớp học" để lưu lớp học của bạn.

Sử dụng API REST của Google Wallet

Để tạo một Lớp thẻ và vé bằng API REST của Google Wallet, hãy gửi yêu cầu POST đến https://walletobjects.googleapis.com/walletobjects/v1/genericClass. Để biết thêm thông tin, hãy xem tài liệu tham khảo.

Java

Để bắt đầu tích hợp trong Java, hãy tham khảo mã mẫu hoàn chỉnh trên GitHub của chúng tôi.

/**
 * 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.genericclass().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/generic/rest/v1/genericclass
  GenericClass newClass = new GenericClass().setId(String.format("%s.%s", issuerId, classSuffix));

  GenericClass response = service.genericclass().insert(newClass).execute();

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

  return response.getId();
}

1.199

Để bắt đầu tích hợp bằng PHP, hãy tham khảo mã mẫu hoàn chỉnh trên GitHub của chúng tôi.

/**
 * 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->genericclass->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/generic/rest/v1/genericclass
  $newClass = new GenericClass([
    'id' => "{$issuerId}.{$classSuffix}"
  ]);

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

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

  return $response->id;
}

Python

Để bắt đầu tích hợp trong Python, hãy tham khảo mã mẫu hoàn chỉnh của chúng tôi trên 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.genericclass().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/generic/rest/v1/genericclass
    new_class = {'id': f'{issuer_id}.{class_suffix}'}

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

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

    return f'{issuer_id}.{class_suffix}'

C#

Để bắt đầu tích hợp trong C#, hãy tham khảo mã mẫu hoàn chỉnh của chúng tôi trên 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.Genericclass
      .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/generic/rest/v1/genericclass
  GenericClass newClass = new GenericClass
  {
    Id = $"{issuerId}.{classSuffix}"
  };

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

Để bắt đầu tích hợp trong Nút, hãy tham khảo mã mẫu hoàn chỉnh của chúng tôi trên 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.genericclass.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/generic/rest/v1/genericclass
  let newClass = {
    'id': `${issuerId}.${classSuffix}`
  };

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

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

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

Go

Để bắt đầu tích hợp trong Go, hãy tham khảo mã mẫu hoàn chỉnh của chúng tôi trên GitHub các mã mẫu trên GitHub.

// Create a class.
func (d *demoGeneric) createClass(issuerId, classSuffix string) {
	genericClass := new(walletobjects.GenericClass)
	genericClass.Id = fmt.Sprintf("%s.%s", issuerId, classSuffix)
	res, err := d.service.Genericclass.Insert(genericClass).Do()
	if err != nil {
		log.Fatalf("Unable to insert class: %v", err)
	} else {
		fmt.Printf("Class insert id:\n%v\n", res.Id)
	}
}

Tạo một đối tượng thẻ và vé

Đối tượng thẻ và vé là một thực thể của Lớp thẻ và vé. Để tạo một Đối tượng thẻ và vé, bạn phải cung cấp các thuộc tính sau:

classId: id của lớp Thẻ và vé

id: Mã nhận dạng duy nhất của khách hàng

Mã mẫu để tạo một Đối tượng thẻ và vé: