사용 사례

다음 패스 카테고리 중 하나를 선택하여 사용 방법을 자세히 알아보세요.


Google Pay API for Passes를 사용하면 기프트 카드를 통해 사용자와 소통하며 참여를 유도할 수 있습니다. 이 가이드에는 저장된 기프트 카드의 기능을 보다 잘 이해할 수 있도록 개념이 설명되어 있습니다.

다음 사용 사례는 기프트 카드 카테고리에만 해당합니다.

패스 업데이트

생성된 패스에 변경사항이 있는 경우 REST API를 사용하여 변경사항을 사용자에게 전달합니다. 이 변경사항이 클래스에만 영향을 줄 경우 Google Pay 판매자 센터를 사용할 수도 있습니다. 패스 업데이트는 사용자와 소통하는 중요한 방법입니다.

로고를 변경하는 등 패스가 표시되는 방식을 업데이트하려면 GiftCardClassupdate 또는 patch하거나 Google Pay 판매자 센터를 사용하면 됩니다. Google이 이 정보를 업데이트된 GiftCardClass와 연결된 모든 GiftCardObject에 전달합니다. 이는 GiftCardClass 수준에서 정의된 모든 필드에 적용됩니다.

기프트 카드 잔액을 변경하는 등 단일 패스를 업데이트하려면 단일 GiftCardObjectupdate 또는 patch하면 됩니다. 이는 GiftCardObject 수준에서 정의된 모든 필드에 적용됩니다.

때로는 변경사항이 언제 발생하는지, 아니면 update 또는 patch 요청을 언제 트리거해야 할지 모를 수도 있습니다. 이러한 경우에는 각 클래스 및 객체에 대한 update 또는 patch 요청을 주기적으로 예약합니다. GiftCardClasslist 메서드를 호출하면 특정 발급기관 계정의 모든 클래스를 찾을 수 있습니다. GiftCardObjectlist 메서드를 호출하면 특정 클래스의 모든 객체를 찾을 수 있습니다.

Google Pay 앱에서 스캔

사용자는 기프트 카드 세부정보를 스캔하거나 직접 추가할 때 자신의 Google Pay 앱에 모든 기프트 카드를 추가할 수 있습니다. Google Pay API for Passes는 이전에 정의된 GiftCardClass를 참조하지 않는 GiftCardObject를 생성합니다. 개발자가 별도의 작업을 수행하지 않아도 새 객체 또는 클래스가 생성됩니다. 하지만 Google Pay API for Passes가 만든 GiftCardObject는 업데이트할 수 없으며, 정적 패스와 같이 동작합니다.

지오펜싱 알림

Google은 정의된 위치에 소비자가 얼마나 가까이 있느냐에 따라 소비자의 저장된 객체와 관련된 알림을 트리거할 수 있습니다.

위치정보는 두 가지 방법으로 추가됩니다.

  1. Google Pay API for Passes 판매자 센터 계정이 생성될 때 Google 지도의 위치정보가 사용됩니다.
  2. REST API를 통해 객체나 클래스에 좌표가 추가될 수 있습니다.

객체 또는 클래스에 좌표를 추가하는 방법은 REST API를 사용하여 위치정보 추가를 참조하세요.

지오펜싱 개념

Google은 Google 지도의 위치정보를 사용하여 사용자가 실제로 특정 매장 또는 지역에 있는지를 알고리즘 방식으로 확인합니다. 이러한 탐지는 Google Pay API for Passes 판매자 센터 계정으로 개발된 모든 클래스와 객체에 적용됩니다.

알고리즘에는 GPS, Wi-Fi, 블루투스, 이동, 체류 시간 등의 요소가 고려됩니다. 사용자가 실제로 특정 위치에 있다고 판단되면 지오펜싱 알림이 트리거됩니다.

Object에 좌표를 수동으로 지정하면 사용자가 이 좌표에서 150미터 거리에 있을 때 지오펜싱 알림이 트리거됩니다.

지오펜싱 알림의 빈도, 조절, 사용자 선택 해제

사용자는 하루에 최대 4개의 알림을 받습니다.

지오펜스 내에 여러 개의 객체가 저장되었다면 캐러셀을 통해 수정 불가능한 알림이 Google Pay API for Passes 판매자 센터 계정별로 하나씩 표시됩니다. 객체는 캐러셀 내에서 돌아가며 표시됩니다.

지오펜싱 알림이 작동하려면 사용자가 Google Pay 앱의 알림 설정에서 상품 관련 업데이트를 사용 설정하고 기기에 위치 서비스를 켜 놓아야 합니다.

REST API를 사용하여 위치정보 추가

클래스나 객체에 위치의 배열(위도와 경도)을 지정할 수 있습니다. Google은 사용자의 현재 위치정보를 클래스나 객체에 연결된 위치 목록과 비교한 후 사용자가 해당 위치 중 한 곳에서 150미터 이내에 있을 경우 알림을 전송합니다. 다음은 클래스나 객체에 위치를 지정하는 방법을 보여주는 코드 샘플입니다.

리소스

{
  ... //Class or Object content

  "locations": [{
    "kind": "walletobjects#latLongPoint",
    "latitude": 37.422087,
    "longitude": -161446
  }, {
    "kind": "walletobjects#latLongPoint",
    "latitude": 37.429379,
    "longitude": -121.12272999999999
  }, {
    "kind": "walletobjects#latLongPoint",
    "latitude": 37.333646,
    "longitude": -122.884853
  }]
}

자바

List<LatLongPoint> locations = new ArrayList<LatLongPoint>();
locations.add(new LatLongPoint().setLatitude(37.422087).setLongitude(
    -122.161446));
locations.add(new LatLongPoint().setLatitude(37.429379).setLongitude(
    -121.12272999999999));
locations.add(new LatLongPoint().setLatitude(37.333646).setLongitude(
    -122.884853));

yourClassOrObject.setLocations(locations);

PHP

$locations = array(
  array(
    'kind' => 'walletobjects#latLongPoint',
    'latitude' => 37.442087,
    'longitude' => -122.161446
  ),
  array(
    'kind' => 'walletobjects#latLongPoint',
    'latitude' => 37.429379,
    'longitude' => -122.12272999999999
  ),
  array(
    'kind' => 'walletobjects#latLongPoint',
    'latitude' => 37.333646,
    'longitude' => -121.884853
  )
);

Python

offer_class_object = {
  # class or object content
  'locations': [{
    'kind': 'walletobjects#latLongPoint',
    'latitude': 37.442087,
    'longitude': -122.161446
    },{
    'kind': 'walletobjects#latLongPoint',
    'latitude': 37.429379,
    'longitude': -122.12272999999999
    },{
    'kind': 'walletobjects#latLongPoint',
    'latitude': 37.333646,
    'longitude': -121.884853
  }]
}

만료된 패스 처리

Google Pay 앱의 '패스' 탭에는 보관처리된 패스 또는 비활성 패스가 모두 포함된 '만료된 패스' 섹션이 있습니다. 다음 조건 중 하나 이상에 해당하는 패스는 '만료된 패스' 섹션으로 이동됩니다.

  • object.validTimeInterval.end.date가 만료됩니다. 이 패스는 object.validTimeInterval.end.date가 만료된 후 최대 24시간 이내에 '만료된 패스'로 이동합니다.
  • object.state 필드가 Expired, Inactive 또는 Completed로 표시되어 있습니다.

사용자가 저장한 패스가 있으면 패스에 링크를 걸기 위해 objectId를 참조합니다.

다음 링크를 사용하여 패스를 참조하세요.

https://pay.google.com/gp/v/object/{<issuerId>}.{<ObjectId>}

패스는 Google Pay 앱 또는 웹브라우저에서 확인할 수 있습니다.

저장된 Google Pay 패스의 헤더 아래에서 앱 또는 웹사이트에 연결할 수 있습니다. 이 기능은 모든 유형의 Google Pay 패스에서 사용할 수 있습니다.

액세스 요청

오프라인 판매자용 지원 양식을 사용하여 액세스를 요청하세요. 다음 사항에 유의하세요.

  • 양식에서 발급기관 ID를 공유해야 합니다.
  • Issue type(발급 유형)에서 'Technical/API Integration(기술/API 통합)'을 선택합니다.
  • Link your app or website below the Google Pay pass(Google Pay 패스 아래에 앱 또는 웹사이트 연결)를 선택합니다.

지정된 Google Pay 패스에 대해 appLinkData를 정의하여 앱 또는 웹사이트의 URI를 설정합니다. URI의 형식은 자유롭지만 동적 링크를 사용하는 것이 좋습니다.

appLinkData 필드의 형식 및 컨텍스트는 다음 소스 코드에서 볼 수 있습니다.

{
  "id": string,
  "classId": string,
  …
  …
  …
  "appLinkData": {
    "androidAppLinkInfo": {
      "appLogoImage": {
        "sourceUri": {
          "uri": string
        }
      },
        "title": {
          "defaultValue": {
            "language": string,
              "value": string
          }
        },
          "description": {
            "defaultValue": {
              "language": string,
                "value": string
            }
          },
            "appTarget": {
              "targetUri": {
                "uri": string,
                  "description": string
              }
            }
    }
  }
  …
  …
  …
}