Умные чипы

В этом руководстве описано, как и зачем использовать API Google Sheets для добавления и управления смарт-чипами в ваших электронных таблицах.

Что такое смарт-чип?

С помощью интеллектуальных чипов вы можете напрямую интегрировать интерактивные данные из других приложений Google Workspace в Google Sheets. Интеллектуальные чипы обеспечивают пользователям быстрый доступ к информации и действиям, превращая ссылку на ячейку в динамический объект. Подробнее см. раздел «Вставка интеллектуальных чипов в Google Sheets» .

Добавить смарт-чип

Чипы представлены в виде последовательностей, которые являются частью CellData , поэтому вы можете вставить чип, используя существующий метод spreadsheets.batchUpdate , указав UpdateCellsRequest или AppendCellsRequest .

Запрос должен включать поле chipRuns . Поле chiprun описывает свойства микросхемы и ее местоположение в тексте ячейки.

При записи в chipRuns необходимо также указать userEnteredValue , содержащее символы-заполнители ( @ ) для каждого чипа, который вы собираетесь добавить. Каждый запуск в массиве chipRuns будет соответствовать одному из заполнителей. Запуски без чипов можно опустить при записи.

В следующем примере показано, как записать файл, данные о пользователях и обычный текст в одну ячейку 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
            }
          }
        }

Настройка свойств микросхемы

Объект типа «чип» может иметь один из следующих типов свойств:

свойства человека

Используйте это для создания чипа, указывающего на личность.

  • email : (Обязательно) Адрес электронной почты человека, которого нужно связать.
  • displayFormat : (Необязательно) Предпочтительный формат отображения имени человека. Может быть одним из следующих:
    • DEFAULT : Стандартный формат "Имя Фамилия".
    • LAST_NAME_COMMA_FIRST_NAME : формат "Фамилия, Имя".
    • EMAIL : Адрес электронной почты человека.

Используйте это для создания многофункционального фрагмента ссылки. Хотя API может считывать ссылки на различные сервисы Google (например, YouTube или Календарь), в виде фрагментов ссылки можно записывать только на файлы Google Drive.

  • uri : (Обязательно) URI ресурса. Для записи это должна быть ссылка на файл Google Drive. URI не может превышать 2000 байт.

Считывание смарт-чипа

Для чтения данных с смарт-чипа используйте метод spreadsheets.get и укажите sheets.data.rowData.values(chipRuns) в параметре fields.

Массив chipRuns в ответе будет содержать объекты для всех подразделов текста ячейки.

  • Завершенные задания: В этих разделах будет содержаться заполненный объект chip , включающий либо personProperties , либо richLinkProperties .
  • Забеги без чипа: В текстовых разделах также будет объект забега, но поле chip в нем будет пустым.

Чтобы получить отображаемый текст микросхемы, добавьте поле formattedValue .

Обновить смарт-чип

Для обновления или замены смарт-чипа необходимо перезаписать содержимое ячейки. Используйте тот же UpdateCellsRequest или AppendCellsRequest , что и для добавления чипа, указав новое userEnteredValue и chipRun . Это заменит существующий чип в ячейке.

Используйте смарт-чипы с другими функциями Google Sheets.

Таблицы : Смарт-чипы можно использовать в качестве столбцов таблицы для отслеживания ответственных за проекты (чип «Люди») или связанных документов (чип «Файл»).

Фильтры : Вы можете фильтровать диапазоны на основе текстового значения находящихся в них смарт-чипов.