Эта страница переведена с помощью Cloud Translation API.

Глоссарий

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

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

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

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

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

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

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