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

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

การอัปเดตบัตรอยู่เสมอเป็นวิธีสำคัญในการมีส่วนร่วมกับลูกค้าและสร้างประสบการณ์การใช้งานที่ดี

มีทรัพยากร 2 รายการที่อัปเดตได้ ได้แก่ TransitClass และ TransitObject

แนวทางปฏิบัติแนะนำ

รายการต่อไปนี้มีข้อมูลที่เป็นประโยชน์ที่ควรพิจารณาเมื่ออัปเดตคลาสและออบเจ็กต์ของบัตรโดยสาร

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

อัปเดตคลาสของบัตร

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

คุณแก้ไขคลาสบัตร (ไม่ใช่ออบเจ็กต์) ได้โดยตรงใน Google Pay และ Wallet Console

ไปที่คอนโซล
เลือก Google Wallet API
เลือกชั้นเรียนที่ต้องการแก้ไข
เลือกแก้ไข
อัปเดตพร็อพเพอร์ตี้ของชั้นเรียน
เลือกบันทึก

เมื่อบันทึกการเปลี่ยนแปลงแล้ว ระบบจะอัปเดตคลาสโดยอัตโนมัติสำหรับผู้ถือขนส่งสาธารณะทุกคน

ใช้ Google Wallet API

การอัปเดต TransitClass จะส่งผลต่อผู้ใช้ทุกคนที่ได้รับการจัดสรรบัตรโดยสารที่ใช้คลาสนี้ เช่น หากต้องการอัปเดตโลโก้สำหรับบัตรโดยสาร คุณจะต้องส่งคำขอ update หรือ patch ไปยัง Google Wallet API ที่ปลายทางใดก็ได้ต่อไปนี้ ค่า resourceId จะเป็นรหัสคลาส (ISSUER_ID.CLASS_SUFFIX)

# Update
PUT https://walletobjects.googleapis.com/walletobjects/v1/transitclass/{resourceId}

# Patch
PATCH https://walletobjects.googleapis.com/walletobjects/v1/transitclass/{resourceId}

ดูข้อมูลเพิ่มเติมได้ที่เอกสารอ้างอิง API

Java

หากต้องการเริ่มการผสานรวมใน Java โปรดดู ตัวอย่างโค้ดทั้งหมดบน GitHub

/**
 * Update a class.
 *
 * <p><strong>Warning:</strong> This replaces all existing class attributes!
 *
 * @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 updateClass(String issuerId, String classSuffix) throws IOException {
  TransitClass updatedClass;

  // Check if the class exists
  try {
    updatedClass =
        service.transitclass().get(String.format("%s.%s", issuerId, classSuffix)).execute();
  } catch (GoogleJsonResponseException ex) {
    if (ex.getStatusCode() == 404) {
      // Class does not exist
      System.out.printf("Class %s.%s not found!%n", issuerId, classSuffix);
      return String.format("%s.%s", issuerId, classSuffix);
    } else {
      // Something else went wrong...
      ex.printStackTrace();
      return String.format("%s.%s", issuerId, classSuffix);
    }
  }

  // Class exists
  // Update the class by adding a homepage
  updatedClass.setHomepageUri(
      new Uri()
          .setUri("https://developers.google.com/wallet")
          .setDescription("Homepage description"));

  // Note: reviewStatus must be 'UNDER_REVIEW' or 'DRAFT' for updates
  updatedClass.setReviewStatus("UNDER_REVIEW");

  TransitClass response =
      service
          .transitclass()
          .update(String.format("%s.%s", issuerId, classSuffix), updatedClass)
          .execute();

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

  return response.getId();
}

PHP

หากต้องการเริ่มการผสานรวมใน PHP โปรดดู ตัวอย่างโค้ดทั้งหมดบน GitHub

/**
 * Update a class.
 *
 * **Warning:** This replaces all existing class attributes!
 *
 * @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 updateClass(string $issuerId, string $classSuffix)
{
  // Check if the class exists
  try {
    $updatedClass = $this->service->transitclass->get("{$issuerId}.{$classSuffix}");
  } catch (Google\Service\Exception $ex) {
    if (!empty($ex->getErrors()) && $ex->getErrors()[0]['reason'] == 'classNotFound') {
      // Class does not exist
      print("Class {$issuerId}.{$classSuffix} not found!");
      return "{$issuerId}.{$classSuffix}";
    } else {
      // Something else went wrong...
      print_r($ex);
      return "{$issuerId}.{$classSuffix}";
    }
  }

  // Update the class by adding a homepage
  $updatedClass->setHomepageUri(new Uri([
    'uri' => 'https://developers.google.com/wallet',
    'description' => 'Homepage description'
  ]));

  // Note: reviewStatus must be 'UNDER_REVIEW' or 'DRAFT' for updates
  $updatedClass->setReviewStatus('UNDER_REVIEW');

  $response = $this->service->transitclass->update("{$issuerId}.{$classSuffix}", $updatedClass);

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

  return $response->id;
}

Python

หากต้องการเริ่มการผสานรวมใน Python โปรดดู ตัวอย่างโค้ดทั้งหมดบน GitHub

def update_class(self, issuer_id: str, class_suffix: str) -> str:
    """Update a class.

    **Warning:** This replaces all existing class attributes!

    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:
        response = self.client.transitclass().get(resourceId=f'{issuer_id}.{class_suffix}').execute()
    except HttpError as e:
        if e.status_code == 404:
            print(f'Class {issuer_id}.{class_suffix} not found!')
            return f'{issuer_id}.{class_suffix}'
        else:
            # Something else went wrong...
            print(e.error_details)
            return f'{issuer_id}.{class_suffix}'

    # Class exists
    updated_class = response

    # Update the class by adding a homepage
    updated_class['homepageUri'] = {
        'uri': 'https://developers.google.com/wallet',
        'description': 'Homepage description'
    }

    # Note: reviewStatus must be 'UNDER_REVIEW' or 'DRAFT' for updates
    updated_class['reviewStatus'] = 'UNDER_REVIEW'

    response = self.client.transitclass().update(
        resourceId=f'{issuer_id}.{class_suffix}',
        body=updated_class).execute()

    print('Class update response')
    print(response)

    return f'{issuer_id}.{class_suffix}'

C#

หากต้องการเริ่มการผสานรวมใน C# โปรดดู ตัวอย่างโค้ดทั้งหมดบน GitHub

/// <summary>
/// Update a class.
/// <para />
/// <strong>Warning:</strong> This replaces all existing class attributes!
/// </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 UpdateClass(string issuerId, string classSuffix)
{
  // Check if the class exists
  Stream responseStream = service.Transitclass
      .Get($"{issuerId}.{classSuffix}")
      .ExecuteAsStream();

  StreamReader responseReader = new StreamReader(responseStream);
  JObject jsonResponse = JObject.Parse(responseReader.ReadToEnd());

  if (jsonResponse.ContainsKey("error"))
  {
    if (jsonResponse["error"].Value<int>("code") == 404)
    {
      // Class does not exist
      Console.WriteLine($"Class {issuerId}.{classSuffix} not found!");
      return $"{issuerId}.{classSuffix}";
    }
    else
    {
      // Something else went wrong...
      Console.WriteLine(jsonResponse.ToString());
      return $"{issuerId}.{classSuffix}";
    }
  }

  // Class exists
  TransitClass updatedClass = JsonConvert.DeserializeObject<TransitClass>(jsonResponse.ToString());

  // Update the class by adding a homepage
  updatedClass.HomepageUri = new Google.Apis.Walletobjects.v1.Data.Uri
  {
    UriValue = "https://developers.google.com/wallet",
    Description = "Homepage description"
  };

  // Note: reviewStatus must be 'UNDER_REVIEW' or 'DRAFT' for updates
  updatedClass.ReviewStatus = "UNDER_REVIEW";

  responseStream = service.Transitclass
      .Update(updatedClass, $"{issuerId}.{classSuffix}")
      .ExecuteAsStream();

  responseReader = new StreamReader(responseStream);
  jsonResponse = JObject.Parse(responseReader.ReadToEnd());

  Console.WriteLine("Class update response");
  Console.WriteLine(jsonResponse.ToString());

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

Node.js

หากต้องการเริ่มการผสานรวมในโหนด โปรดดู ตัวอย่างโค้ดทั้งหมดบน GitHub

/**
 * Update a class.
 *
 * **Warning:** This replaces all existing class attributes!
 *
 * @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 updateClass(issuerId, classSuffix) {
  let response;

  // Check if the class exists
  try {
    response = await this.client.transitclass.get({
      resourceId: `${issuerId}.${classSuffix}`
    });
  } catch (err) {
    if (err.response && err.response.status === 404) {
      console.log(`Class ${issuerId}.${classSuffix} not found!`);
      return `${issuerId}.${classSuffix}`;
    } else {
      // Something else went wrong...
      console.log(err);
      return `${issuerId}.${classSuffix}`;
    }
  }

  // Class exists
  let updatedClass = response.data;

  // Update the class by adding a homepage
  updatedClass['homepageUri'] = {
    'uri': 'https://developers.google.com/wallet',
    'description': 'Homepage description'
  };

  // Note: reviewStatus must be 'UNDER_REVIEW' or 'DRAFT' for updates
  updatedClass['reviewStatus'] = 'UNDER_REVIEW';

  response = await this.client.transitclass.update({
    resourceId: `${issuerId}.${classSuffix}`,
    requestBody: updatedClass
  });

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

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

อัปเดตออบเจ็กต์บัตร

การอัปเดต TransitObject แต่ละรายการจะส่งผลต่อผู้ใช้ที่ได้รับการจัดสรรออบเจ็กต์ดังกล่าวเท่านั้น คุณควรอัปเดตบัตรโดยสารแต่ละใบเป็นประจำเพื่อแสดงการเปลี่ยนแปลงที่ส่งผลกระทบต่อลูกค้าและดึงดูดให้ลูกค้ามีส่วนร่วมอยู่เสมอ ค่า resourceId จะเป็นรหัสออบเจ็กต์ (ISSUER_ID.OBJECT_SUFFIX)

# Update
PUT https://walletobjects.googleapis.com/walletobjects/v1/transitobject/{resourceId}

# Patch
PATCH https://walletobjects.googleapis.com/walletobjects/v1/transitobject/{resourceId}