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:
|
|
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.
Elementos HTML bloqueados: estos elementos y sus contenidos se quitan de las cargas útiles de HTML.
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:
|
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:
|
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.
|
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:
|
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:
|
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.