หน้านี้ได้รับการแปลโดย Cloud Translation API

สร้างคลาสและออบเจ็กต์บัตร

บัตรเกือบทั้งหมดที่คุณสามารถออกให้ผู้ใช้ปลายทางเพื่อบันทึกลงใน Google Wallet จะมีองค์ประกอบ 2 อย่างคือ คลาสบัตรและออบเจ็กต์บัตร ทุกครั้งที่ออกบัตรให้กับผู้ใช้ คุณจะต้องมีอินสแตนซ์ของทั้งคลาสบัตรและออบเจ็กต์บัตร ซึ่งจะบอก Google Wallet API ว่าควรสร้างบัตรประเภทใด รวมถึงมีรายละเอียดที่จะแสดงในบัตร เช่น มูลค่าของบัตรของขวัญหรือชื่อผู้ถือตั๋ว

Google Wallet API มีชุดออบเจ็กต์คลาสและบัตรที่กำหนดไว้ล่วงหน้าซึ่งคุณสร้างอินสแตนซ์ และใช้เพื่อสร้างบัตรที่ออกให้กับผู้ใช้ เช่น GiftCardClass, GiftCardObject, GenericClass และ GenericObject และอื่นๆ

อินสแตนซ์ Passes Class และ Passes แต่ละรายการได้รับการกำหนดเป็นออบเจ็กต์ JSON ซึ่งมีชุดพร็อพเพอร์ตี้ที่จำเป็นและไม่บังคับที่สอดคล้องกับ Use Case เฉพาะสําหรับประเภทบัตรนั้นๆ

สร้างชั้นเรียนบัตร

คลาสบัตรเป็นเทมเพลตที่ใช้ร่วมกันซึ่งสร้างบัตรขึ้น คลาสของบัตรจะกำหนดที่พักบางอย่างที่จะรวมไว้ในบัตรทั้งหมดที่ใช้บัตรดังกล่าว ผู้ออกบัตรสามารถสร้างได้หลายคลาส โดยแต่ละคลาสมีชุดพร็อพเพอร์ตี้เฉพาะของตนเองที่จะกำหนดแอตทริบิวต์ต่างๆ เช่น รูปแบบและลักษณะที่ปรากฏ รวมถึงฟีเจอร์เพิ่มเติม เช่น การแตะอัจฉริยะ รวมถึงการลงทะเบียนและลงชื่อเข้าใช้

คลาสของบัตรอาจสร้างได้โดยใช้ Google Wallet REST API, Google Wallet Android SDK หรือใน Google Wallet Business Console

สำหรับผู้ใช้ใหม่ คอนโซลธุรกิจเป็นวิธีที่ง่ายที่สุดในการเริ่มต้นใช้งานด้วยการสร้างคลาส Passes เนื่องจากมีอินเทอร์เฟซผู้ใช้ที่ใช้งานง่าย ซึ่งคุณกำหนดช่องต่างๆ ของคลาส Passes แรกได้โดยการกรอกข้อมูลในช่องในแบบฟอร์ม

สำหรับผู้ใช้ขั้นสูง การสร้างชั้นเรียนบัตรทางโปรแกรมเป็นวิธีที่ดีที่สุด

ใช้คอนโซลธุรกิจของ Google Wallet

หากต้องการสร้างคลาสบัตรในคอนโซลธุรกิจของ Google Wallet ให้ทำดังนี้

ไปที่คอนโซลธุรกิจ Google Pay และ Wallet และลงชื่อเข้าใช้ด้วยบัญชีผู้ออก Google Wallet API
ในการ์ด "Google Wallet API" ให้คลิกปุ่ม "จัดการบัตร"
ในส่วน "รับสิทธิ์เผยแพร่" ให้คลิกปุ่ม "สร้างชั้นเรียน"
เลือกประเภทบัตรจากกล่องโต้ตอบ Google Wallet มีบัตรประเภทต่างๆ (ตั๋วกิจกรรม ข้อเสนอ บัตรสะสมคะแนน ฯลฯ) สำหรับกรณีการใช้งานที่ยืดหยุ่น ให้เลือก "ทั่วไป" เป็นประเภทบัตร
กรอกค่าที่เหมาะสมสำหรับฟิลด์ที่จำเป็น
คลิกปุ่ม "สร้างชั้นเรียน" เพื่อบันทึกชั้นเรียน

ใช้ Google Wallet REST API

หากต้องการสร้างคลาสบัตรโดยใช้ Google Wallet REST API ให้ส่งคำขอ POST ไปที่ https://walletobjects.googleapis.com/walletobjects/v1/genericClass ดูข้อมูลเพิ่มเติมได้ในเอกสารอ้างอิง

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.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();
}

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->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

หากต้องการเริ่มการผสานรวมใน 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.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#

หากต้องการเริ่มการผสานรวมใน 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.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

หากต้องการเริ่มการผสานรวมในโหนด โปรดดู ตัวอย่างโค้ดทั้งหมดบน 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

หากต้องการเริ่มการผสานรวมใน Go ให้ดูตัวอย่างโค้ดทั้งหมดได้ใน ตัวอย่างโค้ดใน GitHub ของ 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)
	}
}

สร้างออบเจ็กต์บัตร

ออบเจ็กต์ Passes เป็นอินสแตนซ์ของคลาส Passes คุณต้องระบุแอตทริบิวต์ต่อไปนี้เพื่อสร้างออบเจ็กต์ Passes

classId: id ของคลาส Passes

id: รหัสที่ไม่ซ้ำกันสำหรับลูกค้าของคุณ

ตัวอย่างโค้ดสำหรับสร้างออบเจ็กต์ Passes