В этой документации используются следующие термины.
Надстройка для конференций в календаре
Надстройка особого типа, позволяющая провайдерам конференц-связи отображать параметры конференц-связи в событиях Календаря 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.
Триггер предварительного просмотра ссылки
Триггеры предварительного просмотра ссылки срабатывают, когда пользователи взаимодействуют со сторонним URL-адресом или URL-адресом, отличным от Google, в хост-приложении Google, таком как Google Docs. Запуск предварительного просмотра ссылок позволяет определить шаблоны URL-адресов для предварительного просмотра из вашей службы или API, а также настроить содержимое предварительного просмотра, включая смарт-чип и карту предварительного просмотра. Триггеры предварительного просмотра ссылок настраиваются в манифесте проекта сценария надстройки и, таким образом, являются типом триггера манифеста.
Дополнительную информацию см. в разделе Ссылки для предварительного просмотра в Документах Google .
Манифест
Файл JSON, прикрепленный к проекту скрипта приложений. Манифест используется для определения информации о проекте, которая необходима сценарию для правильной работы. Для надстроек Google Workspace манифест используется, чтобы указать, какие хосты надстройка может расширять, и предоставить определенные параметры управления пользовательским интерфейсом.
Триггер манифеста
Триггер, определенный в манифесте проекта, например триггер домашней страницы или контекстный триггер. Триггеры манифеста используются исключительно для создания и отображения новых карточек, когда запрашивается домашняя страница надстройки или надстройка входит в контекст, требующий обновления отображения.
Триггеры манифеста отличаются от других триггеров в Apps Script, поскольку они не являются встроенными (например, простые триггеры ) и не могут быть созданы программно с помощью службы скриптов Apps Script (например, устанавливаемые триггеры ).
Неконтекстные карточки
Карточки, которые показывают контент, когда пользователь находится вне определенного контекста; например, при просмотре своих веток электронной почты в Gmail, но не открыл ни одной. Домашние страницы — это своего рода неконтекстная карточка.
Боковая панель
Раздел справа от пользовательского интерфейса хоста, в котором отображается пользовательский интерфейс надстройки Google Workspace. Надстройки Gmail и редактора также могут определять боковые панели.
Умный чип
Смарт-чип — это упоминание человека, файла, события календаря или другого объекта в приложении Google Workspace. Когда пользователи наводят указатель мыши на фишку, они также могут просматривать дополнительное содержимое о файле или ссылке. Например, когда пользователи наводят курсор на презентацию Google Slides, они видят скриншот слайда, владельца презентации и информацию о том, просматривали ли они презентацию раньше.
Вы можете настроить надстройку для использования смарт-чипов для предварительного просмотра ссылок на сторонние службы или службы, не принадлежащие Google. См. Ссылки для предварительного просмотра в Документах Google .
Курок
Условие и автоматический ответ на событие, определенные проектом или надстройкой Apps Script. Триггеры срабатывают при возникновении связанного с ними события (например, при открытии надстройки) и вызывают автоматическое выполнение указанной функции скрипта приложений (триггерной функции). Для надстроек Google Workspace триггерные функции часто создают новые карты, чтобы контролировать, какая часть пользовательского интерфейса надстройки отображается. Только определенные типы событий могут иметь триггеры.
См. дополнительные триггеры для получения дополнительной информации.
Триггерная функция
Функция скрипта приложений в проекте, которая выполняется в ответ на срабатывание триггера.
Виджет
Элемент пользовательского интерфейса, например кнопка, текстовое поле или флажок. Карточки создаются из последовательности объектов-виджетов, определяемых встроенной службой карточек Apps Script.
Дополнительные сведения см. в разделе Виджеты .
Функция обработчика виджета
Функция, которая связывает определенный виджет с определенным объектом действия . Каждый тип виджета имеет набор определенных функций обработчика виджетов, которые он может использовать для подключения к действиям. Функции обработчика виджетов определяют, какое взаимодействие с пользователем инициирует результирующее действие, и являются важным компонентом интерактивности виджета.
Дополнительные сведения см. в разделе Функции обработчика виджетов .
,В этой документации используются следующие термины.
Надстройка для конференций в календаре
Надстройка особого типа, позволяющая провайдерам конференц-связи отображать параметры конференц-связи в событиях Календаря 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.
Триггер предварительного просмотра ссылки
Триггеры предварительного просмотра ссылки срабатывают, когда пользователи взаимодействуют со сторонним URL-адресом или URL-адресом, отличным от Google, в хост-приложении Google, таком как Google Docs. Запуск предварительного просмотра ссылок позволяет определить шаблоны URL-адресов для предварительного просмотра из вашей службы или API, а также настроить содержимое предварительного просмотра, включая смарт-чип и карту предварительного просмотра. Триггеры предварительного просмотра ссылок настраиваются в манифесте проекта сценария надстройки и, таким образом, являются типом триггера манифеста.
Дополнительную информацию см. в разделе Ссылки для предварительного просмотра в Документах Google .
Манифест
Файл JSON, прикрепленный к проекту скрипта приложений. Манифест используется для определения информации о проекте, которая необходима сценарию для правильной работы. Для надстроек Google Workspace манифест используется, чтобы указать, какие хосты надстройка может расширять, и предоставить определенные параметры управления пользовательским интерфейсом.
Триггер манифеста
Триггер, определенный в манифесте проекта, например триггер домашней страницы или контекстный триггер. Триггеры манифеста используются исключительно для создания и отображения новых карточек, когда запрашивается домашняя страница надстройки или надстройка входит в контекст, требующий обновления отображения.
Триггеры манифеста отличаются от других триггеров в Apps Script, поскольку они не являются встроенными (например, простые триггеры ) и не могут быть созданы программно с помощью службы скриптов Apps Script (например, устанавливаемые триггеры ).
Неконтекстные карточки
Карточки, которые показывают контент, когда пользователь находится вне определенного контекста; например, при просмотре своих веток электронной почты в Gmail, но не открыл ни одной. Домашние страницы — это своего рода неконтекстная карточка.
Боковая панель
Раздел справа от пользовательского интерфейса хоста, в котором отображается пользовательский интерфейс надстройки Google Workspace. Надстройки Gmail и редактора также могут определять боковые панели.
Умный чип
Смарт-чип — это упоминание человека, файла, события календаря или другого объекта в приложении Google Workspace. Когда пользователи наводят указатель мыши на фишку, они также могут просматривать дополнительное содержимое о файле или ссылке. Например, когда пользователи наводят курсор на презентацию Google Slides, они видят скриншот слайда, владельца презентации и информацию о том, просматривали ли они презентацию раньше.
Вы можете настроить надстройку для использования смарт-чипов для предварительного просмотра ссылок на сторонние службы или службы, не принадлежащие Google. См. Ссылки для предварительного просмотра в Документах Google .
Курок
Условие и автоматический ответ на событие, определенные проектом или надстройкой Apps Script. Триггеры срабатывают при возникновении связанного с ними события (например, при открытии надстройки) и вызывают автоматическое выполнение указанной функции скрипта приложений (триггерной функции). Для надстроек Google Workspace триггерные функции часто создают новые карты, чтобы контролировать, какая часть пользовательского интерфейса надстройки отображается. Только определенные типы событий могут иметь триггеры.
См. дополнительные триггеры для получения дополнительной информации.
Триггерная функция
Функция скрипта приложений в проекте, которая выполняется в ответ на срабатывание триггера.
Виджет
Элемент пользовательского интерфейса, например кнопка, текстовое поле или флажок. Карточки создаются из последовательности объектов-виджетов, определяемых встроенной службой карточек Apps Script.
Дополнительные сведения см. в разделе Виджеты .
Функция обработчика виджета
Функция, которая связывает определенный виджет с определенным объектом действия . Каждый тип виджета имеет набор определенных функций обработчика виджетов, которые он может использовать для подключения к действиям. Функции обработчика виджетов определяют, какое взаимодействие с пользователем инициирует результирующее действие, и являются важным компонентом интерактивности виджета.
Дополнительные сведения см. в разделе Функции обработчика виджетов .