Chips inteligentes

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 proporcionan a los usuarios acceso rápido a la información y las acciones, lo que transforma 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 si proporcionas un UpdateCellsRequest o 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 chips se pueden omitir en la escritura.

En el siguiente ejemplo, se muestra cómo escribir un chip de archivo, un chip de personas y texto sin formato en una sola celda, A1. * {JSON}

        {
          "updateCells": {
            "rows": [
              {
                "values": [
                  {
                    "userEnteredValue": {
                      "stringValue": "@ is the owner of @."
                    },
                    "chipRuns": [
                      {
                        "chip": {
                          "personProperties": {
                            "email": "johndoe@gmail.com",
                            "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
            }
          }
        }

Configura las propiedades del chip

Un objeto de chip puede tener uno de los siguientes tipos de propiedades:

personProperties

Úsalo para crear un chip de persona.

  • email: (Obligatorio) Es la 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: La dirección de correo electrónico de la persona.

Ú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 el Calendario), solo los vínculos a archivos de Google Drive se pueden escribir como chips.

  • uri: (Obligatorio) Es el URI del recurso. Para escribir, este debe ser un vínculo a un archivo de Google Drive. Los URIs 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 en la respuesta contendrá objetos para todas las subsecciones del texto de la celda.

  • Ejecuciones con chips: Estas secciones tendrán un objeto chip propagado que contiene personProperties o richLinkProperties.
  • Ejecuciones sin chips: Las secciones de texto sin formato también tendrán un objeto de ejecución, pero su campo chip estará vacío.

Para obtener el texto visible de un chip, agrega formattedValue como campo.

Actualiza un chip inteligente

Para actualizar o reemplazar un chip inteligente, debes reemplazar el contenido de la celda. Usa el mismo UpdateCellsRequest o AppendCellsRequest que usarías para agregar un chip y proporciona un userEnteredValue y un chipRun nuevos. Esto reemplazará el chip existente en la celda.

Usa 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 personas) o de los documentos relacionados (chip de archivo).

Filtros: Puedes filtrar rangos según el valor de texto de los chips inteligentes que los contienen.