자동 연결 패스

배경

자동 연결된 패스 기능을 사용하면 Google 월렛에 기존 패스가 있는 사용자에게 추가 패스를 보낼 수 있습니다. 사용자가 기본(메인) 패스를 저장할 때 패스를 기본 패스에 사전 연결할 수도 있습니다. 자동 연결된 패스는 기본 패스와 그룹화되며, 기본 패스 위에 새로운 패스가 연결되었음을 알리는 콜아웃이 표시됩니다. 다음과 같은 패스 유형이 기본 또는 연결된 패스로 지원됩니다.

• 이벤트 티켓
• 탑승권
• 대중교통 이용권
• 혜택
• 기프트 카드
• 포인트 패스
• 일반 패스

새 패스가 추가되었다는 콜아웃이 있는 기본 패스	기본 패스에 연결된 새 패스

사용 사례

기존 티켓에 티켓을 연결하는 다양한 사용 사례가 있을 수 있습니다. 다음은 몇 가지 예입니다.

• 기존 포인트 카드에 쿠폰을 연결합니다.
• 식사 쿠폰을 탑승권 또는 이벤트 티켓에 연결합니다.
• 주차권을 이벤트 티켓에 연결합니다.

자동 연결된 티켓 사용 시 고려사항

• 기본 객체와 연결된 객체는 동일한 issuerId를 사용해야 합니다.
• 기본 객체당 연결된 객체는 50개로 제한됩니다.
• 연결된 패스가 자동으로 푸시되는 것은 보장되지 않으며 최선의 노력으로 간주됩니다. 사용자는 자동 연결된 패스 수신을 선택 해제할 수 있습니다. 사용 사례가 중요하고 사용자가 연결된 패스를 받아야 하는 경우 사용자가 패스를 추가하도록 다른 채널을 통해 소통하는 것이 좋습니다.
• Google 월렛 AUP 업데이트에는 자동 연결된 패스 사용에 관한 안내가 포함되어 있으며 이를 준수해야 합니다.

통합 단계

기본 객체를 이미 만든 경우 1단계를 건너뛸 수 있습니다.

1. 필수 매개변수를 사용하여 나열된 모든 패스 유형의 객체를 만듭니다. 기본 객체입니다.
2. 나열된 패스 유형의 다른 객체를 만듭니다. 이것이 연결된 객체가 됩니다.
3. 기본 객체를 저장하기 전이나 후에 linkedObjectIds 매개변수의 연결된 객체 ID로 기본 객체를 업데이트합니다.

기본 패스에 linkedObjectIds를 설정하는 데 필요한 최소 페이로드가 있습니다. 필수 매개변수 3개는 다음과 같습니다.

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

연결된 객체를 패스 객체에 추가하는 JSON 요청의 예

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

객체를 패스 객체에 연결한 후의 JSON 응답 예시

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

예상 동작

성공적인 응답을 수신한 후 업데이트한 패스가 있는 기기는 연결된 패스를 수신해야 합니다. 연결된 패스는 기본 패스와 함께 그룹화됩니다. 사용자는 오른쪽으로 스와이프하여 연결된 패스를 볼 수 있습니다.

예외 처리

API를 잘못 사용하면 다음과 같은 오류가 발생할 수 있습니다.