Timeline

Si quieres obtener una lista de métodos para este recurso, consulta el final de esta página.

Representaciones de recursos

Cada elemento en el cronograma del usuario se representa como una estructura JSON 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 multimedia adjuntos asociados a este elemento. Para su comodidad, puede consultar los archivos adjuntos de sus cargas útiles HTML con el esquema de archivos adjuntos o CID. Por ejemplo: Archivo adjunto: <img src="attachment:attachment_index">, en el que adjunto_índice es el índice basado en 0 de este arreglo. CID: <img src="cid:attachment_id"> en el que adjunto_id es el ID del adjunto.
bundleId	string	Es el ID del paquete de este artículo. Los servicios pueden especificar un bundleId para agrupar muchos elementos. Aparecen en un solo elemento de nivel superior en el dispositivo.	admite escritura
canonicalUrl	string	Corresponde a una URL canónica que dirige a la versión canónica/de alta calidad de los datos representados por el elemento de cronograma.	admite escritura
created	datetime	La hora a la que se creó este elemento, con el formato indicado en RFC 3339.
creator	nested object	El usuario o grupo que creó este elemento.	admite escritura
displayTime	datetime	La hora que debe aparecer cuando se visualiza este elemento en el cronograma, según el formato RFC 3339. La línea de tiempo de este usuario se ordena cronológicamente en el tiempo de visualización, por lo que también determinará dónde se mostrará el elemento en la línea de tiempo. Si el servicio no lo establece, la hora predeterminada será 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, se renderizará html 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 Tablas: table, tbody, td, tfoot, th, thead, tr Elementos HTML bloqueados: estos elementos y sus contenidos se quitan de las cargas útiles de HTML. Encabezados del documento: head, title Inserciones: audio, embed, object, source, video Fotogramas: frame, frameset Secuencias de comandos: applet, script Otros elementos: Se quitan todos los elementos de la lista, pero se conserva el contenido.	admite escritura
id	string	Es el ID del elemento de cronograma. Esto es único dentro del cronograma de un usuario.
inReplyTo	string	Si este elemento se generó como una respuesta a otro elemento, este campo se establecerá en el ID del elemento al que se responde. Se puede utilizar para adjuntar una respuesta a la conversación o publicación correspondiente.
isBundleCover	boolean	Indica si este elemento es una portada de paquete. Si un elemento está marcado como portada, será el punto de entrada al paquete de elementos que tengan la misma bundleId que ese elemento. Solo se mostrará en el cronograma principal, no dentro del paquete abierto. En el cronograma principal, se muestran los siguientes elementos: Los elementos que tienen isBundleCover establecido en true Elementos que no tienen bundleId En el cronograma de un paquete, los elementos que se muestran son los siguientes: Los elementos que tienen el elemento bundleId en cuestión Y isBundleCover establecido en false	admite escritura
isDeleted	boolean	Si es verdadero, indica que se borró el elemento y que solo se estableció la propiedad de ID.
isPinned	boolean	Si esta preferencia se establece como verdadera, indica que este elemento está fijado, lo que significa que está agrupado junto a los elementos "activos", como la navegación y los hangouts, en el lado opuesto de la pantalla principal, a partir de los elementos históricos (no fijados). Puedes permitir que el usuario active o desactive el valor de esta propiedad con el elemento de menú integrado TOGGLE_PINNED.
kind	string	El tipo de recurso. Siempre es mirror#timelineItem.
location	nested object	La ubicación geográfica asociada con este elemento.	admite escritura
menuItems[]	list	Una lista de elementos de menú que se presentará 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: CUSTOM: Acción personalizada establecida por el servicio. Cuando el usuario selecciona este menuItem, la API activa una notificación en tu callbackUrl con userActions.type establecido en CUSTOM y userActions.payload configurado en el ID de este elemento de menú. Este es el valor predeterminado. Acciones integradas: REPLY: Inicia una respuesta al elemento de cronograma mediante la IU de grabación de voz. Se debe establecer el atributo creator en el elemento de la línea de tiempo para que este menú esté disponible. REPLY_ALL: El mismo comportamiento que REPLY. Se agregará el elemento recipients original del elemento de cronograma al elemento de respuesta. DELETE: Borra el elemento de cronograma. SHARE: Comparte el elemento de la línea de tiempo con los contactos disponibles. READ_ALOUD: Lee los speakableText de los elementos del cronograma en voz alta. Si no se configura este campo, lee el campo text. Si no se configura ninguno de estos 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 la transcripción de texto 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 el medio desde el 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 del cronograma. TOGGLE_PINNED: Activa o desactiva el estado isPinned del elemento de cronograma. 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 a la creator del elemento de cronograma: Si estableces creator.phoneNumber y Glass está conectado a un teléfono Android, el mensaje será un SMS. De lo contrario, si se configura creator.email, el mensaje será un correo electrónico.	admite escritura
menuItems[].id	string	El ID de este elemento del menú. La genera la aplicación y se trata como un token opaco.	admite escritura
menuItems[].payload	string	Una carga útil genérica cuyo significado cambia según la acción de esta MenuItem. Cuando la acción es OPEN_URI, la carga útil es la URL del sitio web que se mostrará. 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 verdadero en un elemento de menú CUSTOM, ese elemento se quitará del menú una vez que se seleccione.	admite escritura
menuItems[].values[]	list	Para los elementos CUSTOM, es una lista de valores que controlan 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	El nombre que se mostrará para el elemento del menú. Si especificas esta propiedad para un elemento de menú integrado, no se muestra 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: DEFAULT: Es el valor predeterminado que se muestra cuando se muestra en la lista menuItems. PENDING: Es el valor que se muestra cuando el usuario selecciona menuItem, pero aún se puede cancelar. CONFIRMED: Es el valor que se muestra cuando el elemento item fue seleccionado por el usuario y ya no se puede cancelar.	admite escritura
notification	nested object	Controla cómo se presentan las notificaciones de este elemento en el dispositivo. 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: DEFAULT: Notificaciones de importancia predeterminada. Se reproducirá un timbre para alertar a los usuarios.	admite escritura
pinScore	integer	En el caso de los elementos fijados, se determina el orden en el que se mostrará en la línea de tiempo, con una puntuación más alta que se muestre más cerca del reloj. Nota: Actualmente, no se admite la configuración de este campo.
recipients[]	list	Una lista de usuarios o grupos con quienes se compartió este elemento.	admite escritura
selfLink	string	Una URL que se puede usar para recuperar este elemento.
sourceItemId	string	String opaca que puedes usar para asignar un elemento de cronograma a los datos en tu propio servicio.	admite escritura
speakableText	string	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 bien para proporcionar información ampliada a lo que se muestra visualmente en Glass. Glassware también debe especificar el campoSpeakableType, que se anunciará antes de este texto en casos en los que el contexto adicional sea útil, por ejemplo, cuando el usuario solicite 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 casos en los que el contexto adicional sea útil, por ejemplo, cuando el usuario solicite que el elemento se lea en voz alta después de una notificación. Debería ser una frase corta y nominal simple, como "Correo electrónico", "Mensaje de texto" o "Actualización diaria de noticias del planeta". Se recomienda que completes este campo para cada elemento del cronograma, incluso si el elemento no contiene texto hablado o texto a fin de 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	El título de este elemento.	admite escritura
updated	datetime	La hora a la que se modificó este elemento por última vez, con el formato indicado en RFC 3339.

Métodos

borrar

Borra un elemento del cronograma.

obtener

Obtén un elemento de cronograma único por ID.

insertar

Inserta un elemento nuevo en el cronograma.

list

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

parche

Actualiza un elemento del cronograma establecido. Este método admite la semántica de parches.

actualizar

Actualiza un elemento del cronograma establecido.