Subscriptions

Mirror API를 사용하면 사용자가 타임라인 항목에서 특정 작업을 하거나 사용자 위치가 업데이트된 경우 전송되는 알림을 구독할 수 있습니다.

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

컬렉션의 이벤트에 대한 구독입니다.

{
  "kind": "mirror#subscription",
  "id": string,
  "updated": datetime,
  "collection": string,
  "operation": [
    string
  ],
  "callbackUrl": string,
  "verifyToken": string,
  "userToken": string,
  "notification": {
    "collection": string,
    "itemId": string,
    "operation": string,
    "userActions": [
      {
        "type": string,
        "payload": string
      }
    ],
    "verifyToken": string,
    "userToken": string
  }
}
숙소 이름 설명 메모
callbackUrl string 알림을 전송해야 하는 URL입니다 (https://로 시작해야 함). 쓰기 가능
collection string 구독할 컬렉션입니다. 허용되는 값은 다음과 같습니다.
  • timeline - 삽입, 삭제, 업데이트 등 타임라인의 변경사항입니다.
  • locations - 위치 업데이트
  • settings - 설정 업데이트
쓰기 가능
id string 정기 결제의 ID입니다.
kind string 리소스 유형 항상 mirror#subscription입니다.
notification nested object 알림의 컨테이너 객체입니다. Subscription 리소스에는 채워지지 않습니다.
notification.collection string 알림을 생성한 컬렉션입니다.
notification.itemId string 알림을 생성한 항목의 ID입니다.
notification.operation string 알림을 생성한 작업의 유형입니다.

사용 가능한 값은 다음과 같습니다.
  • "DELETE"
  • "INSERT"
  • "MENU_ACTION"
  • "UPDATE"
notification.userActions[] list 알림을 트리거한 사용자의 작업 목록입니다.
notification.userActions[].payload string 작업의 선택적 페이로드입니다.

CUSTOM 유형의 작업에서 선택한 맞춤 메뉴 항목의 ID입니다.
notification.userActions[].type string 작업 유형입니다. 값은 다음과 같습니다.
  • SHARE - 사용자가 항목을 공유했습니다.
  • REPLY - 사용자가 항목에 답장함
  • REPLY_ALL - 사용자가 상품의 모든 수신자에게 답장했습니다.
  • CUSTOM: 사용자가 타임라인 항목에서 맞춤 메뉴 항목을 선택했습니다.
  • DELETE - 사용자가 항목을 삭제했습니다.
  • PIN - 사용자가 항목을 고정했습니다.
  • UNPIN - 사용자가 항목을 고정 해제했습니다.
  • LAUNCH: 사용자가 음성 명령을 시작했습니다.
앞으로 유형이 추가될 수 있습니다. 인식할 수 없는 유형의 UserActions를 무시해야 합니다.
notification.userToken string 알림을 구독한 서비스에서 제공하는 사용자 토큰입니다.
notification.verifyToken string 서비스에서 알림을 구독했을 때 제공하는 보안 비밀 인증 토큰입니다.
operation[] list 구독해야 하는 작업 목록입니다. 빈 목록은 컬렉션의 모든 작업을 구독해야 함을 나타냅니다. 허용되는 값은 다음과 같습니다.
  • UPDATE - 항목이 업데이트되었습니다.
  • INSERT - 새 항목이 삽입되었습니다.
  • DELETE - 항목이 삭제되었습니다.
쓰기 가능
updated datetime 이 구독이 마지막으로 수정된 시간으로, RFC 3339에 따라 형식이 지정됩니다.
userToken string 사용자의 ID를 파악할 수 있도록 알림에서 구독자에게 전달되는 불투명한 토큰입니다. 쓰기 가능
verifyToken string Google에서 알림을 생성했음을 확인할 수 있도록 알림에서 구독자에게 전송되는 비밀번호 토큰입니다. 쓰기 가능

방법

delete
정기 결제를 삭제합니다.
삽입
새 정기 결제를 만듭니다.
list
인증된 사용자 및 서비스의 구독 목록을 검색합니다.
업데이트
기존 구독을 업데이트합니다.