푸시 알림 트리거

알림 유형

메시지 추가 및 알림

배경

사용자가 패스를 추가한 후 통과하고 이에 대한 알림을 받도록 합니다. Add Message API 사용 message_type가 다음과 같은 요청 TEXT_AND_NOTIFY 다음 상황이 발생합니다.

  1. 'Message' 항목이 '패스 뒷면'에 추가됨 (다른 명칭: 세부정보 템플릿)에서 패스가 저장된 사용자에게 푸시 알림이 전송됩니다.
  2. 사용자가 알림을 탭하면 Google 월렛이 패스 (카드 뷰라고도 함)의 상단에 콜아웃이 표시되며 '메시지 보기'가 있는 화면 버튼을 클릭합니다.
  3. 콜아웃을 클릭하면 패스 뒷면으로 이동하며, 읽지 않은 메시지가 강조표시됩니다.

사용자에게 알림이 포함된 메시지를 보낼 때 고려할 사항

  • 패스를 수신하려면 사용자가 알림을 사용 설정해야 합니다. 메시지와 관련된 푸시 알림
  • 메시지에는 웹사이트 또는 앱의 URI가 포함될 수 있습니다. 하이퍼링크는 패스와 관련된 웹사이트 또는 앱입니다. 이는 서비스이용 정책 패스와 관련 없는 링크로 사용자를 안내합니다.
  • 한 공간에 푸시 알림을 트리거하는 메시지를 최대 3개까지 보낼 수 있습니다. 24시간. 푸시 알림 전달 할당량이 사용자에게 스팸을 발송하는 것으로 판단될 수 있습니다.
  • 잠금 화면에 표시되는 푸시 알림은 Google에서 제어합니다. 월렛
  • UPDATE 또는 패치 일반 클래스 또는 객체를 사용하여 메시지 데이터를 수정하거나 삭제하는 메서드 할 수 있습니다

통합 단계

AddMessage API를 호출하려면 AddMessageRequest를 업데이트해야 합니다. 그러면 Message가 여기에는 새 텍스트가 포함되어 있으며 MessageType이 TEXT 대신 TEXT_AND_NOTIFY를 사용합니다.

패스 클래스에서 메시지를 추가하고 알리는 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'를 사용하여 패스를 설정할 수 있습니다. 를 'TEXT_AND_NOTIFY' '통합' 섹션에 설명된 대로 단계.