이 페이지는 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">`, 여기서 첨부파일_색인은 이 배열의 0부터 시작하는 색인입니다. cid: `<img src="cid:attachment_id">`이며, 여기서 첨부파일 ID는 첨부파일의 ID입니다.
`bundleId`	`string`	이 상품의 번들 ID입니다. 서비스는 bundleId를 지정하여 많은 항목을 함께 그룹화할 수 있습니다. 기기의 단일 최상위 항목 아래에 표시됩니다.	쓰기 가능
`canonicalUrl`	`string`	타임라인 항목이 나타내는 데이터의 표준/고화질 버전을 가리키는 표준 URL입니다.	쓰기 가능
`created`	`datetime`	RFC 3339에 따른 형식으로 이 항목이 생성된 시간입니다.
`creator`	`nested object`	이 항목을 만든 사용자 또는 그룹입니다.	쓰기 가능
`displayTime`	`datetime`	이 항목이 RFC 3339에 따른 형식으로 타임라인에 표시될 때 표시되어야 하는 시간입니다. 이 사용자의 타임라인은 표시 시간에 따라 시간순으로 정렬되므로 타임라인에서 항목이 표시되는 위치도 결정됩니다. 서비스에서 설정하지 않으면 표시 시간은 기본적으로 `updated` 시간으로 설정됩니다.	쓰기 가능
`etag`	`etag`	이 항목에 대한 eETag입니다.
`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`	이 항목의 알림이 기기에 표시되는 방식을 제어합니다. 이 ID가 없으면 알림이 생성되지 않습니다.	쓰기 가능
`notification.deliveryTime`	`datetime`	알림이 전달되어야 하는 시간입니다.	쓰기 가능
`notification.level`	`string`	알림의 중요도를 설명합니다. 허용되는 값은 다음과 같습니다. `DEFAULT` - 기본 중요도 알림 사용자에게 알리기 위해 차임벨이 울립니다.	쓰기 가능
`pinScore`	`integer`	고정된 항목의 경우 이에 따라 항목이 타임라인에 표시되는 순서가 결정되며 점수가 높을수록 시계가 가까워집니다. 참고: 이 필드의 설정은 현재 지원되지 않습니다.
`recipients[]`	`list`	이 항목이 공유된 사용자 또는 그룹 목록입니다.	쓰기 가능
`selfLink`	`string`	이 항목을 검색하는 데 사용할 수 있는 URL입니다.
`sourceItemId`	`string`	자체 서비스의 데이터에 타임라인 항목을 매핑하는 데 사용할 수 있는 불투명 문자열입니다.	쓰기 가능
`speakableText`	`string`	이 항목의 콘텐츠의 음성 버전입니다. `READ_ALOUD` 메뉴 항목과 함께 이 입력란을 사용하여 소리내어 읽을 때 더 명확하게 표시되는 텍스트를 제공하거나 Glass에 표시되는 내용에 대해 확장된 정보를 제공할 수 있습니다. Glass 소프트웨어는 또한 추가 컨텍스트가 유용한 경우(예: 사용자가 알림 후 항목을 소리 내어 읽도록 요청하는 경우) 이 텍스트보다 먼저 말할 SpeakeasyableType 필드도 지정해야 합니다.	쓰기 가능
`speakableType`	`string`	이 항목의 유형에 대한 음성 지원 설명입니다. 예를 들어 사용자가 알림 후에 항목을 소리 내어 읽어 달라고 요청하는 경우와 같이 추가 컨텍스트가 유용한 경우 항목의 콘텐츠를 읽기 전에 사용자에게 알림이 제공됩니다. '이메일', '문자 메시지' 또는 '일일 플래닛 뉴스 업데이트'와 같이 짧고 간단한 명사구여야 합니다. Glass 소프트웨어는 사용자가 화면을 보지 않고도 항목 유형을 알 수 있도록 항목에 SpeechableText 또는 텍스트가 포함되어 있지 않더라도 모든 타임라인 항목에 이 필드를 채우는 것이 좋습니다.	쓰기 가능
`text`	`string`	이 항목의 텍스트 콘텐츠입니다.	쓰기 가능
`title`	`string`	이 항목의 제목입니다.	쓰기 가능
`updated`	`datetime`	이 항목이 마지막으로 수정된 시간으로 RFC 3339에 따른 형식입니다.

메서드

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