알림 유형
메시지 추가 및 알림
배경
사용자가 패스를 추가한 후에는 사용자에게 패스와 관련된 메시지를 보내고 알림을 받도록 하는 것이 좋습니다. TEXT_AND_NOTIFY와 동일한 message_type와 함께 Add Message API 요청을 사용하면 다음 상황이 발생합니다.
- '메시지' 항목이 '패스백' (세부정보 템플릿이라고도 함)에 추가되고 패스가 저장된 사용자에게 푸시 알림이 전송됩니다.
- 사용자가 알림을 탭하면 패스 전면에 Google 월렛이 열리고 (카드 보기라고도 함) 화면 상단에 '메시지 보기' 버튼과 함께 설명선이 표시됩니다.
- 콜아웃을 클릭하면 패스의 뒤로 이동하게 되며 읽지 않은 새 메시지가 강조표시됩니다.
사용자에게 알림이 포함된 메시지를 보낼 때 고려할 사항
- 사용자가 메시지와 관련된 푸시 알림을 받으려면 패스에 알림을 사용 설정해야 합니다.
- 메시지에는 웹사이트 또는 앱의 URI가 포함될 수 있습니다. 하이퍼링크는 패스와 관련된 웹사이트 또는 앱이어야 합니다. 사용자를 패스와 관련되지 않은 링크로 연결하는 것은 서비스이용 정책에 위배됩니다.
- 24시간 이내에 푸시 알림을 트리거하는 메시지를 최대 3개 보낼 수 있습니다. 사용자에게 스팸을 전송하는 것으로 판단되면 Google에서 푸시 알림 전송 할당량을 제한할 수 있습니다.
- 사용자에게 잠금 화면에 표시되는 푸시 알림은 Google 월렛에서 제어합니다.
- UPDATE 또는 PATCH 메서드와 일반 클래스 또는 객체 엔드포인트를 사용하여 메시지 데이터를 편집하거나 삭제할 수 있습니다.
통합 단계
AddMessage API를 사용하여 추가된 새 발급기관 메시지에 대해 사용자에게 알리려면 새 텍스트가 포함된 Message에 TEXT_AND_NOTIFY 대신 TEXT_AND_NOTIFY가 포함되도록 AddMessageRequest를 업데이트해야 합니다.MessageType
패스 클래스에서 메시지를 추가하고 알림을 보내는 JSON 요청의 예
…
"id": ISSUER_ID.CLASS_ID",
"message":
{
"header":"My Class message header",
"body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
"id": "message_id",
"message_type": "TEXT_AND_NOTIFY"
},
…
패스 객체에 메시지를 추가하고 알림을 보내는 JSON 요청의 예
…
"id": OBJECT_ID",
"classId": "ISSUER_ID.CLASS_ID",
"message":
{
"header":"My Object message header",
"body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
"id": "message_id",
"message_type": "TEXT_AND_NOTIFY"
},
…
패스 클래스에 대해 메시지를 추가하고 알림을 보내는 응답 예
// The updated resource
…
{
"kind": "walletobjects#walletObjectMessage",
"header": "My Object message header",
"body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
"id": "message_id",
"messageType": "textAndNotify"
},
…
예외 처리
알림을 3회 이상 시도하면 QuotaExceededException 응답이 발생합니다. 패스에 대한 추가 업데이트는 통합 단계에 설명된 대로 'TEXT_AND_NOTIFY' 대신 'TEXT'를 사용하여 설정할 수 있습니다.