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

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

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

มีแหล่งข้อมูล 2 อย่างที่อัปเดตได้ ได้แก่ TransitClass และ TransitObject

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

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

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

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

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

คลาส Pass (ไม่ใช่ออบเจ็กต์) จะแก้ไขได้โดยตรงใน 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}`;
}

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

การอัปเดต 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}