Глоссарий

В данной документации используются следующие термины.

Дополнение для проведения конференций в календаре

Особый вид надстройки, позволяющий поставщикам услуг конференц-связи представлять варианты конференц-связи в событиях Календаря Google. Для этих надстроек требуется хорошо развитое решение для конференц-связи, к которому можно подключиться. Из-за этого требования у большинства разработчиков никогда не возникает необходимости создавать надстройку для конференц-связи «Календарь».

Дополнительные сведения см. в разделе «Дополнения для конференций Календаря» . Также см. раздел Обновление опубликованных надстроек , чтобы узнать, как преобразовать надстройку для конференций Календаря в надстройку Google Workspace.

Карта

Одна «страница» пользовательского интерфейса дополнения. Карточки состоят из различных объектов виджетов (кнопок, текстовых полей, заголовков и т. д.).

См. Карты для получения дополнительной информации.

на основе карты

Надстройка, пользовательский интерфейс которой отображается в виде панели на боковой панели (или, на мобильных устройствах, в виде другого окна активности, доступного через меню). Надстройка имеет верхнюю панель инструментов, которая идентифицирует надстройку и отображает карточку — по сути, «страницу» пользовательского интерфейса надстройки.

Дополнения Google Workspace основаны на карточках.

Данные конференции

Набор информации, необходимый Календарю Google, чтобы пользователи могли создавать сторонние конференции и присоединяться к ним с помощью надстройки Google Workspace или надстройки для конференций Календаря.

См. данные конференции для получения дополнительной информации.

Конференц-решение

Представление сторонней конференции, которую можно создать из Календаря Google с помощью надстройки Google Workspace или надстройки для конференций Календаря.

Дополнительную информацию см. в разделе «Решения для конференций» .

Контекст

Текущее состояние главного приложения. Например, какое сообщение открыто в Gmail в данный момент, какое событие Календаря вы редактируете или какие файлы Диска вы выбрали, являются частью текущего контекста главного приложения. Контекст вместе с другой информацией собирается в объект события, который передается триггерной функции в качестве параметра.

Контекстный триггер

Практика определения триггеров, которые срабатывают, когда пользователь входит в определенный контекст, например, когда он открывает цепочку электронных писем в Gmail. Контекстный запуск позволяет вашей надстройке предоставлять пользовательский интерфейс, соответствующий этому контексту. Контекстные триггеры настраиваются в манифесте проекта дополнительного скрипта и, таким образом, являются типом триггера манифеста .

Дополнения редактора

Исходный набор типов надстроек, которые допускали расширения только Google Docs, Sheets, Forms или Slides. Дополнения редактора не основаны на карточках; скорее, они требовали от разработчика создания пользовательского интерфейса из необработанного HTML и CSS. Каждое дополнение редактора может расширять только одно ведущее приложение.

Дополнительные сведения см. в разделе «Дополнения редактора» .

Объект события

Объект JSON, который автоматически создается при запросе домашних страниц, когда надстройка входит в контекст, на который ей необходимо ответить, или в результате взаимодействия пользователя с виджетами в интерфейсе надстройки. После создания объекты событий передаются указанной триггерной функции или функции обратного вызова. Целью объектов событий является передача информации из клиентской среды пользователя (например, информации, которую они ввели в виджеты интерфейса надстройки) в серверный код надстройки, который затем может действовать на основе этой информации и вернуть соответствующий ответ.

Дополнительные сведения см. в разделе Объекты событий .

Дополнения Gmail

Дополнение, расширяющее только Gmail. Дополнения Gmail основаны на карточках. Большая часть функций, поведения и деталей разработки, используемых для создания надстроек Gmail, идентична тем же деталям, которые используются для создания надстроек Google Workspace.

Дополнительную информацию см. в разделе «Дополнения Gmail» . Также см. Обновление опубликованных надстроек , чтобы узнать, как преобразовать надстройку Gmail в надстройку Google Workspace.

Домашняя страница

Корневая карта пользовательского интерфейса дополнения. Домашние страницы отображаются, когда пользователи открывают надстройку, и позволяют вашей надстройке отображать контент вне определенного контекста (например, когда пользователь просматривает свои цепочки электронных писем в Gmail, но еще не открыл ни одну). Вы определяете внешний вид и поведение домашней страницы вашего дополнения, как и любую другую карту.

См. Домашние страницы для получения дополнительной информации.

Хост или хост-приложение

Приложение Google Workspace, расширяемое надстройкой Google Workspace, например Gmail или Календарь Google.

на основе HTML

Надстройка, пользовательский интерфейс которой определяется с использованием HTML и CSS вместо встроенного сервиса карточек Apps Script. Только старые надстройки редактора основаны на HTML.

Предварительный просмотр ссылки срабатывает, когда пользователи взаимодействуют со сторонним или не принадлежащим Google URL-адресом в хост-приложении Google, например в Документах Google. Запуск предварительного просмотра ссылок позволяет вам определять шаблоны URL-адресов для предварительного просмотра из вашего сервиса или API, а также настраивать содержимое предварительного просмотра, включая смарт-чип и карту предварительного просмотра. Триггеры предварительного просмотра ссылок настраиваются в манифесте проекта сценария надстройки и, таким образом, являются типом триггера манифеста.

Дополнительную информацию см. в разделе «Предварительный просмотр ссылок со смарт-чипами» .

Манифест

Файл JSON, прикрепленный к проекту Apps Script. Манифест используется для определения информации о проекте, необходимой для корректной работы сценария. Для надстроек Google Workspace манифест используется для указания хостов, которые надстройка может расширять, и предоставления определенных настроек управления пользовательским интерфейсом.

Манифестный триггер

Триггер, определенный в манифесте проекта, например триггер домашней страницы или контекстный триггер. Триггеры манифеста используются исключительно для создания и отображения новых карточек, когда запрашивается домашняя страница надстройки или надстройка входит в контекст, требующий обновления отображения.

Триггеры манифеста отличаются от других триггеров в Apps Script, поскольку они не являются встроенными (например, простые триггеры ) и не могут быть созданы программно с помощью службы Apps Script Script (например, устанавливаемые триггеры ).

Неконтекстные карты

Карты, которые показывают контент, когда пользователь находится вне определенного контекста; например, при просмотре веток электронной почты в Gmail, но не открыл ни одной. Домашние страницы — это своего рода внеконтекстные карты.

Раздел справа от пользовательского интерфейса хоста, в котором отображается пользовательский интерфейс надстройки Google Workspace. Надстройки Gmail и редактора также могут определять боковые панели.

Умный чип

Смарт-чип – это упоминание человека, файла, события календаря или другого объекта в приложении Google Workspace. Когда пользователи наводят курсор на чип, они также могут просмотреть дополнительный контент о файле или ссылке. Например, когда пользователи наводят курсор мыши на презентацию Google Slides, они видят снимок экрана слайда, владельца презентации и информацию о том, просматривали ли они презентацию раньше.

Вы можете настроить свое дополнение на использование смарт-чипов для предварительного просмотра ссылок на сторонние службы или службы, не принадлежащие Google. См. Ссылки на предварительный просмотр в Документах Google .

Курок

Условие и автоматический ответ на событие, определяемые проектом или надстройкой Apps Script. Триггеры срабатывают при возникновении связанного с ними события (например, при открытии надстройки) и вызывают автоматическое выполнение указанной функции Apps Script (функции триггера). В надстройках Google Workspace триггерные функции часто создают новые карточки, чтобы контролировать, какая часть пользовательского интерфейса надстройки отображается. Только определенные типы событий могут иметь триггеры.

Дополнительную информацию см. в дополнительных триггерах .

Триггерная функция

Функция Apps Script в проекте, которая выполняется в ответ на срабатывание триггера.

Виджет

Элемент пользовательского интерфейса, например кнопка, текстовое поле или флажок. Карты создаются из последовательности объектов-виджетов, определяемых встроенным сервисом карточек Apps Script.

См. Виджеты для получения дополнительной информации.

Функция обработчика виджета

Функция, которая связывает конкретный виджет с конкретным объектом действия . Каждый тип виджета имеет набор определенных функций-обработчиков виджетов, которые он может использовать для подключения к действиям. Функции обработки виджета определяют, какой тип взаимодействия с пользователем вызывает результирующее действие, и являются важнейшим компонентом интерактивности виджета.

Дополнительные сведения см. в разделе Функции обработчика виджетов .