개요

Google Wallet Pass API는 파트너가 대중교통 티켓 활성화 활성화가 필요한 경우 '활성화' 버튼이 표시됩니다. 를 호출하면 됩니다. 엔드포인트에서 패스에 유효한 사용 정보 (바코드 또는 바코드)가 있는지 확인해야 합니다. 시각적 검사)가 있어야 하며, 이때 사용자 월렛의 패스가 업데이트됩니다. 사용 정보가 표시됩니다. 활성화 전에 기존에 사용하던 쿠폰은 정보가 표시되지 않습니다.

활성화 API

활성화 엔드포인트는activationOptions 대중교통 클래스. 파트너는 다음을 사용하여 작동하는 활성화 엔드포인트를 유지할 책임이 있습니다. 적절한 지연 시간을 줄일 수 있습니다

  activationOptions: {
    activationUrl: string
  }

필드	설명
activationUrl	string 활성화 요청을 위해 호출되는 파트너 엔드포인트의 URL입니다. URL은 HTTPS에서 호스팅되어야 하고 robots.txt는 다른 사람이 URL 경로에 액세스할 수 있도록 UserAgent:Google-Valuables

활성화 상태는 activationStatus 필드를 사용하여 객체에 저장됩니다. 유효한 상태는 NOT_ACTIVATED 및 ACTIVATED입니다. 활성화 엔드포인트가 ACTIVATED 상태로 객체를 업데이트하고 객체에 바코드 또는 시각적 검사 매개변수와 같은 유효한 사용 정보가 있습니다. 이 deviceContext 필드는 기기 고정에 사용할 수 있습니다.

  activationStatus: enum (ActivationStatus),
  deviceContext: {
    deviceToken: string
  },
  hasLinkedDevice: boolean

필드	설명
activationStatus	enum (ActivationStatus) 이 대중교통 객체의 활성화 상태입니다. 이 상태에서는 사용자가 조치를 취할 수 있도록 합니다. 예: 활성화 버튼은 NOT_ACTIVATED로 설정된 경우 티켓 세부정보 사용 가능한 값: NOT_ACTIVATED ACTIVATED
deviceContext	object (DeviceContext) 객체를 연결할 기기 컨텍스트입니다. 설정하면 사용 정보가 오직 해당 기기로만 반환됩니다.
hasLinkedDevice	boolean 이 객체가 현재 단일 기기에 연결되어 있는지 여부입니다.

DeviceContext

필드	설명
deviceToken	string 설정하면, 활성화 시에만 사용 정보가 해당 기기로 반환됩니다. 정의합니다. 사용자 기기를 추적하기 위한 안정적인 식별자로 사용할 수 없습니다. 그것은 동일 기기 또는 다른 여러 패스로 변경 가능 활성화되어야 합니다. 이를 설정할 때 호출자는 활성화되는 객체에 대한 hasLinkedDevice deviceToken는 활성화 매개변수 deviceContext 필드

기기 고정

기기 고정은 사용자가 한 기기에서 티켓을 활성화하고 티켓 사용 정보가 해당 기기에만 표시됩니다. 이것은 ONE_USER_ONE_DEVICE 중 multipleDevicesAndHoldersAllowedStatus, 티켓이 단일 기기에만 표시되도록 허용합니다. 상태를 사용하여 기기 고정 시 ONE_USER_ALL_DEVICES

활성화하기 전에 사용자는 모든 기기에서 티켓을 확인하고 버튼을 활성화할 수 있습니다. 있습니다. 활성화된 후 기기에 고정되면 고정된 기기에 사용 정보가 표시됩니다. 다른 기기에는 사용자가 티켓을 다른 기기로 이동할 수 있는 활성화 버튼이 표시됩니다. 있습니다. 티켓을 이동하는 것이 바람직하지 않지만 어떤 기기에서든 활성화가 가능한 경우 활성화 중에 티켓을 ONE_USER_ONE_DEVICE로 업데이트할 수 있습니다. 더 강력합니다

기기 고정을 구현하려면 deviceToken 필드로 객체를 업데이트해야 합니다. 이 매개변수는 활성화 매개변수 및 동일한 API 호출에서 hasLinkedDevice를 true로 설정합니다. 원하는 경우 티켓은 향후 API 호출에서 hasLinkedDevice를 false로 설정하여 기기에서 연결 해제되어야 합니다.

활성화 매개변수

활성화 엔드포인트에 대한 요청에는 다음 매개변수가 포함됩니다.

JSON 예:

  {
    classId: “123.classId”,
    objectIds: [ “123.objectId” ],
    expTimeMillis: 1669671940735,
    eventType: “activate”,
    nonce: “1c6fccce-6f66-11ed-a1eb-0242ac120002”,
    deviceContext: “6fba937a-6f6e-11ed-a1eb-0242ac120002”
  }

식별자	설명
classId	정규화된 클래스 ID입니다. 다음 형식을 사용합니다. <issuer_id.class_id>
objectIds	다음 형식을 사용하는 정규화된 객체 ID 배열입니다. <issuer_id.object_id>
expTimeMillis	EPOCH 이후의 만료 시간(밀리초)입니다. 만료 시간이 지나면 유효하지 않은 것으로 간주해야 합니다.
eventType	항상 "activate"입니다.
nonce	중복 전송을 추적하기 위한 nonce입니다.
deviceContext	사용자가 작업 중인 기기를 나타내며 Google에서 생성한 고유 ID입니다. 이 ID는 객체를 기기에 연결하는 업데이트를 실행할 때 사용해야 합니다. 이 ID는 향후 특정 기기에서 보내는 요청에 대해 일정하지 않을 수 있습니다.