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

자동 연결 패스

배경

자동 연결된 패스 기능을 사용하면 사용자에게 제공할 수 있습니다. 그 외에 사용자가 기본 패스로 사전 연결 패스 (기본) 패스. 자동 연결 패스는 사용자에게 새 패스가 생성되었음을 알리는 기본 패스 위의 콜아웃 이(가) 연결되었습니다. 기본 또는 연결된 패스로 지원되는 패스 유형은 다음과 같습니다.

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

를 통해 개인정보처리방침을 정의할 수 있습니다. <ph type="x-smartling-placeholder">


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

사용 사례

기존 패스에 패스를 연결하는 사용 사례는 다양합니다. 몇 가지 예를 들면 다음과 같습니다.

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

자동 연결 패스 사용 시 고려사항

기본 객체와 연결된 객체는 동일한 발급기관 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개에 도달했습니다. 있습니다