리소스: OfferObject
JSON 표현 |
---|
{ "kind": string, "classReference": { object ( |
필드 | |
---|---|
kind |
리소스 종류를 식별합니다. 값: 고정 문자열 |
class |
상위 클래스의 상속 필드 사본입니다. 이러한 필드는 GET 실행 중 검색됩니다. |
id |
필수 항목입니다. 객체의 고유 식별자입니다. 이 ID는 한 발급기관의 모든 객체에서 고유해야 합니다. 이 값은 issuer ID 형식을 따라야 합니다.identifier 형식을 따라야 합니다. 발급기관 ID는 Google에서 발급하며 식별자는 개발자가 직접 선택합니다. 고유 식별자에는 영숫자 문자, '.', '_', '-'만 포함되어야 합니다. |
class |
필수 항목입니다. 이 객체에 연결된 클래스입니다. 클래스는 이 객체와 유형이 동일해야 하며, 이미 존재하고 승인된 상태여야 합니다. 클래스 ID는 issuer ID 형식을 따라야 합니다.identifier 형식을 따라야 합니다. 발급기관 ID는 Google에서 발급하며 식별자는 개발자가 직접 선택합니다. |
version |
지원 중단됨 |
state |
필수 항목입니다. 객체 상태입니다. 이 필드는 객체가 앱에 표시되는 방식을 결정하는 데 사용됩니다. 예를 들어 |
barcode |
바코드 유형 및 값입니다. |
messages[] |
앱에 표시되는 메시지의 배열입니다. 이 객체의 모든 사용자는 이 배열의 관련 메시지를 수신합니다. 이러한 필드의 최대 개수는 10개입니다. |
valid |
이 객체가 |
locations[] |
참고: 이 필드는 현재 지역 알림을 트리거하는 데 지원되지 않습니다. |
has |
객체에 사용자가 있는지 여부를 나타냅니다. 이 필드는 플랫폼에서 설정합니다. |
smart |
이 객체의 NFC를 통해 스마트 탭 인증 단말기로 전송되는 값입니다. 패스에서 스마트 탭을 지원하려면 클래스 수준 필드 |
has |
이 객체가 현재 하나의 기기에 연결되어 있는지 여부입니다. 이 필드는 사용자가 객체를 저장하여 기기에 연결할 때 플랫폼에서 설정합니다. 일부 파트너만 사용할 수 있습니다. 자세한 내용은 지원팀에 문의하세요. |
disable |
알림을 명시적으로 해제해야 하는지 여부를 나타냅니다. 이 필드를 true로 설정하면 현재는 혜택에만 설정할 수 있습니다. |
info |
지원 중단되었습니다. 대신 textModulesData를 사용하세요. |
image |
이미지 모듈 데이터입니다. 이러한 표시된 필드의 최대 개수는 객체 수준에서 1개이고 클래스 객체 수준에서 1개입니다. |
text |
텍스트 모듈 데이터입니다. 텍스트 모듈 데이터가 클래스에도 정의되어 있으면 둘 다 표시됩니다. 이러한 표시된 필드의 최대 개수는 객체에서 10개이고 클래스에서 10개입니다. |
links |
링크 모듈 데이터입니다. 링크 모듈 데이터가 클래스에도 정의되어 있으면 둘 다 표시됩니다. |
app |
패스 앞면에 버튼으로 표시되는 앱 또는 웹사이트 링크(선택사항)입니다. 상응하는 클래스에 AppLinkData가 제공되면 AppLinkData 객체만 표시됩니다. |
rotating |
회전 바코드 유형 및 값입니다. |
hero |
카드 앞면에 표시되는 배너 이미지(선택사항)입니다. 없으면 클래스의 히어로 이미지(있는 경우)가 표시됩니다. 클래스의 히어로 이미지도 없는 경우 아무것도 표시되지 않습니다. |
grouping |
패스가 그룹화되는 방식을 제어하는 정보입니다. |
pass |
객체의 제약 조건을 전달합니다. NFC 및 스크린샷 동작 제한이 포함됩니다. |
save |
사용자가 패스 저장을 시도하기 전에 확인해야 하는 객체에 관한 제한사항입니다. 이 제한사항은 절약 모드 중에만 적용됩니다. 사용자가 패스를 저장한 후에 제한사항이 변경되면 이미 저장된 패스에는 새 제한사항이 적용되지 않습니다. |
linked |
linkedObjectIds는 이 혜택 객체에 자동으로 연결되어야 하는 이벤트 티켓, 포인트 제도, 혜택, 일반, 기프트 카드, 대중교통, 탑승권과 같은 다른 객체의 목록입니다. 사용자가 이 혜택을 저장한 경우 이러한 연결된 패스를 수신하도록 설정을 사용 중지하지 않는 한 이러한 linkedObjectIds가 사용자의 지갑에 자동으로 푸시됩니다. linkedObjectIds에 있는 객체가 이미 삽입되었는지 확인합니다. 그렇지 않으면 호출이 실패합니다. 연결된 객체는 연결을 해제할 수 없습니다. 다른 발급기관에 속한 객체는 연결할 수 없습니다. 단일 객체에 연결할 수 있는 객체 수에는 제한이 있습니다. 한도에 도달하면 호출의 새 연결된 객체가 자동으로 무시됩니다. 객체 ID는 issuer ID 형식을 따라야 합니다.identifier: Google에서 발급하며 후자는 개발자가 선택합니다. |
notify |
이 객체의 필드 업데이트 시 알림을 트리거할지 여부입니다. NOTIFY로 설정하면 사용자에게 필드 업데이트 알림을 트리거하려고 시도합니다. 이러한 알림은 필드가 허용 목록에 포함된 경우에만 사용자에게 전송됩니다. DO_NOT_NOTIFY 또는 NOTIFICATION_SETTINGS_UNSPECIFIED로 설정하면 알림이 트리거되지 않습니다. 이 설정은 일시적이며 PATCH 또는 UPDATE 요청마다 설정해야 합니다. 그렇지 않으면 알림이 트리거되지 않습니다. |
value |
부가가치 모듈 데이터(선택사항) 객체 최대 10개. |
메서드 |
|
---|---|
|
지정된 객체 ID로 참조되는 쿠폰 객체에 메시지를 추가합니다. |
|
지정된 객체 ID가 있는 쿠폰 객체를 반환합니다. |
|
지정된 ID와 속성이 있는 쿠폰 객체를 삽입합니다. |
|
지정된 발급기관 ID의 모든 쿠폰 객체 목록을 반환합니다. |
|
지정된 객체 ID로 참조되는 쿠폰 객체를 업데이트합니다. |
|
지정된 객체 ID로 참조되는 쿠폰 객체를 업데이트합니다. |