Глоссарий

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

Дополнение для конференц-связи по календарю

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

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

Карта

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

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

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

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

Надстройки Google Workspace основаны на карточках.

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

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

Более подробная информация содержится в данных конференции .

Решение для конференций

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

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

Контекст

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

Контекстное срабатывание

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

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

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

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

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

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

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

Дополнения для Gmail

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

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

Главная страница

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

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

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

Дополнение Google Workspace расширяет функциональность таких приложений, как Gmail или Google Calendar.

на основе HTML

Дополнение, пользовательский интерфейс которого определяется с помощью HTML и CSS, а не встроенной в Apps Script службы Card . Только более старые дополнения для редактора основаны на HTML.

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

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

Манифест

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

Явный триггер

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

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

Неконтекстуальные карты

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

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

Умный чип

«Умный чип» — это упоминание человека, файла, события календаря или другого объекта в приложении Google Workspace. При наведении курсора на чип пользователи также могут просмотреть дополнительную информацию о файле или ссылке. Например, при наведении курсора на чип в презентации Google Slides пользователи видят снимок экрана слайда, владельца презентации и информацию о том, просматривали ли они эту презентацию ранее.

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

Курок

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

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

Функция запуска

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

Виджет

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

Дополнительную информацию см. в разделе «Виджеты» .

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

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

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