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

Ресурс манифеста редактора

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

Редакторы

Конфигурация манифеста надстройки Google Workspace для расширений Редактора. Дополнительную информацию см. в разделе Расширение редакторов с помощью надстроек Google Workspace .

JSON-представление
{ "homepageTrigger": { object (HomepageTrigger) }, "onFileScopeGrantedTrigger": { object (OnFileScopeGrantedTrigger) }, "linkPreviewTriggers": [ { object (LinkPreviewTriggers) } ], "createActionTriggers": [ { object (CreateActionTriggers) } }

JSON-представление

  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }

Поля
`homepageTrigger`	`object ( HomepageTrigger )` Эта триггерная функция создает домашнюю страницу надстройки в ведущем приложении. Это переопределяет `addOns.common.homepageTrigger` .
`onFileScopeGrantedTrigger`	`object ( OnFileScopeGrantedTrigger )` Требуется, если ваша надстройка включает поведение, специфичное для текущего документа Редактора, которое активируется, когда пользователь авторизует область `drive.file` .
`linkPreviewTriggers[]`	`object ( LinkPreviewTriggers )` Требуется для предварительного просмотра ссылок. Список триггеров для предварительного просмотра ссылок в файлах Google Docs, Sheets или Slides. Подробности см. в разделе Предварительный просмотр ссылок со смарт-чипами .
`createActionTriggers[]`	`object ( createActionTriggers )` Требуется для создания стороннего ресурса. Список триггеров для создания ресурсов в стороннем сервисе из меню @. Подробности см. в разделе Создание сторонних ресурсов с помощью смарт-чипов .

Онфилескопегрантедтриггер

Конфигурация контекстного триггера, который срабатывает, когда в диалоговом окне области запроса файла используется CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); и пользователь предоставляет авторизацию в области drive.file .

JSON-представление
{ "runFunction": string }

Поля

Поля
`runFunction`	`string` Имя функции, которая будет выполняться, если предоставлена область действия `drive.file` . Если указано, вы должны реализовать эту функцию для создания и возврата массива объектов `Card` для отображения в пользовательском интерфейсе надстройки.

runFunction

string

Имя функции, которая будет выполняться, если предоставлена область действия drive.file . Если указано, вы должны реализовать эту функцию для создания и возврата массива объектов Card для отображения в пользовательском интерфейсе надстройки.

СсылкаПредварительный просмотрТриггеры

Конфигурация триггера, который срабатывает, когда пользователь вводит или вставляет ссылку из сторонней или сторонней службы Google в файл Документов, Таблиц или Презентаций.

Чтобы настроить этот триггер для надстройки Google Workspace, см. раздел Предварительный просмотр ссылок со смарт-чипами .

JSON-представление
{ "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string, "patterns": [ { object(patterns) } ] }

Поля
`labelText`	`string` Необходимый. Текст примера смарт-чипа, предлагающий пользователям просмотреть ссылку, например `Example: Support case` . Этот текст является статическим и отображается до того, как пользователи запустят надстройку.
`localizedLabelText`	`map (key: string, value: string)` Необязательный. Карта `labelText` для локализации на другие языки. Отформатируйте язык в формате ISO 639 и страну/регион в формате ISO 3166 , разделив их дефисом `-` . Например, `en-US` . Если локаль пользователя присутствует в ключах карты, пользователь видит локализованную версию `labelText` .
`patterns[]`	`object ( UriPattern )` Необходимый. Массив шаблонов URL-адресов, которые запускают надстройку для предварительного просмотра ссылок.
`runFunction`	`string` Необходимый. Имя функции, которая будет запускаться, когда пользователь авторизует область `https://www.googleapis.com/auth/workspace.linkpreview` . Если указано, вы должны реализовать эту функцию, чтобы принять объект события, содержащий `EDITOR_NAME .matchedUrl.url` в качестве аргумента, и вернуть один объект `Card` , который отображает предварительный просмотр ссылки в пользовательском интерфейсе надстройки.
`logoUrl`	`string` Необязательный. Значок, который отображается на смарт-чипе и карте предварительного просмотра. Если этот параметр опущен, надстройка использует значок на панели инструментов `logoUrl` .

Урипаттерн

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

JSON-представление
{ "hostPattern": string, "pathPrefix" : string }

Поля

Поля
`hostPattern`	`string` Требуется для предварительного просмотра каждого шаблона URL. Домен шаблона URL. Надстройка просматривает ссылки, содержащие этот домен в URL-адресе. Чтобы просмотреть ссылки для определенного субдомена, например `subdomain.example.com` , включите субдомен. Чтобы просмотреть ссылки для всего домена, укажите в качестве поддомена подстановочный знак со звездочкой ( `` ). Например, `.example.com` соответствует `subdomain.example.com` `another.subdomain.example.com` .
`pathPrefix`	`string` Необязательный. Путь, по которому добавляется домен `hostPattern` . Например, если шаблон хоста URL-адреса — `support.example.com` , для сопоставления URL-адресов обращений, размещенных по адресу `support.example.com/cases/` , используйте `cases` . Чтобы сопоставить все URL-адреса в домене шаблона хоста, оставьте `pathPrefix` пустым.

hostPattern

string

Требуется для предварительного просмотра каждого шаблона URL. Домен шаблона URL. Надстройка просматривает ссылки, содержащие этот домен в URL-адресе. Чтобы просмотреть ссылки для определенного субдомена, например subdomain.example.com , включите субдомен. Чтобы просмотреть ссылки для всего домена, укажите в качестве поддомена подстановочный знак со звездочкой ( * ).

Например, *.example.com соответствует subdomain.example.com another.subdomain.example.com .

pathPrefix

string

Необязательный. Путь, по которому добавляется домен hostPattern .

Например, если шаблон хоста URL-адреса — support.example.com , для сопоставления URL-адресов обращений, размещенных по адресу support.example.com/cases/ , используйте cases .

Чтобы сопоставить все URL-адреса в домене шаблона хоста, оставьте pathPrefix пустым.

CreateActionTriggers

Конфигурация триггера, который срабатывает, когда пользователь выбирает пункт меню сторонней интеграции в меню @ Документов Google.

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

JSON-представление
{ "id": string, "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string, }

Поля
`id`	`string` Необходимый. Уникальный идентификатор, позволяющий отличить эту точку расширения. Идентификатор может содержать до 64 символов и должен быть в формате `[a-zA-Z0-9-]+.` .
`labelText`	`string` Необходимый. Текст, который появляется в меню @, например « `Create support case` .
`localizedLabelText`	`map (key: string, value: string)` Необязательный. Карта `labelText` для локализации на другие языки. Отформатируйте язык в формате ISO 639 и страну/регион в формате ISO 3166 , разделив их дефисом `-` . Например, `en-US` . Если локаль пользователя присутствует в ключах карты, пользователь видит локализованную версию `labelText` .
`runFunction`	`string` Необходимый. Имя функции, которая будет запускаться, когда пользователь выбирает точку расширения в меню @. Функция должна возвращать карточку формы с входными данными для создания стороннего ресурса.
`logoUrl`	`string` Необязательный. Значок, который отображается в меню @. Если этот параметр опущен, надстройка использует значок на панели инструментов `logoUrl` .