리소스: GenericObject
일반 객체
JSON 표현 |
---|
{ "genericType": enum ( |
필드 | |
---|---|
generic |
카드가 속한 |
card |
필수 항목입니다. 패스의 헤더입니다. 일반적으로 'XXX 헬스장', 'AAA 보험'과 같은 비즈니스 이름입니다. 이 필드는 필수이며 패스의 맨 위에 있는 헤더 행에 표시됩니다. |
subheader |
이 패스를 사용할 수 있는 위치와 같은 패스의 제목 라벨입니다. 패스 세부정보 뷰의 제목 행에 있는 제목 바로 위에 표시됩니다. |
header |
필수 항목입니다. 패스의 제목입니다(예: '50% 할인 쿠폰', '도서관 카드', '상품권'). 이 필드는 필수이며 패스 세부정보 뷰의 제목 행에 표시됩니다. |
logo |
패스의 로고 이미지입니다. 이 이미지는 왼쪽 상단의 카드 세부정보 뷰와 목록/썸네일 뷰에 표시됩니다. 로고가 없으면 |
hex |
카드의 배경 색상입니다. 설정되지 않은 경우 히어로 이미지의 주요 색상이 사용되고, 설정된 히어로 이미지가 없는 경우 로고의 주요 색상이 사용되며, 로고가 설정되지 않은 경우 Google에서 색상을 선택합니다. |
notifications |
이 객체에 사용 설정된 알림 설정입니다. |
id |
필수 항목입니다. 객체의 고유 식별자입니다. 이 ID는 한 발급기관의 모든 객체에서 고유해야 합니다. 이 값은 |
class |
필수 항목입니다. 이 객체에 연결된 클래스입니다. 클래스는 이 객체와 유형이 동일해야 하며, 이미 존재하고 승인된 상태여야 합니다. 클래스 ID는 |
barcode |
바코드 유형 및 값입니다. 패스에 바코드가 없는 경우 발급기관이 Barcode.alt_text를 설정하고 해당 항목만 표시하도록 허용할 수 있습니다. |
hero |
카드 앞면에 표시되는 배너 이미지(있는 경우)입니다. 이미지는 100% 너비로 표시됩니다. |
valid |
이 객체가 유효하거나 사용 가능한 것으로 간주되는 기간입니다. 기간이 지나면 객체가 만료된 것으로 간주되어 사용자 기기의 렌더링에 영향을 미칩니다. |
image |
이미지 모듈 데이터입니다. 두 이미지를 모두 설정하면 클래스의 이미지 하나와 객체 수준의 이미지 중 하나만 렌더링됩니다. |
text |
텍스트 모듈 데이터 |
links |
링크 모듈 데이터입니다. 클래스에 |
app |
패스 앞면에 버튼으로 표시되는 앱 또는 웹사이트 링크(선택사항)입니다. 상응하는 클래스에 AppLinkData가 제공되면 AppLinkData 객체만 표시됩니다. |
grouping |
패스가 그룹화되는 방식을 제어하는 정보입니다. |
smart |
이 객체의 NFC를 통해 스마트 탭 인증 단말기로 전송되는 값입니다. 패스가 스마트 탭을 지원하려면 클래스 수준 필드 |
rotating |
회전 바코드 설정/세부정보 |
state |
객체 상태입니다. 이 필드는 객체가 앱에 표시되는 방식을 결정하는 데 사용됩니다. 예를 들어 |
has |
객체에 사용자가 있는지 여부를 나타냅니다. 이 필드는 플랫폼에서 설정합니다. |
messages[] |
앱에 표시되는 메시지의 배열입니다. 이 객체의 모든 사용자는 이 배열의 관련 메시지를 수신합니다. 이 필드의 최대 개수는 10개입니다. |
pass |
객체의 제약 조건을 전달합니다. NFC 및 스크린샷 동작 제한을 포함합니다. |
wide |
패스의 넓은 로고입니다. 이 속성이 제공되는 경우 카드 보기의 왼쪽 상단에 있는 로고 대신 사용됩니다. |
save |
사용자가 패스를 저장하려고 시도하기 전에 확인해야 하는 객체에 대한 제한사항입니다. 이 제한은 절약 시간 중에만 적용됩니다. 사용자가 패스를 저장한 후 제한사항이 변경되면 이미 저장된 패스에는 새 제한사항이 적용되지 않습니다. |
value |
부가가치 모듈 데이터(선택사항) 객체에 최대 10개까지 포함할 수 있습니다. |
linked |
linkedObjectIds는 이 일반 객체에 자동으로 연결되어야 하는 이벤트 티켓, 포인트 제도, 혜택, 일반, 기프트 카드, 대중교통, 탑승권과 같은 다른 객체의 목록입니다. 사용자가 이 일반 카드를 저장한 경우 이러한 연결된 패스를 수신하도록 설정을 사용 중지하지 않는 한 이러한 linkedObjectIds가 사용자의 월렛에 자동으로 푸시됩니다. linkedObjectIds에 있는 객체가 이미 삽입되었는지 확인합니다. 그렇지 않으면 호출이 실패합니다. 연결된 객체는 연결을 해제할 수 없습니다. 다른 발급기관에 속한 객체는 연결할 수 없습니다. 단일 객체에 연결할 수 있는 객체 수에는 제한이 있습니다. 한도에 도달하면 호출의 새 연결된 객체가 자동으로 무시됩니다. 객체 ID는 issuer ID 형식을 따라야 합니다.identifier 형식을 따라야 합니다. 발급기관 ID는 Google에서 발급하며 식별자는 개발자가 직접 선택합니다. |
GenericType
일반 카드의 유형입니다.
열거형 | |
---|---|
GENERIC_TYPE_UNSPECIFIED |
지정되지 않은 제네릭 유형입니다. |
GENERIC_SEASON_PASS |
시즌권 |
GENERIC_UTILITY_BILLS |
공공요금 청구서 |
GENERIC_PARKING_PASS |
주차권 |
GENERIC_VOUCHER |
쿠폰 |
GENERIC_GYM_MEMBERSHIP |
헬스장 회원 카드 |
GENERIC_LIBRARY_MEMBERSHIP |
도서관 회원 카드 |
GENERIC_RESERVATIONS |
예약 |
GENERIC_AUTO_INSURANCE |
자동차 보험 카드 |
GENERIC_HOME_INSURANCE |
주택 보험 카드 |
GENERIC_ENTRY_TICKET |
입장권 |
GENERIC_RECEIPT |
영수증 |
GENERIC_LOYALTY_CARD |
포인트 카드 이 일반 유형 대신 전용 포인트 카드 패스 유형을 사용하는 것이 좋습니다. 전용 포인트 카드 패스 유형은 일반 패스 유형보다 더 많은 기능을 제공합니다. |
GENERIC_OTHER |
기타 유형 |
알림
객체에 알림을 사용 설정해야 하는지 여부를 나타냅니다. ExpiryNotification/UpcomingNotification 중 하나만 지원됩니다. expiryNotification
가 upcomingNotification
보다 우선 적용됩니다. 즉, expiryNotification
이 설정되면 upcomingNotification
필드는 무시됩니다.
JSON 표현 |
---|
{ "expiryNotification": { object ( |
필드 | |
---|---|
expiry |
카드가 만료되기 전에 특정 시간에 알림이 트리거됩니다. |
upcoming |
카드를 사용할 수 있게 되기 전에 특정 시간에 알림이 트리거됩니다. |
ExpiryNotification
카드 만료일 2일 전에 발급기관에서 Google 월렛이 만료 알림을 전송하도록 할 것임을 나타냅니다.
JSON 표현 |
---|
{ "enableNotification": boolean } |
필드 | |
---|---|
enable |
객체에 만료 알림을 사용 설정해야 하는지 여부를 나타냅니다. |
UpcomingNotification
카드가 유효하거나 사용 가능해지기 1일 전에 발급기관에서 Google 월렛에서 카드 유효 기간 알림을 전송하도록 할 것임을 나타냅니다.
JSON 표현 |
---|
{ "enableNotification": boolean } |
필드 | |
---|---|
enable |
객체에 예정된 알림을 사용 설정해야 하는지 여부를 나타냅니다. |
메서드 |
|
---|---|
|
지정된 객체 ID로 참조되는 일반 객체에 메시지를 추가합니다. |
|
지정된 객체 ID가 있는 일반 객체를 반환합니다. |
|
지정된 ID와 속성이 있는 일반 객체를 삽입합니다. |
|
지정된 발급기관 ID의 모든 일반 객체 목록을 반환합니다. |
|
지정된 객체 ID로 참조되는 일반 객체를 업데이트합니다. |
|
지정된 객체 ID로 참조되는 일반 객체를 업데이트합니다. |