В данной документации используются следующие термины.
Дополнение для проведения конференций в календаре
Особый вид надстройки, позволяющий поставщикам услуг конференц-связи представлять варианты конференц-связи в событиях Календаря 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-адресом в хост-приложении Google, например в Документах Google. Запуск предварительного просмотра ссылок позволяет вам определять шаблоны 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 в проекте, которая выполняется в ответ на срабатывание триггера.
Виджет
Элемент пользовательского интерфейса, например кнопка, текстовое поле или флажок. Карты создаются из последовательности объектов-виджетов, определяемых встроенным сервисом карточек 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-адресом в хост-приложении Google, например в Документах Google. Запуск предварительного просмотра ссылок позволяет вам определять шаблоны 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 в проекте, которая выполняется в ответ на срабатывание триггера.
Виджет
Элемент пользовательского интерфейса, например кнопка, текстовое поле или флажок. Карты создаются из последовательности объектов-виджетов, определяемых встроенным сервисом карточек 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-адресом в хост-приложении Google, например в Документах Google. Запуск предварительного просмотра ссылок позволяет вам определять шаблоны 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 в проекте, которая выполняется в ответ на срабатывание триггера.
Виджет
Элемент пользовательского интерфейса, например кнопка, текстовое поле или флажок. Карты создаются из последовательности объектов-виджетов, определяемых встроенным сервисом карточек Apps Script.
См. Виджеты для получения дополнительной информации.
Функция обработчика виджета
Функция, которая связывает конкретный виджет с конкретным объектом действия . Каждый тип виджета имеет набор определенных функций-обработчиков виджетов, которые он может использовать для подключения к действиям. Функции обработки виджета определяют, какой тип взаимодействия с пользователем вызывает результирующее действие, и являются важнейшим компонентом интерактивности виджета.
Дополнительные сведения см. в разделе Функции обработчика виджетов .