배경
자동 연결된 패스 기능을 사용하면 사용자에게 제공할 수 있습니다. 그 외에 사용자가 기본 패스로 사전 연결 패스 (기본) 패스. 자동 연결 패스는 사용자에게 새 패스가 생성되었음을 알리는 기본 패스 위의 콜아웃 이(가) 연결되었습니다. 기본 또는 연결된 패스로 지원되는 패스 유형은 다음과 같습니다.
- 이벤트 티켓
- 탑승권
- 교통카드
- 혜택
- 기프트 카드
- 포인트 패스
- 일반 패스
새 패스가 추가되었다는 콜아웃이 있는 기본 패스 | 기본 패스에 연결된 새 패스 |
사용 사례
기존 패스에 패스를 연결하는 사용 사례는 다양합니다. 몇 가지 예를 들면 다음과 같습니다.
- 기존 포인트 카드에 쿠폰을 연결합니다.
- 식사 쿠폰을 탑승권 또는 이벤트 티켓에 연결합니다.
- 이벤트 티켓에 주차 패스를 연결합니다.
자동 연결 패스 사용 시 고려사항
- 기본 객체와 연결된 객체는 동일한 발급기관 ID를 사용해야 합니다.
- 연결된 객체는 기본 객체당 50개로 제한됩니다.
- 연결된 패스를 자동으로 푸시하는 것은 보장되지 않으며 이를 고려합니다. 최선의 노력이 필요합니다. 사용자는 자동 연결된 패스 수신을 선택 해제할 수 있습니다. 사용 사례가 사용자가 연결된 패스를 수신해야 하는 경우 다른 채널을 통해 통신하여 사용자가 패스를 추가하도록 합니다.
- Google 월렛 AUP 업데이트 준수해야 하는 자동 연결 패스 사용에 대한 안내가 포함되어 있습니다.
통합 단계
이미 기본 객체를 만든 경우에는 1단계를 건너뛸 수 있습니다.
- 나열된 모든 패스 유형의 객체 만들기 필수 매개변수를 사용해야 합니다. 이것이 기본 객체입니다.
- 나열된 패스 유형의 다른 객체를 만듭니다. 이것은 연결된 객체
- 기본 객체가 저장되기 전이나 후에 update(업데이트) linkedObjectIds에 연결된 객체의 ID가 있는 기본 객체 매개변수 값으로 사용됩니다.
기본 인스턴스에linkedObjectIds를 설정하려면 최소 페이로드가 필요합니다. 있습니다 3가지 필수 매개변수는 다음과 같습니다.
- ISSUERID.PRIMARY_OBJECT_ID
- ISSUERID.PRIMARY_CLASS_ID
- 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를 잘못 사용하면 발생할 수 있으며 이로 인해 포함:
메시지 | 이유 |
---|---|
기본 객체와 연결된 객체가 동일한 발급기관을 공유하지 않습니다. 있습니다. | 연결된 객체는 다른 발급기관의 객체에 연결할 수 없습니다. |
기본 객체와 연결된 객체는 동일한 객체를 참조합니다. | linkedObject와 동일한 객체를 연결할 수 없습니다. |
연결된 객체가 없습니다. | 연결된 객체가 이미 월렛에 삽입되어 있습니다. API에 액세스할 수 있습니다. |
연결된 객체에 이미 연결된 다른 객체가 있습니다. 중첩된 항목을 추가할 수 없습니다. 연결된 객체입니다. | 연결된 객체에는 연결된 다른 객체가 있을 수 없습니다. |
객체가 이미 다른 객체에 연결되어 있습니다. 중첩된 링크를 추가할 수 없습니다. 객체입니다. | 기본 객체 자체가 연결된 객체일 수 없습니다. |
한도를 초과하여 연결된 객체를 더 이상 추가할 수 없습니다. | 기본 인스턴스의 연결 패스 한도인 50개에 도달했습니다. 있습니다 |