Ressource de fichier manifeste de l'éditeur

Configuration de la ressource utilisée pour définir le contenu et le comportement des modules complémentaires Google Workspace dans les éditeurs. Les fichiers manifestes des modules complémentaires Google Workspace doivent inclure tous les composants marqués comme Obligatoires s'ils étendent l'éditeur.

Éditeurs

Configuration du fichier manifeste du module complémentaire Google Workspace pour les extensions d'éditeur. Pour en savoir plus, consultez Étendre les éditeurs avec des modules complémentaires Google Workspace.

Représentation JSON
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
Champs
homepageTrigger

object (HomepageTrigger)

Cette fonction de déclencheur crée la page d'accueil du module complémentaire dans l'application hôte. Elle remplace addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Obligatoire si le module complémentaire inclut un comportement spécifique au document actuel, déclenché lorsque l'utilisateur autorise le drive.file champ d'application.

linkPreviewTriggers[]

object (LinkPreviewTriggers)

Obligatoire pour les aperçus de liens. Liste des déclencheurs permettant de prévisualiser des liens dans un fichier Google Docs, Sheets ou Slides. Pour en savoir plus, consultez Prévisualiser des liens avec des chips intelligents.

createActionTriggers[]

object (createActionTriggers)

Obligatoire pour la création de ressources tierces. Liste des déclencheurs permettant de créer des ressources dans un service tiers à partir du menu @. Pour en savoir plus, consultez Créer des ressources tierces avec des chips intelligents.

OnFileScopeGrantedTrigger

Configuration d'un déclencheur contextuel qui se déclenche lorsque la boîte de dialogue du champ d'application du fichier de requête utilise CardService.newEditorFileScopeActionResponseBuilder().requestFileScopeForActiveDocument().build(); et que l'utilisateur accorde l'autorisation du champ d'application drive.file.

Représentation JSON
{
  "runFunction": string
}
Champs
runFunction

string

Nom de la fonction à exécuter si le champ d'application drive.file est accordé. La fonction doit renvoyer un tableau de Card objets pour l'interface utilisateur.

LinkPreviewTriggers

Configuration d'un déclencheur qui se déclenche lorsqu'un utilisateur saisit ou colle un lien provenant d'un service tiers dans un fichier Docs, Sheets ou Slides.

Pour configurer ce déclencheur pour un module complémentaire Google Workspace, consultez Prévisualiser des liens avec des chips intelligents.

Représentation JSON
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
Champs
labelText

string

Obligatoire. Texte d'un exemple de chip intelligent invitant les utilisateurs à prévisualiser le lien, par exemple Example: Support case. Ce texte est statique.
localizedLabelText

map (key: string, value: string)

Facultatif. Mappage de labelText à localiser dans d'autres langues. Mettez en forme la langue au format ISO 639 et le pays/la région au format ISO 3166, séparés par un trait d'union -.
patterns[]

object (UriPattern)

Obligatoire. Tableau de formats d'URL qui déclenchent la prévisualisation des liens par le module complémentaire.
runFunction

string

Obligatoire. Nom de la fonction à exécuter lorsque l'utilisateur autorise le https://www.googleapis.com/auth/workspace.linkpreview champ d'application. La fonction doit accepter un objet d'événement, qui inclut une matchedUrl.url propriété contenant l'URL à prévisualiser, et renvoyer un Card objet.
logoUrl

string

Facultatif. Icône affichée dans le chip intelligent et la fiche d'aperçu. Si elle est omise, le module complémentaire utilise l'icône de sa barre d'outils, logoUrl.

UriPattern

Configuration de chaque format d'URL qui déclenche un aperçu de lien.

Représentation JSON
{
  "hostPattern": string,
  "pathPrefix" : string
}
Champs
hostPattern

string

Obligatoire pour chaque format d'URL. Domaine du format d'URL. Le module complémentaire prévisualise les liens contenant ce domaine. Pour correspondre à tous les sous-domaines, utilisez un caractère générique astérisque (*).
pathPrefix

string

Facultatif. Chemin d'accès ajoutant le domaine. Pour correspondre à toutes les URL du domaine, laissez pathPrefix vide.

CreateActionTriggers

Configuration d'un déclencheur qui se déclenche lorsqu'un utilisateur sélectionne un élément de menu d'intégration tiers dans le menu @ de Google Docs.

Pour configurer ce déclencheur pour un module complémentaire Google Workspace, consultez Créer des ressources tierces avec des chips intelligents.

Représentation JSON
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
Champs
id

string

Obligatoire. ID unique de ce point d'extension. Utilisez jusqu'à 64 caractères au format [a-zA-Z0-9-]+..
labelText

string

Obligatoire. Texte affiché dans le menu @, par exemple Create support case.
localizedLabelText

map (key: string, value: string)

Facultatif. Mappage de labelText à localiser. Mettez en forme la langue au format ISO 639 et le pays/la région au format ISO 3166, séparés par un trait d'union -.
runFunction

string

Obligatoire. Nom de la fonction à exécuter lorsqu'un utilisateur sélectionne un point d'extension. La fonction doit renvoyer une fiche de formulaire.
logoUrl

string

Facultatif. Icône affichée dans le menu @. Si elle est omise, le module complémentaire utilise l'icône de sa barre d'outils, logoUrl.