- Ressource: Déploiement
- AddOns
- CommonAddOnManifest
- LayoutProperties
- AddOnWidgetSet
- WidgetType
- HomepageExtensionPoint
- UniversalActionExtensionPoint
- GmailAddOnManifest
- ContextualTrigger
- UnconditionalTrigger
- UniversalAction
- ComposeTrigger
- MenuItemExtensionPoint
- DraftAccess
- DriveAddOnManifest
- DriveExtensionPoint
- CalendarAddOnManifest
- ConferenceSolution
- CalendarExtensionPoint
- EventAccess
- DocsAddOnManifest
- DocsExtensionPoint
- LinkPreviewExtensionPoint
- UriPattern
- CreateActionExtensionPoint
- SheetsAddOnManifest
- SheetsExtensionPoint
- SlidesAddOnManifest
- SlidesExtensionPoint
- HttpOptions
- HttpAuthorizationHeader
- Méthodes
Ressource: Déploiement
Un déploiement de module complémentaire Google Workspace
Représentation JSON |
---|
{
"name": string,
"oauthScopes": [
string
],
"addOns": {
object ( |
Champs | |
---|---|
name |
Nom de la ressource de déploiement. Exemple : |
oauth |
Liste des habilitations OAuth Google pour lesquelles demander le consentement de l'utilisateur final avant d'exécuter un point de terminaison de module complémentaire. |
add |
Configuration du module complémentaire Google Workspace. |
etag |
Cette valeur est calculée par le serveur en fonction de la version du déploiement dans l'espace de stockage. Elle peut être envoyée lors des requêtes de mise à jour et de suppression pour s'assurer que le client dispose d'une valeur à jour avant de continuer. |
AddOns
Configuration d'un module complémentaire Google Workspace
Représentation JSON |
---|
{ "common": { object ( |
Champs | |
---|---|
common |
Configuration commune à tous les modules complémentaires Google Workspace. |
gmail |
Configuration du module complémentaire Gmail. |
drive |
Configuration du module complémentaire Drive. |
calendar |
Configuration du module complémentaire Agenda. |
docs |
Configuration du module complémentaire Docs. |
sheets |
Configuration du module complémentaire Sheets. |
slides |
Configuration du module complémentaire Slides. |
http |
Options d'envoi de requêtes aux points de terminaison HTTP des modules complémentaires |
CommonAddOnManifest
Configuration du module complémentaire partagée entre toutes les applications hôtes du module complémentaire.
Représentation JSON |
---|
{ "name": string, "logoUrl": string, "layoutProperties": { object ( |
Champs | |
---|---|
name |
Obligatoire. Nom à afficher du module complémentaire. |
logo |
Obligatoire. URL de l'image du logo affichée dans la barre d'outils du module complémentaire. |
layout |
Propriétés de mise en page courantes pour les fiches de modules complémentaires. |
add |
Widgets utilisés dans le module complémentaire Si ce champ n'est pas spécifié, l'ensemble par défaut est utilisé. |
use |
Indique si les informations de paramètres régionaux doivent être transmises depuis l'application hôte. |
homepage |
Définit un point de terminaison qui sera exécuté dans n'importe quel contexte, sur n'importe quel hôte. Toutes les cartes générées par cette fonction sont toujours disponibles pour l'utilisateur, mais elles peuvent être éclipsées par du contenu contextuel lorsque ce module complémentaire déclare des déclencheurs plus ciblés. |
universal |
Définit une liste de points d'extension dans le menu d'action universel, qui sert de menu de paramètres pour le module complémentaire. Le point d'extension peut être une URL de lien à ouvrir ou un point de terminaison à exécuter en tant qu'envoi de formulaire. |
open |
Une action OpenLink ne peut utiliser qu'une URL avec un schéma |
LayoutProperties
Propriétés de mise en page des cartes partagées entre toutes les applications hôtes des modules complémentaires.
Représentation JSON |
---|
{ "primaryColor": string, "secondaryColor": string, "useNewMaterialDesign": boolean } |
Champs | |
---|---|
primary |
Couleur principale du module complémentaire. Il définit la couleur de la barre d'outils. Si aucune couleur primaire n'est définie, la valeur par défaut fournie par le framework est utilisée. |
secondary |
Couleur secondaire du module complémentaire. Il définit la couleur des boutons. Si la couleur primaire est définie, mais qu'aucune couleur secondaire n'est définie, la couleur secondaire est identique à la couleur primaire. Si aucune couleur primaire ni secondaire n'est définie, la valeur par défaut fournie par le framework est utilisée. |
use |
Active Material Design pour les fiches. |
AddOnWidgetSet
Sous-ensemble de widgets utilisé par un module complémentaire.
Représentation JSON |
---|
{
"usedWidgets": [
enum ( |
Champs | |
---|---|
used |
Liste des widgets utilisés dans un module complémentaire. |
WidgetType
Type de widget. WIDGET_TYPE_UNSPECIFIED
est l'ensemble de widgets de base.
Enums | |
---|---|
WIDGET_TYPE_UNSPECIFIED |
Ensemble de widgets par défaut. |
DATE_PICKER |
Sélecteur de date. |
STYLED_BUTTONS |
Les boutons stylisés incluent les boutons remplis et les boutons désactivés. |
PERSISTENT_FORMS |
Les formulaires persistants permettent de conserver les valeurs des formulaires lors des actions. |
FIXED_FOOTER |
Correction du pied de page dans une fiche. |
UPDATE_SUBJECT_AND_RECIPIENTS |
modifier l'objet et les destinataires d'un brouillon ; |
GRID_WIDGET |
Widget de grille. |
ADDON_COMPOSE_UI_ACTION |
Action de module complémentaire Gmail qui s'applique à l'UI de rédaction du module complémentaire. |
HomepageExtensionPoint
Format courant pour déclarer la vue de la page d'accueil d'un module complémentaire.
Représentation JSON |
---|
{ "runFunction": string, "enabled": boolean } |
Champs | |
---|---|
run |
Obligatoire. Point de terminaison à exécuter lorsque ce point d'extension est activé. |
enabled |
Facultatif. Si la valeur est définie sur La valeur par défaut est Si la vue de la page d'accueil personnalisée d'un module complémentaire est désactivée, une fiche d'aperçu générique est fournie aux utilisateurs à la place. |
UniversalActionExtensionPoint
Format pour déclarer un point d'extension d'élément de menu d'action universel.
Représentation JSON |
---|
{ "label": string, // Union field |
Champs | |
---|---|
label |
Obligatoire. Texte visible par l'utilisateur qui décrit l'action effectuée en activant ce point d'extension (par exemple, "Ajouter un contact"). |
Champ d'union action_type . Obligatoire. Type d'action compatible avec un élément de menu d'action universel. Il peut s'agir d'un lien à ouvrir ou d'un point de terminaison à exécuter. action_type ne peut être qu'un des éléments suivants : |
|
open |
URL à ouvrir par l'action universelle. |
run |
Point de terminaison à exécuter par UniversalAction. |
GmailAddOnManifest
Propriétés permettant de personnaliser l'apparence et l'exécution d'un module complémentaire Gmail.
Représentation JSON |
---|
{ "homepageTrigger": { object ( |
Champs | |
---|---|
homepage |
Définit un point de terminaison qui sera exécuté dans les contextes qui ne correspondent pas à un déclencheur contextuel déclaré. Toutes les fiches générées par cette fonction sont toujours disponibles pour l'utilisateur, mais elles peuvent être éclipsées par du contenu contextuel lorsque ce module complémentaire déclare des déclencheurs plus ciblés. Si ce paramètre est présent, il remplace la configuration de |
contextual |
Définit l'ensemble de conditions qui déclenchent le module complémentaire. |
universal |
Définit un ensemble d'actions universelles pour le module complémentaire. L'utilisateur déclenche des actions universelles à partir du menu de la barre d'outils du module complémentaire. |
compose |
Définit le déclencheur de l'heure de composition pour un module complémentaire de l'heure de composition. Il s'agit du déclencheur qui permet à un module complémentaire d'effectuer une action lorsque l'utilisateur rédige un e-mail. Tous les modules complémentaires de temps de composition doivent avoir la portée |
authorization |
Nom d'un point de terminaison qui vérifie que le module complémentaire dispose de toutes les autorisations tierces requises en interrogeant les API tierces. Si la sonde échoue, la fonction doit générer une exception pour lancer le flux d'autorisation. Cette fonction est appelée avant chaque appel du module complémentaire afin de garantir une expérience utilisateur fluide. |
ContextualTrigger
Définit un déclencheur qui se déclenche lorsque l'e-mail ouvert répond à des critères spécifiques. Lorsque le déclencheur se déclenche, il exécute un point de terminaison spécifique, généralement pour créer des fiches et mettre à jour l'UI.
Représentation JSON |
---|
{ "onTriggerFunction": string, // Union field |
Champs | |
---|---|
on |
Obligatoire. Nom du point de terminaison à appeler lorsqu'un message correspond au déclencheur. |
Champ d'union trigger . Le type de déclencheur détermine les conditions que Gmail utilise pour afficher le module complémentaire. trigger ne peut être qu'un des éléments suivants : |
|
unconditional |
Les déclencheurs inconditionnels sont exécutés lorsqu'un message est ouvert. |
UnconditionalTrigger
Ce type ne comporte aucun champ.
Déclencheur qui se déclenche lorsqu'un e-mail est ouvert.
UniversalAction
Action toujours disponible dans le menu de la barre d'outils du module complémentaire, quel que soit le contexte du message.
Représentation JSON |
---|
{ "text": string, // Union field |
Champs | |
---|---|
text |
Obligatoire. Texte visible par l'utilisateur décrivant l'action, par exemple "Ajouter un contact". |
Champ d'union action_type . Le type d'action détermine le comportement de Gmail lorsque l'utilisateur l'invoque. action_type ne peut être qu'un des éléments suivants : |
|
open |
Lien ouvert par Gmail lorsque l'utilisateur déclenche l'action. |
run |
Point de terminaison appelé lorsque l'utilisateur déclenche l'action. Pour en savoir plus, consultez le guide des actions universelles. |
ComposeTrigger
Déclencheur qui s'active lorsque l'utilisateur rédige un e-mail.
Représentation JSON |
---|
{ "actions": [ { object ( |
Champs | |
---|---|
actions[] |
Définit l'ensemble d'actions d'un module complémentaire de composition. Il s'agit d'actions que les utilisateurs peuvent déclencher sur un module complémentaire au moment de la rédaction. |
draft |
Définit le niveau d'accès aux données lorsqu'un module complémentaire de composition est déclenché. |
MenuItemExtensionPoint
Format courant pour déclarer un élément de menu ou un bouton qui s'affiche dans une application hôte.
Représentation JSON |
---|
{ "runFunction": string, "label": string, "logoUrl": string } |
Champs | |
---|---|
run |
Obligatoire. Point de terminaison à exécuter lorsque ce point d'extension est activé. |
label |
Obligatoire. Texte visible par l'utilisateur qui décrit l'action effectuée en activant ce point d'extension. (par exemple, "Insérer la facture"). |
logo |
URL de l'image du logo affichée dans la barre d'outils du module complémentaire. Si ce champ n'est pas défini, la valeur par défaut est l'URL du logo principal du module complémentaire. |
DraftAccess
Énumération qui définit le niveau d'accès aux données requis par le déclencheur de composition.
Enums | |
---|---|
UNSPECIFIED |
Valeur par défaut lorsque rien n'est défini pour "draftaccess". |
NONE |
Le déclencheur de composition ne peut pas accéder aux données du brouillon lorsqu'un module complémentaire de composition est déclenché. |
METADATA |
Accorde au déclencheur de composition l'autorisation d'accéder aux métadonnées du brouillon lorsqu'un module complémentaire de composition est déclenché. Cela inclut la liste des destinataires, comme la liste "À" et "Cc" d'un brouillon de message. |
DriveAddOnManifest
Propriétés permettant de personnaliser l'apparence et l'exécution d'un module complémentaire Drive.
Représentation JSON |
---|
{ "homepageTrigger": { object ( |
Champs | |
---|---|
homepage |
Si ce paramètre est présent, il remplace la configuration de |
on |
Correspond au comportement qui s'exécute lorsque des éléments sont sélectionnés dans la vue Drive appropriée, comme la liste de documents Mon Drive. |
DriveExtensionPoint
Format courant pour déclarer les déclencheurs d'un module complémentaire Drive.
Représentation JSON |
---|
{ "runFunction": string } |
Champs | |
---|---|
run |
Obligatoire. Point de terminaison à exécuter lorsque le point d'extension est activé. |
CalendarAddOnManifest
Propriétés permettant de personnaliser l'apparence et l'exécution d'un module complémentaire Agenda.
Représentation JSON |
---|
{ "homepageTrigger": { object ( |
Champs | |
---|---|
homepage |
Définit un point de terminaison qui s'exécute dans des contextes qui ne correspondent pas à un déclencheur contextuel déclaré. Toutes les cartes générées par cette fonction sont toujours disponibles pour l'utilisateur, mais elles peuvent être éclipsées par du contenu contextuel lorsque ce module complémentaire déclare des déclencheurs plus ciblés. Si ce paramètre est présent, il remplace la configuration de |
conference |
Définit les solutions de conférence fournies par ce module complémentaire. Les modules complémentaires de visioconférence tiers ne peuvent être créés que dans Apps Script. |
create |
Point de terminaison à exécuter qui crée une URL vers la page des paramètres du module complémentaire. |
event |
Point de terminaison qui se déclenche lorsqu'un événement est ouvert pour être consulté ou modifié. |
event |
Point de terminaison déclenché lorsque l'événement d'ouverture est mis à jour. |
event |
Configuration d'un déclencheur contextuel qui se déclenche lorsque l'utilisateur clique sur le fournisseur d'attachement du module complémentaire dans le menu déroulant d'Agenda. |
current |
Définit le niveau d'accès aux données lorsqu'un module complémentaire d'événement est déclenché. |
ConferenceSolution
Définit les valeurs liées à la conférence. Les modules complémentaires de visioconférence tiers ne peuvent être créés que dans Apps Script.
Représentation JSON |
---|
{ "onCreateFunction": string, "id": string, "name": string, "logoUrl": string } |
Champs | |
---|---|
on |
Obligatoire. Point de terminaison à appeler lorsque les données de la conférence doivent être créées. |
id |
Obligatoire. Les ID doivent être attribués de manière unique aux solutions de conférence d'un même module complémentaire. Sinon, la mauvaise solution de conférence risque d'être utilisée lorsque le module complémentaire est déclenché. Vous pouvez modifier le nom à afficher d'un module complémentaire, mais pas son ID. |
name |
Obligatoire. Nom à afficher de la solution de conférence. |
logo |
Obligatoire. URL de l'image du logo de la solution de conférence. |
CalendarExtensionPoint
Format courant pour déclarer les déclencheurs d'un module complémentaire d'agenda.
Représentation JSON |
---|
{ "runFunction": string } |
Champs | |
---|---|
run |
Obligatoire. Point de terminaison à exécuter lorsque ce point d'extension est activé. |
EventAccess
Enumération qui définit le niveau d'accès aux données requis par les déclencheurs d'événements.
Enums | |
---|---|
UNSPECIFIED |
Valeur par défaut lorsque rien n'est défini pour eventAccess. |
METADATA |
Accorde aux déclencheurs d'événements l'autorisation d'accéder aux métadonnées des événements, telles que l'ID de l'événement et l'ID de l'agenda. |
READ |
Accorde aux déclencheurs d'événements un accès à tous les champs d'événement fournis, y compris les métadonnées, les participants et les données de conférence. |
WRITE |
Accorde aux déclencheurs d'événements l'accès aux métadonnées des événements et la possibilité d'effectuer toutes les actions, y compris ajouter des participants et définir des données de conférence. |
READ_WRITE |
Accorde aux déclencheurs d'événements un accès à tous les champs d'événement fournis, y compris les métadonnées, les participants et les données de conférence, et la possibilité d'effectuer toutes les actions. |
DocsAddOnManifest
Propriétés permettant de personnaliser l'apparence et l'exécution d'un module complémentaire Google Docs.
Représentation JSON |
---|
{ "homepageTrigger": { object ( |
Champs | |
---|---|
homepage |
Si ce paramètre est présent, il remplace la configuration de |
on |
Point de terminaison à exécuter lorsqu'une autorisation de portée de fichier est accordée pour cette paire document/utilisateur. |
link |
Liste des points d'extension permettant de prévisualiser des liens dans un document Google Docs. Pour en savoir plus, consultez Prévisualiser des liens avec des chips intelligents. |
create |
Liste des points d'extension permettant de créer des ressources tierces à partir des applications Google Workspace. Pour en savoir plus, consultez Créer des ressources tierces à partir du menu @. |
DocsExtensionPoint
Format courant pour déclarer les déclencheurs d'un module complémentaire Docs.
Représentation JSON |
---|
{ "runFunction": string } |
Champs | |
---|---|
run |
Obligatoire. Point de terminaison à exécuter lorsque ce point d'extension est activé. |
LinkPreviewExtensionPoint
Configuration d'un déclencheur qui se déclenche lorsqu'un utilisateur saisit ou colle un lien provenant d'un service tiers ou non Google dans un fichier Google Docs, Sheets ou Slides.
Représentation JSON |
---|
{
"labelText": string,
"localizedLabelText": {
string: string,
...
},
"patterns": [
{
object ( |
Champs | |
---|---|
label |
Obligatoire. Texte d'un exemple de chip intelligent qui invite les utilisateurs à prévisualiser le lien, par exemple |
localized |
Facultatif. Carte de Si les paramètres régionaux d'un utilisateur sont présents dans les clés de la carte, la version localisée de Objet contenant une liste de paires |
patterns[] |
Obligatoire. Tableau d'éléments de format d'URL qui déclenchent l'aperçu des liens par le module complémentaire. |
run |
Obligatoire. Point de terminaison à exécuter lorsqu'un aperçu de lien est déclenché. |
logo |
Facultatif. Icône qui s'affiche dans le chip intelligent et la fiche d'aperçu. Si cet élément n'est pas spécifié, le module complémentaire utilise son icône de barre d'outils, |
UriPattern
Configuration de chaque format d'URL qui déclenche un aperçu de lien.
Représentation JSON |
---|
{ "hostPattern": string, "pathPrefix": string } |
Champs | |
---|---|
host |
Obligatoire pour chaque format d'URL à prévisualiser. Domaine du format d'URL. Le module complémentaire prévisualise les liens qui contiennent ce domaine dans l'URL. Pour prévisualiser les liens d'un sous-domaine spécifique, comme Par exemple, |
path |
Facultatif. Chemin d'accès qui ajoute le domaine de l' Par exemple, si le format d'hôte d'URL est Pour faire correspondre toutes les URL du domaine du format d'hôte, laissez |
CreateActionExtensionPoint
Configuration d'un déclencheur qui se déclenche lorsqu'un utilisateur appelle le workflow de création de ressources dans une application Google Workspace. Pour en savoir plus, consultez Créer des ressources tierces à partir du menu @.
Représentation JSON |
---|
{ "id": string, "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string } |
Champs | |
---|---|
id |
Obligatoire. Identifiant unique permettant de différencier ce point d'extension. L'ID peut comporter jusqu'à 64 caractères et doit être au format |
label |
Obligatoire. Texte qui s'affiche à côté d'une icône pour le point d'entrée de création de ressources, par exemple |
localized |
Facultatif. Carte de Si les paramètres régionaux d'un utilisateur sont présents dans les clés de la carte, la version localisée de Objet contenant une liste de paires |
run |
Obligatoire. Point de terminaison à exécuter lorsqu'un workflow de création de ressources est déclenché pour créer un lien. |
logo |
Facultatif. Icône affichée pour le point d'entrée de la création de ressources. Si vous ne spécifiez pas cet élément, le menu utilise l'icône de la barre d'outils de votre module complémentaire, |
SheetsAddOnManifest
Propriétés permettant de personnaliser l'apparence et l'exécution d'un module complémentaire Google Sheets.
Représentation JSON |
---|
{ "homepageTrigger": { object ( |
Champs | |
---|---|
homepage |
Si ce paramètre est présent, il remplace la configuration de |
on |
Point de terminaison à exécuter lorsqu'une autorisation de portée de fichier est accordée pour cette paire document/utilisateur. |
link |
Liste des points d'extension permettant de prévisualiser des liens dans un document Google Sheets. Pour en savoir plus, consultez Prévisualiser des liens avec des chips intelligents. |
SheetsExtensionPoint
Format courant pour déclarer les déclencheurs d'un module complémentaire Sheets.
Représentation JSON |
---|
{ "runFunction": string } |
Champs | |
---|---|
run |
Obligatoire. Point de terminaison à exécuter lorsque ce point d'extension est activé. |
SlidesAddOnManifest
Propriétés permettant de personnaliser l'apparence et l'exécution d'un module complémentaire Google Slides.
Représentation JSON |
---|
{ "homepageTrigger": { object ( |
Champs | |
---|---|
homepage |
Si ce paramètre est présent, il remplace la configuration de |
on |
Point de terminaison à exécuter lorsqu'une autorisation de portée de fichier est accordée pour cette paire document/utilisateur. |
link |
Liste des points d'extension permettant de prévisualiser des liens dans un document Google Slides. Pour en savoir plus, consultez Prévisualiser des liens avec des chips intelligents. |
SlidesExtensionPoint
Format courant pour déclarer les déclencheurs d'un module complémentaire Slides.
Représentation JSON |
---|
{ "runFunction": string } |
Champs | |
---|---|
run |
Obligatoire. Point de terminaison à exécuter lorsque ce point d'extension est activé. |
HttpOptions
Options permettant d'envoyer des requêtes aux points de terminaison HTTP
des modules complémentaires.
Représentation JSON |
---|
{
"authorizationHeader": enum ( |
Champs | |
---|---|
authorization |
Configuration du jeton envoyé dans l'en-tête d'autorisation |
HttpAuthorizationHeader
En-tête d'autorisation envoyé dans les requêtes HTTP
du module complémentaire.
Enums | |
---|---|
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED |
Valeur par défaut, équivalente à SYSTEM_ID_TOKEN . |
SYSTEM_ID_TOKEN |
Envoyez un jeton d'identification pour le compte de service système du module complémentaire Google Workspace spécifique au projet (par défaut). |
USER_ID_TOKEN |
Envoyez un jeton d'ID pour l'utilisateur final. |
NONE |
N'envoyez pas d'en-tête d'authentification. |
Méthodes |
|
---|---|
|
Crée un déploiement avec le nom et la configuration spécifiés. |
|
Supprime le déploiement portant le nom indiqué. |
|
Récupère le déploiement portant le nom spécifié. |
|
Récupère l'état d'installation d'un déploiement de test. |
|
Installe un déploiement dans votre compte à des fins de test. |
|
Répertorie tous les déploiements d'un projet particulier. |
|
Crée ou remplace un déploiement avec le nom spécifié. |
|
Désinstalle une déploiement de test du compte de l'utilisateur. |