이 페이지는 Cloud Translation API를 통해 번역되었습니다.

패스 클래스 및 패스 객체 업데이트

패스를 최신 상태로 유지하는 것은 고객과 소통하고 긍정적인 경험을 구축하는 데 중요한 방법입니다.

업데이트할 수 있는 두 가지 리소스는 TransitClass 및 TransitObject입니다.

권장사항

다음 목록에는 대중교통 이용권 클래스 및 객체를 업데이트할 때 고려해야 할 유용한 정보가 포함되어 있습니다.

전체 클래스 또는 객체를 업데이트하려면 update 요청을 전송합니다. 클래스 또는 객체의 소수의 필드를 업데이트하려면 patch 요청을 보냅니다.
update 요청을 하면 전체 객체 또는 클래스가 업데이트됩니다. 즉, 요청에 포함되지 않은 필드는 모두 삭제됩니다. update 요청을 보내기 전에 GET 요청을 보내 최신 버전으로 작업하고 있으며 의도한 모든 필드가 요청에 포함되어 있는지 확인하는 것이 좋습니다.
patch 요청을 실행하면 패치가 적용된 필드만 업데이트됩니다. patch 요청을 보내기 전에 선택적으로 GET 요청을 전송하여 변경사항을 최신 버전과 비교하는 것이 좋습니다.
배열을 업데이트하기 위해 patch 요청을 실행하면 원래 배열은 요청 본문에 포함된 배열로 바뀝니다. 배열의 요소를 개별적으로 수정할 수는 없습니다.
경우에 따라 변경사항이 언제 발생하는지 또는 언제 업데이트를 트리거해야 할지 모를 수도 있습니다. 모든 클래스와 객체에 대해 update 또는 patch 요청을 주기적으로 예약하는 것이 좋습니다.

패스 클래스 업데이트

Google 월렛 비즈니스 콘솔 사용

패스 클래스 (객체 아님)는 Google Pay 및 월렛 콘솔에서 직접 수정할 수 있습니다.

콘솔로 이동
Google Wallet API를 선택합니다.
수정할 수업을 선택합니다.
수정을 선택합니다.
클래스 속성 업데이트
저장을 선택합니다.

변경사항을 저장하면 모든 대중교통 소유자의 클래스가 자동으로 업데이트됩니다.

Google Wallet API 사용

TransitClass를 업데이트하면 이 클래스를 사용하여 프로비저닝된 모든 사용자에게 영향을 미칩니다. 예를 들어 교통카드의 로고를 업데이트하려면 다음 엔드포인트 중 하나에서 Google Wallet API에 update 또는 patch 요청을 제출합니다. resourceId 값은 클래스 ID (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

자바에서 통합을 시작하려면 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();
}

2,399필리핀

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 값은 객체 ID(ISSUER_ID.OBJECT_SUFFIX)입니다.

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

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