Timeline

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Cada item na linha do tempo do usuário é representado como uma estrutura JSON TimelineItem, descrita abaixo.

{
  "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
  }
}

Nome da propriedade	Valor	Descrição	Observações
attachments[]	list	Uma lista de anexos de mídia associados a este item. Por conveniência, consulte os anexos nos payloads de HTML com o esquema de anexo ou CID. Por exemplo: anexo: <img src="attachment:attachment_index">, em que anexo_index é o índice baseado em zero desta matriz. cid: <img src="cid:attachment_id">, em que anexo_id é o ID do anexo.
bundleId	string	O ID do pacote deste item. Os serviços podem especificar um bundleId para agrupar muitos itens. Eles são exibidos em um único item de nível superior no dispositivo.	gravável
canonicalUrl	string	Um URL canônico que aponta para a versão canônica/de alta qualidade dos dados representados pelo item da linha do tempo.	gravável
created	datetime	O horário em que esse item foi criado, formatado de acordo com o RFC 3339.
creator	nested object	Usuário ou grupo que criou o item.	gravável
displayTime	datetime	É o horário em que esse item é exibido na linha do tempo, formatado de acordo com o RFC 3339. A linha do tempo do usuário é classificada cronologicamente no tempo de exibição. Portanto, isso também determina onde o item é exibido na linha do tempo. Se não for definido pelo serviço, o tempo de exibição padrão será updated.	gravável
etag	etag	ETag para este item.
html	string	Este é o conteúdo HTML para este item. Se text e html forem fornecidos para um item, o html será renderizado na linha do tempo. Elementos HTML permitidos: use esses elementos nos cards da linha do tempo. Cabeçalhos: h1, h2, h3, h4, h5, h6 Imagens: img Listas: li, ol, ul Semântica HTML5: article, aside, details, figure, figcaption, footer, header, nav, section, summary, time Estrutural: blockquote, br, div, hr, p, span Estilo: b, big, center, em, i, u, s, small, strike, strong, style, sub, sup Tabelas: table, tbody, td, tfoot, th, thead, tr Elementos HTML bloqueados: esses elementos e o conteúdo deles são removidos dos payloads HTML. Cabeçalhos do documento: head, title Incorpora em: audio, embed, object, source, video Molduras: frame, frameset Script: applet, script Outros elementos: todos os elementos que não estiverem listados são removidos, mas o conteúdo deles será preservado.	gravável
id	string	ID do item de linha do tempo. Isso é exclusivo na linha do tempo do usuário.
inReplyTo	string	Se esse item foi gerado como uma resposta a outro item, esse campo será definido como o ID do item respondido. Isso pode ser usado para anexar uma resposta à conversa ou postagem adequada.
isBundleCover	boolean	Indica se o item é uma capa do pacote. Se um item for marcado como uma capa do pacote, ele será o ponto de entrada para o pacote de itens que têm o mesmo bundleId que esse item. Essa informação será exibida somente na linha do tempo principal, e não no pacote aberto. Na linha do tempo principal, os itens mostrados são: Itens com isBundleCover definido como true Itens que não têm um bundleId Em uma linha do tempo de pacote, os itens mostrados são: Itens que têm bundleId em questão E isBundleCover definido como false	gravável
isDeleted	boolean	Quando verdadeiro, indica que o item foi excluído e apenas a propriedade do ID foi definida.
isPinned	boolean	Quando verdadeiro, indica que o item está fixado, o que significa que está agrupado com itens "ativos", como navegação e hangouts, no lado oposto da tela inicial dos itens da linha do tempo históricos (não fixados). Você pode permitir que o usuário alterne o valor dessa propriedade com o item de menu integrado TOGGLE_PINNED.
kind	string	O tipo de recurso. É sempre mirror#timelineItem.
location	nested object	A localização geográfica associada a este item.	gravável
menuItems[]	list	Lista de itens de menu que serão apresentados ao usuário quando ele for selecionado na linha do tempo.	gravável
menuItems[].action	string	Controla o comportamento quando o usuário escolhe a opção do menu. Os valores permitidos são: CUSTOM: ação personalizada definida pelo serviço. Quando o usuário seleciona essa menuItem, a API aciona uma notificação para o callbackUrl com a userActions.type definida como CUSTOM e a userActions.payload definida como ID desse item de menu. Esse é o valor padrão. Ações integradas: REPLY: inicie uma resposta para o item da linha do tempo usando a IU de gravação de voz. O atributo creator precisa ser definido no item da linha do tempo para que esse menu esteja disponível. REPLY_ALL: mesmo comportamento que REPLY. O item recipients da linha do tempo original vai ser adicionado ao item de resposta. DELETE: exclui o item da linha do tempo. SHARE: compartilhe o item da linha do tempo com os contatos disponíveis. READ_ALOUD: lê o speakableText do item da linha do tempo em voz alta. Se este campo não estiver definido, leia o campo text. Se nenhum desses campos for definido, o item de menu será ignorado. GET_MEDIA_INPUT: permite que os usuários forneçam payloads de mídia para o Glassware de um item de menu. Atualmente, apenas texto transcrito da entrada de voz é compatível. Inscreva-se para receber notificações quando os usuários invocarem este item de menu para receber o código do item da linha do tempo. Recupere a mídia do item da linha do tempo na propriedade payload. VOICE_CALL: inicie uma chamada usando o atributo creator.phoneNumber do item da linha do tempo como destinatário. NAVIGATE: acesse o location do item da linha do tempo. TOGGLE_PINNED: alterna o estado isPinned do item da linha do tempo. OPEN_URI: abra o payload do item de menu no navegador. PLAY_VIDEO: abra o payload do item de menu no player de vídeo do Google Glass. SEND_MESSAGE: comece a enviar uma mensagem para o creator do item da linha do tempo: Se o creator.phoneNumber estiver definido e o Glass estiver conectado a um smartphone Android, a mensagem será um SMS. Caso contrário, se o creator.email estiver definido, a mensagem será um e-mail.	gravável
menuItems[].id	string	O ID deste item de menu. Isso é gerado pelo aplicativo e é tratado como um token opaco.	gravável
menuItems[].payload	string	Um payload genérico que muda o significado dependendo da ação desse MenuItem. Quando a ação é OPEN_URI, o payload é o URL do site a ser visualizado. Quando a ação é PLAY_VIDEO, o payload é o URL de streaming do vídeo Quando a ação é GET_MEDIA_INPUT, o payload é a transcrição de texto da entrada de fala de um usuário	gravável
menuItems[].removeWhenSelected	boolean	Se definido como verdadeiro em um item de menu do CUSTOM, esse item vai ser removido do menu depois que for selecionado.	gravável
menuItems[].values[]	list	Para itens CUSTOM, uma lista de valores controla a aparência do item de menu em cada um dos estados. É necessário informar um valor para o estado DEFAULT. Se não houver estados PENDING ou CONFIRMED, eles não serão exibidos.	gravável
menuItems[].values[].displayName	string	Nome a ser exibido para o item de menu. Se você especificar essa propriedade para um item de menu integrado, o comando de voz contextual padrão para esse item de menu não será exibido.	gravável
menuItems[].values[].iconUrl	string	URL de um ícone a ser exibido com o item de menu.	gravável
menuItems[].values[].state	string	O estado a que esse valor se aplica. Os valores permitidos são: DEFAULT: valor padrão mostrado quando exibido na lista menuItems. PENDING: valor mostrado quando o menuItem foi selecionado pelo usuário, mas ainda pode ser cancelado. CONFIRMED: valor mostrado quando o menu "itemItem" foi selecionado pelo usuário e não pode mais ser cancelado.	gravável
notification	nested object	Controla como as notificações deste item são apresentadas no dispositivo. Nenhuma notificação é gerada se esse recurso estiver ausente.	gravável
notification.deliveryTime	datetime	O horário em que a notificação deve ser entregue.	gravável
notification.level	string	Descreve a importância da notificação. Os valores permitidos são: DEFAULT: notificações da importância padrão. Uma campainha tocará para alertar os usuários.	gravável
pinScore	integer	Para itens fixados, isso determina a ordem em que o item é exibido na linha do tempo, com uma pontuação mais alta aparecendo mais perto do relógio. Observação: no momento, não é possível definir esse campo.
recipients[]	list	Lista de usuários ou grupos com os quais esse item foi compartilhado.	gravável
selfLink	string	Um URL que pode ser usado para recuperar este item.
sourceItemId	string	String opaca que você pode usar para mapear um item da linha do tempo para dados no seu próprio serviço.	gravável
speakableText	string	A versão falada do conteúdo deste item. Além do item de menu READ_ALOUD, use esse campo para fornecer um texto que fique mais claro quando lido em voz alta ou para fornecer mais informações sobre o que está sendo exibido visualmente no Google Glass. O Glassware também precisa especificar o campo talkableType, que vai ser falado antes desse texto nos casos em que o contexto extra é útil, por exemplo, quando o usuário solicita que o item seja lido em voz alta após uma notificação.	gravável
speakableType	string	Uma descrição falada do tipo deste item. Isso será anunciado para o usuário antes da leitura do conteúdo do item nos casos em que o contexto adicional é útil, por exemplo, quando o usuário solicitar que o item seja lido em voz alta após uma notificação. Essa frase precisa ser um substantivo simples, como "E-mail", "Mensagem de texto" ou "Atualização diária sobre notícias do planeta". Recomendamos que o usuário preencha esse campo em todos os itens da linha do tempo, mesmo que o item não tenha textableText ou text. Assim o usuário aprende o tipo de item sem olhar para a tela.	gravável
text	string	Conteúdo de texto desse item.	gravável
title	string	O título deste item.	gravável
updated	datetime	O horário em que este item foi modificado pela última vez, formatado de acordo com o RFC 3339.

Métodos

delete

Exclui um item da linha do tempo.

get

Recebe um único item da linha do tempo por ID.

inserir

Insere um novo item na linha do tempo.

list

Recupera uma lista de itens da linha do tempo para o usuário autenticado.

patch

Atualiza um item da linha do tempo em vigor. Esse método é compatível com a semântica de patch.

update

Atualiza um item da linha do tempo em vigor.