En esta guía, se describe cómo y por qué usar la API de Hojas de cálculo de Google para agregar y administrar chips inteligentes en tus hojas de cálculo.
¿Qué es un chip inteligente?
Con los chips inteligentes, puedes incorporar datos interactivos y enriquecidos de otras aplicaciones de Google Workspace directamente en Hojas de cálculo. Los chips inteligentes brindan a los usuarios acceso rápido a información y acciones, y transforman un vínculo de celda en un objeto dinámico. Para obtener más información, consulta Cómo insertar chips inteligentes en Hojas de cálculo de Google.
Cómo agregar un chip inteligente
Los chips se representan como ejecuciones de chips, que forman parte de CellData, por lo que puedes insertar un chip con el método spreadsheets.batchUpdate existente proporcionando un UpdateCellsRequest o un AppendCellsRequest.
La solicitud debe incluir el campo chipRuns. Una ejecución de chip describe las propiedades de un chip y dónde se encuentra dentro del texto de la celda.
Cuando escribas chipRuns, también debes proporcionar un userEnteredValue que contenga caracteres de marcador de posición (@) para cada chip que quieras agregar. Cada ejecución en el array chipRuns corresponderá a uno de los marcadores de posición. Las ejecuciones sin chip se pueden omitir en la escritura.
En el siguiente ejemplo, se muestra cómo escribir un chip de archivo, un chip de persona y texto sin formato en una sola celda, A1. * {JSON}
{ "updateCells": { "rows": [ { "values": [ { "userEnteredValue": { "stringValue": "@ is the owner of @." }, "chipRuns": [ { "chip": { "personProperties": { "email": "[email protected]", "displayFormat": "DEFAULT" } } }, { "startIndex": 18, "chip": { "richLinkProperties": { "uri": "https://docs.google.com/document/d/YOUR_DOCUMENT_ID/edit" } } } ] } ] } ], "fields": "userEnteredValue,chipRuns", "range": { "startRowIndex": 0, "startColumnIndex": 0 } } } Cómo configurar las propiedades de los chips
Un objeto de chip puede tener uno de los siguientes tipos de propiedad:
personProperties
Úsalo para crear un chip de persona.
email: (Obligatorio) Dirección de correo electrónico de la persona que se vinculará.displayFormat: (Opcional) Es el formato de visualización preferido para el nombre de la persona. Puede ser uno de los datos siguientes:DEFAULT: Formato estándar "Nombre Apellido".LAST_NAME_COMMA_FIRST_NAME: Formato "Apellido, Nombre".EMAIL: Es la dirección de correo electrónico de la persona.
richLinkProperties
Úsalo para crear un chip de vínculo enriquecido. Si bien la API puede leer vínculos a varios servicios de Google (como YouTube o Calendario), solo los vínculos a archivos de Google Drive se pueden escribir como chips.
uri: (obligatorio) Es el URI del recurso. Para la escritura, debe ser un vínculo a un archivo de Google Drive. Los URI no pueden superar los 2,000 bytes.
Cómo leer un chip inteligente
Para leer los datos de un chip inteligente, usa el método spreadsheets.get y, luego, incluye sheets.data.rowData.values(chipRuns) en el parámetro de campos.
El array chipRuns de la respuesta contendrá objetos para todas las subsecciones del texto de la celda.
- Carriles con chip: Estas secciones tendrán un objeto
chipcompletado que contendrápersonPropertiesorichLinkProperties. - Ejecuciones sin chip: Las secciones de texto sin formato también tendrán un objeto de ejecución, pero su campo
chipestará vacío.
Para obtener el texto visible de un chip, agrega formattedValue como un campo.
Actualiza un chip inteligente
Para actualizar o reemplazar un chip inteligente, debes sobrescribir el contenido de la celda. Usa el mismo UpdateCellsRequest o AppendCellsRequest que usarías para agregar un chip, y proporciona un nuevo userEnteredValue y chipRun. Esto reemplazará el chip existente en la celda.
Cómo usar chips inteligentes con otras funciones de Hojas de cálculo
Tablas: Los chips inteligentes se pueden usar como un tipo de columna de tabla para hacer un seguimiento de los propietarios del proyecto (chip de persona) o de los documentos relacionados (chip de archivo).
Filtros: Puedes filtrar rangos según el valor de texto de los chips inteligentes que contienen.