Timeline

Para obtener una lista de métodos para este recurso, consulta al final de esta página.

Representaciones de recursos

Cada elemento del cronograma del usuario se representa como una estructura JSON de TimelineItem, que se describe a continuación.

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

Nombre de la propiedad	Valor	Descripción	Notas
attachments[]	list	Una lista de archivos adjuntos multimedia asociados con este elemento. Para tu comodidad, puedes hacer referencia a los archivos adjuntos en tus cargas útiles HTML con el archivo adjunto o esquema de CID. Por ejemplo: adjunto: <img src="attachment:attachment_index"> donde adjunto_index es el índice basado en 0 de este array. cid: <img src="cid:attachment_id">, en el que el adjunto_id es el ID del adjunto.
bundleId	string	Es el ID del paquete de este artículo. Los Services pueden especificar un bundleId para agrupar muchos elementos. Aparecen debajo de un solo elemento de nivel superior del dispositivo.	admite escritura
canonicalUrl	string	Es una URL canónica que dirige a la versión canónica o de alta calidad de los datos representados por el elemento de cronograma.	admite escritura
created	datetime	Indica la fecha en la que se creó este elemento, con el formato RFC 3339.
creator	nested object	El usuario o grupo que creó este elemento.	admite escritura
displayTime	datetime	Es la hora en la que se debe mostrar este elemento en la línea de tiempo, con el formato que se indica en RFC 3339. El cronograma de este usuario está ordenado cronológicamente por tiempo de visualización, por lo que esto también determinará dónde se muestra el elemento en el cronograma. Si el servicio no la establece, la hora de visualización se establece de forma predeterminada en la hora updated.	admite escritura
etag	etag	ETag de este elemento.
html	string	Contenido HTML de este elemento. Si se proporcionan text y html para un elemento, html se renderizará en el cronograma. Elementos HTML permitidos: Puedes usar estos elementos en tus tarjetas de cronograma. Encabezados: h1, h2, h3, h4, h5, h6 Imágenes: img Listas: li, ol, ul Semántica de HTML5: article, aside, details, figure, figcaption, footer, header, nav, section, summary, time Estructural: blockquote, br, div, hr, p, span Estilo: b, big, center, em, i, u, s, small, strike, strong, style, sub, sup Tabla: table, tbody, td, tfoot, th, thead, tr Elementos HTML bloqueados: Estos elementos y su contenido se quitan de las cargas útiles HTML. Encabezados del documento: head, title Incorporaciones: audio, embed, object, source, video Marcos: frame, frameset Secuencia de comandos: applet, script Otros elementos: Los elementos que no aparezcan en la lista se quitan, pero se conserva su contenido.	admite escritura
id	string	El ID del elemento de la línea de tiempo. Esto es único dentro del cronograma del usuario.
inReplyTo	string	Si este elemento se generó como respuesta a otro elemento, este campo se establecerá con el ID del elemento al que se está respondiendo. Se puede utilizar para adjuntar una respuesta a la conversación o publicación correspondiente.
isBundleCover	boolean	Indica si este artículo es una portada de paquete. Si un artículo está marcado como portada del paquete, será el punto de entrada al paquete de elementos que tenga la misma bundleId que ese artículo. Solo se mostrará en el cronograma principal, no en el paquete abierto. En el cronograma principal, se muestran los siguientes elementos: Elementos que tienen isBundleCover establecido como true Elementos que no tienen un bundleId En el cronograma secundario del paquete, se muestran los siguientes elementos: Elementos que tienen el bundleId en cuestión Y isBundleCover establecidos en false	admite escritura
isDeleted	boolean	Cuando es verdadero, indica que se borró este elemento y que solo se establece la propiedad ID.
isPinned	boolean	Si es verdadero, indica que este elemento está fijado, lo que significa que está agrupado junto a "active". elementos como la navegación y los hangouts, en el lado opuesto de la pantalla de inicio a los elementos históricos (sin fijar) del cronograma. Puedes permitir que el usuario active o desactive el valor de esta propiedad con el elemento de menú integrado TOGGLE_PINNED.
kind	string	Es el tipo de recurso. Siempre es mirror#timelineItem.
location	nested object	Es la ubicación geográfica asociada con este elemento.	admite escritura
menuItems[]	list	Una lista de los elementos de menú que se presentarán al usuario cuando se seleccione este elemento en el cronograma.	admite escritura
menuItems[].action	string	Controla el comportamiento cuando el usuario elige la opción del menú. Los valores permitidos son los siguientes: CUSTOM: Es la acción personalizada que establece el servicio. Cuando el usuario selecciona este menuItem, la API activa una notificación para tu callbackUrl con userActions.type establecido en CUSTOM y userActions.payload establecido en ID de este elemento de menú. Este es el valor predeterminado. Acciones integradas: REPLY: Inicia una respuesta al elemento de la línea de tiempo con la IU de grabación de voz. Para que este menú esté disponible, se debe establecer el atributo creator en el elemento de cronograma. REPLY_ALL: El mismo comportamiento que REPLY. El recipients del elemento de cronograma original se agregará al elemento de respuesta. DELETE: Borra el elemento de la línea de tiempo. SHARE: Comparte el elemento de la línea de tiempo con los contactos disponibles. READ_ALOUD: Lee el speakableText del elemento de la línea de tiempo en voz alta. si este campo no está configurado, lee el campo text. si no se establece ninguno de esos campos, se ignora este elemento de menú. GET_MEDIA_INPUT: Permite que los usuarios proporcionen cargas útiles de contenido multimedia a Glassware desde un elemento de menú (por el momento, solo se admite texto transcrito de entrada de voz). Suscríbete a las notificaciones cuando los usuarios invoquen este elemento de menú para recibir el ID de elemento del cronograma. Recupera los elementos multimedia del elemento de cronograma en la propiedad payload. VOICE_CALL: Inicia una llamada telefónica con el atributo creator.phoneNumber del elemento de cronograma como destinatario. NAVIGATE: Navega al location del elemento de la línea de tiempo. TOGGLE_PINNED: Activa o desactiva el estado isPinned del elemento de la línea de tiempo. OPEN_URI: Abre el payload del elemento de menú en el navegador. PLAY_VIDEO: Abre el payload del elemento de menú en el reproductor de video de Glass. SEND_MESSAGE: Inicia el envío de un mensaje al creator del elemento de la línea de tiempo: Si se establece creator.phoneNumber y Glass está conectado a un teléfono Android, el mensaje es un SMS. De lo contrario, si se configura creator.email, el mensaje es un correo electrónico.	admite escritura
menuItems[].id	string	Es el ID de este elemento de menú. La aplicación lo genera y se lo trata como un token opaco.	admite escritura
menuItems[].payload	string	Una carga útil genérica cuyo significado cambia según la acción de este MenuItem. Cuando la acción es OPEN_URI, la carga útil es la URL del sitio web que se verá. Cuando la acción es PLAY_VIDEO, la carga útil es la URL de transmisión del video. Cuando la acción es GET_MEDIA_INPUT, la carga útil es la transcripción de texto de la entrada de voz de un usuario.	admite escritura
menuItems[].removeWhenSelected	boolean	Si se establece como verdadera en un elemento de menú CUSTOM, ese elemento se quitará del menú después de que se seleccione.	admite escritura
menuItems[].values[]	list	En el caso de los elementos CUSTOM, es una lista de valores que controla la apariencia del elemento de menú en cada uno de sus estados. Se debe proporcionar un valor para el estado DEFAULT. Si faltan los estados PENDING o CONFIRMED, no se mostrarán.	admite escritura
menuItems[].values[].displayName	string	Es el nombre que se mostrará para el elemento de menú. Si especificas esta propiedad para un elemento de menú integrado, no se mostrará el comando por voz contextual predeterminado para ese elemento de menú.	admite escritura
menuItems[].values[].iconUrl	string	URL de un ícono para mostrar con el elemento de menú	admite escritura
menuItems[].values[].state	string	El estado al que se aplica este valor. Los valores permitidos son los siguientes: DEFAULT: Es el valor predeterminado que aparece cuando aparece en la lista menuItems. PENDING: Es el valor que se muestra cuando el usuario selecciona el menuItem, pero aún se puede cancelar. CONFIRMED: Es el valor que se muestra cuando el usuario selecciona el elemento de menú y ya no se puede cancelar.	admite escritura
notification	nested object	Controla cómo se presentan en el dispositivo las notificaciones de este elemento. Si falta, no se generará ninguna notificación.	admite escritura
notification.deliveryTime	datetime	La hora a la que se debe entregar la notificación.	admite escritura
notification.level	string	Describe la importancia de la notificación. Los valores permitidos son los siguientes: DEFAULT: Notificaciones de importancia predeterminada. Se reproducirá una campanilla para alertar a los usuarios.	admite escritura
pinScore	integer	Para los elementos fijados, esto determina el orden en el que el elemento se muestra en la línea de tiempo; la puntuación más alta aparece más cerca del reloj. Nota: Por el momento, no se admite la configuración de este campo.
recipients[]	list	Una lista de usuarios o grupos con los que se compartió este elemento.	admite escritura
selfLink	string	La URL que se puede usar para recuperar este elemento.
sourceItemId	string	Es una cadena opaca que puedes usar para asignar un elemento de cronograma a los datos de tu propio servicio.	admite escritura
speakableText	string	Es la versión hablada del contenido de este elemento. Junto con el elemento de menú READ_ALOUD, usa este campo para proporcionar un texto que sea más claro cuando se lea en voz alta o para brindar información más detallada sobre lo que se muestra visualmente en Glass. Glassware también debe especificar el campo talkableType, que se dirá antes de este texto en los casos en los que el contexto adicional sea útil, por ejemplo, cuando el usuario solicita que el elemento se lea en voz alta después de una notificación.	admite escritura
speakableType	string	Es una descripción hablada del tipo de este elemento. Esto se anunciará al usuario antes de leer el contenido del elemento en los casos en los que el contexto adicional sea útil, por ejemplo, cuando el usuario solicita que el elemento se lea en voz alta después de una notificación. Debe ser una frase nominal corta y simple, como "Correo electrónico", "Mensaje de texto" o "Actualización de noticias de Daily Planet". Se recomienda que los objetos de Glassware propaguen este campo para cada elemento de la línea de tiempo, incluso si el elemento no contiene SpeakeasyText, de modo que el usuario pueda aprender el tipo de elemento sin mirar la pantalla.	admite escritura
text	string	Contenido de texto de este elemento.	admite escritura
title	string	Es el título de este elemento.	admite escritura
updated	datetime	Indica la hora en la que se modificó este elemento por última vez, con el formato indicado en RFC 3339.

Métodos

borrar

Borra un elemento de la línea de tiempo.

get

Obtiene un solo elemento del cronograma por ID.

insertar

Inserta un elemento nuevo en la línea de tiempo.

list

Recupera una lista de elementos del cronograma para el usuario autenticado.

patch

Actualiza un elemento de la línea de tiempo en su lugar. Este método admite la semántica de parches.

actualización

Actualiza un elemento de la línea de tiempo en su lugar.