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

패스 클래스 및 패스 객체 만들기

최종 사용자가 Google 월렛에 저장하기 위해 발급할 수 있는 대부분의 패스는 패스 클래스와 패스 객체라는 두 가지 구성요소로 정의됩니다. 사용자에게 패스를 발급할 때마다 Google Wallet API에 구성할 패스 유형과 패스에 표시할 세부정보(예: 기프트 카드 가격 또는 티켓 소지자 이름)를 알려주는 패스 클래스 및 패스 객체의 인스턴스가 모두 필요합니다.

Google Wallet API는 개발자가 인스턴스를 생성한 다음 GiftCardClass, GiftCardObject, GenericClass, GenericObject 등 사용자에게 발급되는 패스를 만드는 데 사용할 수 있는 사전 정의된 패스 클래스 및 패스 객체 집합을 제공합니다.

각 패스 클래스 및 패스 객체 인스턴스는 JSON 객체로 정의되며, 이 객체에는 패스 유형의 특정 사용 사례에 해당하는 필수 및 선택적 속성 집합이 있습니다.

패스 클래스 만들기

패스 클래스는 패스를 만드는 공유 템플릿이라고 생각할 수 있습니다. 패스 클래스는 이를 사용하는 모든 패스에 포함될 특정 속성을 정의합니다. 패스 발급기관은 여러 개의 클래스를 만들 수 있으며, 각 클래스는 스타일 및 모양과 같은 속성뿐 아니라 스마트 탭, 등록 및 로그인과 같은 추가 기능을 정의하는 고유한 속성 집합을 포함합니다.

패스 클래스는 Google Wallet REST API, Google Wallet Android SDK를 사용하여 만들거나 Google 월렛 비즈니스 콘솔에서 만들 수 있습니다.

비즈니스 콘솔은 간단한 사용자 인터페이스를 제공하므로 신규 사용자의 경우 패스 클래스 생성을 가장 쉽게 시작할 수 있습니다. 양식 필드를 작성하여 첫 번째 패스 클래스의 다양한 필드를 정의할 수 있습니다.

고급 사용자의 경우 프로그래매틱 방식으로 패스 클래스를 만드는 것이 가장 좋습니다.

Google 월렛 비즈니스 콘솔 사용

Google 월렛 비즈니스 콘솔에서 패스 클래스를 만들려면 다음 단계를 따르세요.

Google Pay 및 월렛 비즈니스 콘솔로 이동하여 Google Wallet API 발급기관 계정으로 로그인합니다.
'Google Wallet API' 카드에서 '패스 관리' 버튼을 클릭합니다.
'게시 액세스 권한 얻기'에서 '수업 만들기' 버튼을 클릭합니다.
대화상자에서 패스 유형을 선택합니다. Google 월렛에서는 다양한 패스 유형 (이벤트 티켓, 쿠폰, 포인트 카드 등)을 제공합니다. 유연한 사용 사례의 경우 패스 유형으로 '일반'을 선택하세요.
필수 입력란에 적절한 값을 입력합니다.
'수업 만들기' 버튼을 클릭하여 수업을 저장합니다.

Google Wallet REST API 사용

Google Wallet REST API를 사용하여 패스 클래스를 만들려면 https://walletobjects.googleapis.com/walletobjects/v1/offerClass에 POST 요청을 보냅니다. 자세한 내용은 참조 문서를 확인하세요.

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.offerclass().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/retail/offers/rest/v1/offerclass
  OfferClass newClass =
      new OfferClass()
          .setId(String.format("%s.%s", issuerId, classSuffix))
          .setIssuerName("Issuer name")
          .setReviewStatus("UNDER_REVIEW")
          .setProvider("Provider name")
          .setTitle("Offer title")
          .setRedemptionChannel("ONLINE");

  OfferClass response = service.offerclass().insert(newClass).execute();

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

  return response.getId();
}

2,399필리핀

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->offerclass->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/retail/offers/rest/v1/offerclass
  $newClass = new OfferClass([
    'id' => "{$issuerId}.{$classSuffix}",
    'issuerName' => 'Issuer name',
    'reviewStatus' => 'UNDER_REVIEW',
    'provider' => 'Provider name',
    'title' => 'Offer title',
    'redemptionChannel' => 'ONLINE'
  ]);

  $response = $this->service->offerclass->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.offerclass().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/retail/offers/rest/v1/offerclass
    new_class = {
        'id': f'{issuer_id}.{class_suffix}',
        'issuerName': 'Issuer name',
        'reviewStatus': 'UNDER_REVIEW',
        'provider': 'Provider name',
        'title': 'Offer title',
        'redemptionChannel': 'ONLINE'
    }

    response = self.client.offerclass().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.Offerclass
      .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/retail/offers/rest/v1/offerclass
  OfferClass newClass = new OfferClass
  {
    Id = $"{issuerId}.{classSuffix}",
    IssuerName = "Issuer name",
    ReviewStatus = "UNDER_REVIEW",
    Provider = "Provider name",
    Title = "Offer title",
    RedemptionChannel = "ONLINE"
  };

  responseStream = service.Offerclass
      .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.offerclass.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/retail/offers/rest/v1/offerclass
  let newClass = {
    'id': `${issuerId}.${classSuffix}`,
    'issuerName': 'Issuer name',
    'reviewStatus': 'UNDER_REVIEW',
    'provider': 'Provider name',
    'title': 'Offer title',
    'redemptionChannel': 'ONLINE'
  };

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

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

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

Go

Go에서 통합을 시작하려면 GitHub의 전체 코드 샘플( GitHub의 코드 샘플)을 참고하세요.

// Create a class.
func (d *demoOffer) createClass(issuerId, classSuffix string) {
	offerClass := new(walletobjects.OfferClass)
	offerClass.Id = fmt.Sprintf("%s.%s", issuerId, classSuffix)
	offerClass.RedemptionChannel = "ONLINE"
	offerClass.ReviewStatus = "UNDER_REVIEW"
	offerClass.Title = "Offer title"
	offerClass.IssuerName = "Issuer name"
	offerClass.Provider = "Provider name"
	res, err := d.service.Offerclass.Insert(offerClass).Do()
	if err != nil {
		log.Fatalf("Unable to insert class: %v", err)
	} else {
		fmt.Printf("Class insert id:\n%v\n", res.Id)
	}
}

패스 객체 만들기

패스 객체는 패스 클래스의 인스턴스입니다. 패스 객체를 만들려면 다음 속성을 제공해야 합니다.

classId: 패스 클래스의 id

id: 고객의 고유 ID

이러한 속성이 제품에 표시되는 방식에 관한 자세한 내용은 레이아웃 템플릿을 참고하세요.

패스 객체를 만드는 코드 샘플: