이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Timeline

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

리소스 표현

사용자 타임라인의 각 항목은 아래에 설명된 TimelineItem JSON 구조로 표시됩니다.

{
  "kind": "mirror#timelineItem",
  "id": string,
  "sourceItemId": string,
  "canonicalUrl": string,
  "bundleId": string,
  "isBundleCover": boolean,
  "selfLink": string,
  "created": datetime,
  "updated": datetime,
  "displayTime": datetime,
  "isPinned": boolean,
  "pinScore": integer,
  "isDeleted": boolean,
  "etag": etag,
  "creator": contacts Resource,
  "recipients": [
    contacts Resource
  ],
  "inReplyTo": string,
  "title": string,
  "text": string,
  "html": string,
  "speakableType": string,
  "speakableText": string,
  "attachments": [
    timeline.attachments Resource
  ],
  "location": locations Resource,
  "menuItems": [
    {
      "id": string,
      "action": string,
      "values": [
        {
          "state": string,
          "displayName": string,
          "iconUrl": string
        }
      ],
      "removeWhenSelected": boolean,
      "payload": string
    }
  ],
  "notification": {
    "level": string,
    "deliveryTime": datetime
  }
}

숙소 이름	값	설명	메모
`attachments[]`	`list`	이 항목과 연결된 미디어 첨부파일의 목록입니다. 편의상 첨부파일 또는 CID 스키마를 사용하여 HTML 페이로드의 첨부파일을 참조할 수 있습니다. 예를 들면 다음과 같습니다. 첨부파일: `<img src="attachment:attachment_index">`. 여기서 attach_index는 이 배열의 0 기반 색인입니다. CID: `<img src="cid:attachment_id">`, 여기서 attachments_id는 첨부파일의 ID입니다.
`bundleId`	`string`	이 항목의 번들 ID입니다. 서비스는 번들 ID를 지정하여 여러 항목을 그룹화할 수 있습니다. 기기의 단일 최상위 항목 아래에 표시됩니다.	쓰기 가능
`canonicalUrl`	`string`	타임라인 항목에 표시되는 데이터의 표준/고품질 버전을 가리키는 표준 URL입니다.	쓰기 가능
`created`	`datetime`	항목이 생성된 시간으로 RFC 3339에 따라 형식이 지정됩니다.
`creator`	`nested object`	이 항목을 만든 사용자 또는 그룹입니다.	쓰기 가능
`displayTime`	`datetime`	RFC 3339에 따라 형식이 지정된 타임라인에서 이 항목을 볼 때 표시되어야 하는 시간입니다. 이 사용자의 타임라인은 표시 시간에 따라 시간순으로 정렬되므로 항목이 타임라인에 표시되는 위치도 결정됩니다. 서비스에서 설정하지 않으면 표시 시간은 기본적으로 `updated` 시간으로 설정됩니다.	쓰기 가능
`etag`	`etag`	이 항목의 ETag입니다.
`html`	`string`	이 항목의 HTML 콘텐츠입니다. 항목에 `text`와 `html`가 모두 제공되면 `html`는 타임라인에서 렌더링됩니다. 허용된 HTML 요소 - 타임라인 카드에서 이러한 요소를 사용할 수 있습니다. 헤더: `h1, h2, h3, h4, h5, h6` 이미지: `img` 목록: `li, ol, ul` HTML5 의미 체계: `article, aside, details, figure, figcaption, footer, header, nav, section, summary, time` 구조: `blockquote, br, div, hr, p, span` 스타일: `b, big, center, em, i, u, s, small, strike, strong, style, sub, sup` 테이블: `table, tbody, td, tfoot, th, thead, tr` 차단된 HTML 요소: 이러한 요소와 콘텐츠는 HTML 페이로드에서 삭제됩니다. 문서 헤더: `head, title` 삽입: `audio, embed, object, source, video` 프레임: `frame, frameset` 스크립트: `applet, script` 기타 요소: 나열되지 않은 모든 요소는 삭제되지만 콘텐츠는 유지됩니다.	쓰기 가능
`id`	`string`	타임라인 항목의 ID입니다. 사용자의 타임라인 내에서 고유합니다.
`inReplyTo`	`string`	이 항목이 다른 항목에 대한 답장으로 생성된 경우 이 필드는 응답 대상인 항목의 ID로 설정됩니다. 적절한 대화 또는 게시물에 답글을 첨부하는 데 사용할 수 있습니다.
`isBundleCover`	`boolean`	이 항목이 번들 표지인지를 나타냅니다. 번들 표지로 표시된 상품은 `bundleId`과 동일한 번들에 대한 진입점이 됩니다. 열린 번들이 아닌 기본 타임라인에만 표시됩니다. 기본 타임라인에 표시되는 항목은 다음과 같습니다. `isBundleCover`이(가) `true`(으)로 설정된 항목 `bundleId`이(가) 없는 항목 번들 하위 타임라인에는 다음과 같은 항목이 표시됩니다. 문제의 `bundleId`가 있고 `isBundleCover`이(가) `false`(으)로 설정된 상품	쓰기 가능
`isDeleted`	`boolean`	true인 경우 이 항목이 삭제되고 ID 속성만 설정되었음을 나타냅니다.
`isPinned`	`boolean`	true인 경우 이 항목이 고정되었음을 나타냅니다. 즉, 홈 화면의 반대쪽에 있는 이전 (고정되지 않은) 타임라인 항목의 '활성' 항목과 함께 항목이 그룹화되어 표시됩니다. 사용자가 `TOGGLE_PINNED` 기본 제공 메뉴 항목을 사용하여 이 속성의 값을 전환하도록 허용할 수 있습니다.
`kind`	`string`	리소스 유형 항상 `mirror#timelineItem`입니다.
`location`	`nested object`	이 항목과 연결된 지리적 위치입니다.	쓰기 가능
`menuItems[]`	`list`	타임라인에서 이 항목이 선택될 때 사용자에게 표시되는 메뉴 항목 목록입니다.	쓰기 가능
`menuItems[].action`	`string`	사용자가 메뉴 옵션을 선택할 때 동작을 제어합니다. 허용되는 값은 다음과 같습니다. `CUSTOM` - 서비스에서 설정한 맞춤 작업입니다. 사용자가 이 `menuItem`를 선택하면 API는 `userActions.type`를 `CUSTOM`로 설정하고 `userActions.payload`를 이 메뉴 항목의 `ID`로 설정하여 `callbackUrl`에 알림을 트리거합니다. 기본값입니다. 기본 제공 작업: `REPLY` - 음성 녹음 UI를 사용하여 타임라인 항목에 답장을 시작합니다. 이 메뉴를 사용하려면 타임라인 항목에 `creator` 속성을 설정해야 합니다. `REPLY_ALL` - `REPLY`와 동일한 동작 원래 타임라인 항목의 `recipients`가 답장 항목에 추가됩니다. `DELETE` - 타임라인 항목을 삭제합니다. `SHARE` - 타임라인 항목을 사용 가능한 연락처와 공유합니다. `READ_ALOUD` - 타임라인 항목의 `speakableText`을 소리내어 읽습니다. 이 필드가 설정되지 않은 경우 `text` 필드를 읽습니다. 설정된 필드가 없으면 이 메뉴 항목은 무시됩니다. `GET_MEDIA_INPUT` - 사용자가 메뉴 항목에서 Glassware에 미디어 페이로드를 제공할 수 있도록 허용합니다 (현재 음성 입력의 스크립트 작성 텍스트만 지원됨). 사용자가 이 메뉴 항목을 호출하여 타임라인 항목 ID를 수신하면 알림을 수신합니다. payload 속성의 타임라인 항목에서 미디어를 검색합니다. `VOICE_CALL`: 타임라인 항목의 `creator.phoneNumber` 속성을 수신자로 사용하여 전화 통화를 시작합니다. `NAVIGATE` - 타임라인 항목의 `location`로 이동합니다. `TOGGLE_PINNED` - 타임라인 항목의 `isPinned` 상태를 전환합니다. `OPEN_URI` - 브라우저에서 메뉴 항목의 `payload`를 엽니다. `PLAY_VIDEO`: Glass 동영상 플레이어에서 메뉴 항목의 `payload`를 엽니다. `SEND_MESSAGE`: 타임라인 항목의 `creator`에 메시지를 보냅니다. `creator.phoneNumber`가 설정되어 있고 Glass가 Android 휴대전화에 연결되어 있다면 메시지가 SMS입니다. 그렇지 않고 `creator.email`가 설정된 경우 메시지는 이메일입니다.	쓰기 가능
`menuItems[].id`	`string`	이 메뉴 항목의 ID입니다. 애플리케이션에서 생성되고 불투명 토큰으로 처리됩니다.	쓰기 가능
`menuItems[].payload`	`string`	이 MenuItem의 작업에 따라 의미가 변경되는 일반 페이로드 작업이 `OPEN_URI`인 경우 페이로드는 확인할 웹사이트의 URL입니다. 작업이 `PLAY_VIDEO`인 경우 페이로드는 동영상의 스트리밍 URL입니다. 작업이 `GET_MEDIA_INPUT`인 경우 페이로드는 사용자의 음성 입력을 텍스트로 변환하는 것입니다.	쓰기 가능
`menuItems[].removeWhenSelected`	`boolean`	`CUSTOM` 메뉴 항목에 true로 설정하면 항목이 선택된 후 메뉴에서 삭제됩니다.	쓰기 가능
`menuItems[].values[]`	`list`	`CUSTOM` 항목의 경우 각 상태에서 메뉴 항목의 모양을 제어하는 값 목록입니다. `DEFAULT` 상태 값을 제공해야 합니다. `PENDING` 또는 `CONFIRMED` 상태가 누락되면 표시되지 않습니다.	쓰기 가능
`menuItems[].values[].displayName`	`string`	메뉴 항목에 표시할 이름입니다. 내장 메뉴 항목에 이 속성을 지정하면 해당 메뉴 항목의 기본 문맥 음성 명령이 표시되지 않습니다.	쓰기 가능
`menuItems[].values[].iconUrl`	`string`	메뉴 항목과 함께 표시할 아이콘의 URL입니다.	쓰기 가능
`menuItems[].values[].state`	`string`	이 값이 적용되는 상태입니다. 허용되는 값은 다음과 같습니다. `DEFAULT`: `menuItems` 목록에 표시될 때 표시되는 기본값입니다. `PENDING` - 사용자가 `menuItem`를 선택했지만 계속 취소할 수 있는 경우 표시되는 값입니다. `CONFIRMED`: 사용자가 menuItem을 선택했으며 더 이상 취소할 수 없는 경우 표시되는 값입니다.	쓰기 가능
`notification`	`nested object`	이 항목의 알림이 기기에 표시되는 방식을 제어합니다. 이 속성이 없으면 알림이 생성되지 않습니다.	쓰기 가능
`notification.deliveryTime`	`datetime`	알림이 전달되어야 하는 시간입니다.	쓰기 가능
`notification.level`	`string`	알림이 얼마나 중요한지 설명합니다. 허용되는 값은 다음과 같습니다. `DEFAULT` - 기본 중요도 알림 사용자에게 알리기 위해 차임벨이 울립니다.	쓰기 가능
`pinScore`	`integer`	고정된 항목의 경우 항목이 타임라인에 표시되는 순서가 결정되고 점수가 높을수록 시계 근처에 나타납니다. 참고: 이 필드는 현재 지원되지 않습니다.
`recipients[]`	`list`	이 항목이 공유된 사용자 또는 그룹 목록입니다.	쓰기 가능
`selfLink`	`string`	이 항목을 검색하는 데 사용할 수 있는 URL입니다.
`sourceItemId`	`string`	타임라인 항목을 자체 서비스의 데이터에 매핑하는 데 사용할 수 있는 불투명 문자열입니다.	쓰기 가능
`speakableText`	`string`	이 항목의 콘텐츠를 읽을 수 있는 버전입니다. `READ_ALOUD` 메뉴 항목과 함께 이 필드를 사용하여 텍스트를 소리내어 읽을 때 더 선명한 텍스트를 제공하거나 Glass에 시각적으로 표시되는 내용에 관한 확장된 정보를 제공합니다. Glassware는 또한 추가 컨텍스트가 유용한 경우(예: 사용자가 알림을 따라 항목을 소리내어 읽도록 요청하는 경우) 이 텍스트 전에 음성으로 안내할 말하기 가능한 유형 필드를 지정해야 합니다.	쓰기 가능
`speakableType`	`string`	항목 유형에 대한 음성 안내입니다. 이는 추가 문맥이 유용한 경우(예: 사용자가 알림 후 항목을 소리내어 읽도록 요청하는 경우) 항목의 콘텐츠를 읽기 전에 사용자에게 안내됩니다. '이메일', '문자 메시지' 또는 '일일 플래닛 뉴스 업데이트'와 같은 짧고 간단한 명사구여야 합니다. 사용자가 페이지를 보지 않고도 항목 유형을 학습할 수 있도록, 말합니다. 항목에 SpeakeasyableText 또는 텍스트가 포함되어 있지 않더라도 Glass 소프트웨어는 이 필드를 모든 타임라인 항목에 채우는 것이 좋습니다.	쓰기 가능
`text`	`string`	이 항목의 텍스트 콘텐츠입니다.	쓰기 가능
`title`	`string`	이 항목의 제목입니다.	쓰기 가능
`updated`	`datetime`	항목이 마지막으로 수정된 시간으로 RFC 3339에 따라 형식이 지정됩니다.

방법

delete: 타임라인 항목을 삭제합니다.
가져오기: ID로 단일 타임라인 항목을 가져옵니다.
삽입: 타임라인에 새 항목을 삽입합니다.
list: 인증된 사용자의 타임라인 항목 목록을 검색합니다.
패치: 제대로 타임라인 항목을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.
업데이트: 제대로 타임라인 항목을 업데이트합니다.