AddOns Response Service

Service de réponse aux modules complémentaires

Ce service permet aux scripts de configurer et de créer des modules complémentaires Google Workspace qui étendent Google Workspace Studio.

Classes

NomBrève description
ActionAction que les modules complémentaires Google Workspace qui étendent Google Workspace Studio peuvent utiliser pour afficher une nouvelle fiche.
AddOnsResponseServiceAddOnsResponseService permet de créer des réponses pour les modules complémentaires Google Workspace qui étendent Google Workspace Studio.
BasicDataTypeÉnumération qui représente les types de données génériques de base.
ColorObjet Color représentant une couleur dans l'espace colorimétrique RVBA.
DataTypeUn DataType est utilisé pour définir le type d'une variable.
DynamicResourceDefinitionUne DynamicResourceDefinition est un élément de base pour un ResourceFieldsDefinitionRetrievedAction. Elle peut contenir un ou plusieurs nombres de ResourceField pour définir de manière dynamique le nombre de variables de sortie fournies par une étape dans Google Workspace Studio.
ErrorActionabilityÉnumération représentant l'actionnabilité de l'erreur.
ErrorRetryabilityÉnumération qui représente la possibilité de réessayer l'appel d'action en cas d'erreur.
FontWeightÉnumération représentant l'épaisseur de la police du texte stylisé.
HostAppActionHostAppAction est un type d'action géré par des applications hôtes individuelles.
HyperlinkÉlément Hyperlink utilisé dans TextFormatElement.
InsertSectionCompilateur pour les objets InsertSection.
InsertWidgetCompilateur pour les objets InsertWidget.
LinkObjet de lien provenant d'une ressource tierce qui est converti en chip intelligent dans l'application hôte.
ListContainerConteneur pour les éléments de liste, où chaque élément de liste peut contenir plusieurs TextFormatElement.
ListItemÉlément de liste, où chaque élément peut contenir plusieurs TextFormatElement.
ListTypeÉnumération représentant le type de liste.
ModifyCardGénérateur d'objets ModifyCard qui modifie et met à jour l'interface d'une fiche existante en transmettant l'objet ModifyCard à un Action.
NavigationObjet d'assistance qui contrôle la navigation dans les cartes.
RemoveSectionCompilateur pour les objets RemoveSection.
RemoveWidgetCompilateur pour les objets RemoveWidget.
RenderActionAffiche ou met à jour une fiche en effectuant une Action en réponse à une interaction de l'utilisateur.
RenderActionBuilderCompilateur pour les objets RenderAction.
ResourceDataReprésente des données de ressources spécifiques à une application. Les données de ressources contiennent une collection de paires clé/valeur de noms de variables et VariableData.
ResourceFieldUn ResourceField est un élément de base d'un DynamicResourceDefinition. Chaque champ de ressource correspond à une variable de sortie de l'étape actuelle.
ResourceFieldsDefinitionRetrievedActionUn ResourceFieldsDefinitionRetrievedAction est un type de ResourceFieldsDefinitionRetrievedAction qui permet de récupérer la définition d'une liste de champs de ressources via la fonction dynamicResourceDefinitionProvider spécifiée dans le fichier manifeste.
ResourceRetrievedActionUne ResourceRetrievedAction permet de récupérer le contenu d'une ressource personnalisée si nécessaire, lorsque le champ de ressource personnalisée est défini dans ResourceData.
ResourceTypeType de ressource spécifique à une application. L'identifiant unique du type de ressource doit avoir une WorkflowResourceDefinition correspondante.
ReturnElementErrorActionUne ReturnElementErrorAction indique qu'une erreur s'est produite lors de l'appel d'un élément.
ReturnOutputVariablesActionContient les variables de sortie générées par l'action exécutée dans Google Workspace Studio.
SaveWorkflowActionCette action indique que l'application hôte (Google Workspace Studio) doit enregistrer l'agent.
StyledTextÉlément de texte avec des styles tels que le gras, l'italique et la couleur.
TextFormatChipUn chip cliquable au format texte.
TextFormatElementÉlément de format de texte, qui peut être TextFormatChip, StyledText, Hyperlink ou ListContainer.
TextFormatIconIcône affichée dans un TextFormatChip.
TextStyleÉnumération représentant le style du texte mis en forme.
TimeStampReprésente un objet d'horodatage qui peut être ajouté à un VariableData.
UpdateWidgetCompilateur pour les objets UpdateWidget.
ValidationErrorSeverityÉnumération représentant la gravité de l'erreur de validation.
ValueMetadataUn objet valueMetadata contient des informations sur les valeurs potentielles d'une variable.
VariableDataReprésente des données variables pouvant contenir une collection de valeurs de différents types.
WorkflowActionWorkflowAction est un type de HostAppAction utilisé pour effectuer une action spécifique dans Google Workspace Studio.
WorkflowTextFormatBloc de texte avec des options de mise en forme enrichie, y compris des styles, des liens hypertextes et des éléments interactifs définis dans TextFormatElement.
WorkflowValidationErrorActionCette action indique que l'application hôte (Google Workspace Studio) doit afficher une erreur de validation.

Action

Méthodes

MéthodeType renvoyéBrève description
addModifyCard(modifyCard)ActionAjoute une opération ModifyCard à l'action.
addNavigation(navigation)ActionAjoute une navigation par carte à l'action.

AddOnsResponseService

Méthodes

MéthodeType renvoyéBrève description
newAction()Actioncrée un objet Action ;
newNavigation()Navigationcrée un objet Navigation ;
newRenderActionBuilder()RenderActionBuildercrée un objet RenderActionBuilder ;

BasicDataType

Propriétés

PropriétéTypeDescription
BASIC_TYPE_UNSPECIFIEDEnumValeur par défaut.
STRINGEnumChaîne de caractères.
INTEGEREnumValeur entière.
FLOATEnumNombre à virgule flottante.
TIMESTAMPEnumCode temporel au format ISO 8601.
BOOLEANEnumUne valeur booléenne.
EMAIL_ADDRESSEnumChaîne au format d'une adresse e-mail.
GOOGLE_USEREnumUtilisateur des services Google, au format "users/encoded_GAIA_ID"
FILEEnumType de fichier.
FORMATTED_TEXTEnumTexte avec une mise en forme enrichie.

Color

Méthodes

MéthodeType renvoyéBrève description
setAlpha(alpha)ColorDéfinit le composant alpha de la couleur.
setBlue(blue)ColorDéfinit le composant bleu de la couleur.
setGreen(green)ColorDéfinit le composant vert de la couleur.
setRed(red)ColorDéfinit le composant rouge de la couleur.

DataType

Méthodes

MéthodeType renvoyéBrève description
setBasicDataType(basicDataType)DataTypeDéfinit le type de données sur l'un des BasicDataType compatibles.
setResourceType(resourceType)DataTypeDéfinit le type de données sur un ResourceType personnalisé.
setValueMetadata(valueMetadata)DataTypeDéfinit le ValueMetadata, qui contient des informations liées au type de la variable.

DynamicResourceDefinition

Méthodes

MéthodeType renvoyéBrève description
addResourceField(resourceField)DynamicResourceDefinitionAjoute un champ de ressource à la définition de ressource dynamique.
setResourceId(resourceId)DynamicResourceDefinitionDéfinit l'ID de la définition de ressource dynamique. Cet ID correspond à workflowResourceDefinitionId dans le fichier manifeste.

ErrorActionability

Propriétés

PropriétéTypeDescription
ERROR_ACTIONABILITY_UNSPECIFIEDEnumNon spécifié.
NOT_ACTIONABLEEnumL'utilisateur ne peut pas résoudre l'erreur à l'aide de la fiche de configuration.
ACTIONABLEEnumL'utilisateur peut corriger l'erreur à l'aide de la fiche de configuration.

ErrorRetryability

Propriétés

PropriétéTypeDescription
RETRYABILITY_UNSPECIFIEDEnumNon spécifié.
NOT_RETRYABLEEnumL'erreur ne peut pas être corrigée. Le flux se termine après la première tentative.
RETRYABLEEnumL'erreur est récupérable. Le workflow va essayer d'exécuter l'étape jusqu'à cinq fois.

FontWeight

Propriétés

PropriétéTypeDescription
FONT_WEIGHT_UNSPECIFIEDEnumPoids standard avec une épaisseur normale.
LIGHTEnumPlus léger et moins épais.
MEDIUMEnumPoids intermédiaire entre le style clair et le style gras.
BOLDEnumPoids plus élevé et épaisseur accrue.

HostAppAction

Méthodes

MéthodeType renvoyéBrève description
setWorkflowAction(workflowAction)HostAppActionDéfinit l'action de l'application hôte sur l'action de workflow.

Méthodes

MéthodeType renvoyéBrève description
setLink(link)HyperlinkDéfinit l'URL de destination du lien hypertexte.
setText(text)HyperlinkDéfinit le texte du lien hypertexte.

InsertSection

Méthodes

MéthodeType renvoyéBrève description
insertAtTop(onCardTop)InsertSectionDéfinit l'indicateur onCardTop, qui indique si la nouvelle section doit être insérée en haut de la carte.
insertBelowSection(sectionId)InsertSectionDéfinit l'ID de la section. La nouvelle section est insérée en dessous.
setSection(section)InsertSectionDéfinit la section de carte à insérer.

InsertWidget

Méthodes

MéthodeType renvoyéBrève description
insertAboveWidget(widgetId)InsertWidgetDéfinit l'ID du widget. Le nouveau widget est inséré au-dessus du widget portant l'ID spécifié.
insertBelowWidget(widgetId)InsertWidgetDéfinit l'ID du widget. Le nouveau widget est inséré sous le widget portant l'ID spécifié.
setWidget(widget)InsertWidgetDéfinit le Widget à insérer.

Méthodes

MéthodeType renvoyéBrève description
setTitle(title)LinkDéfinit le titre du lien.
setUrl(url)LinkDéfinit l'URL du lien.

ListContainer

Méthodes

MéthodeType renvoyéBrève description
addListItem(listItem)ListContainerAjoute un élément de liste au conteneur de liste.
setListNestLevel(listLevel)ListContainerDéfinit le niveau de la liste. La valeur est de 0 pour le niveau supérieur et augmente de 1 pour chaque liste imbriquée.
setListType(listType)ListContainerDéfinit le type de liste (ordonnée ou non ordonnée).

ListItem

Méthodes

MéthodeType renvoyéBrève description
addTextFormatElement(textFormatElement)ListItemAjoute un TextFormatElement à l'élément de liste.

ListType

Propriétés

PropriétéTypeDescription
LIST_TYPE_UNSPECIFIEDEnumValeur par défaut.
ORDEREDEnumListe ordonnée.
UNORDEREDEnumListe non triée.

ModifyCard

Méthodes

MéthodeType renvoyéBrève description
setInsertSection(insertSection)ModifyCardDéfinit le InsertSection pour cet objet de fiche de modification.
setInsertWidget(insertWidget)ModifyCardDéfinit le InsertWidget pour cet objet de fiche de modification.
setRemoveSection(removeSection)ModifyCardDéfinit le RemoveSection pour cet objet de fiche de modification.
setRemoveWidget(removeWidget)ModifyCardDéfinit le RemoveWidget pour cet objet de fiche de modification.
setReplaceSection(replacementSection)ModifyCardDéfinit le CardSection de remplacement pour cet objet de modification de carte. La section de remplacement doit avoir le même ID qu'une section de carte existante.
setReplaceWidget(replacementWidget)ModifyCardDéfinit le widget de remplacement pour cet objet de carte de modification. Le widget de remplacement doit avoir le même ID qu'un widget existant.
setUpdateWidget(updateWidget)ModifyCardDéfinit le UpdateWidget pour cet objet de fiche de modification.

Méthodes

MéthodeType renvoyéBrève description
printJson()StringAffiche la représentation JSON de cet objet.
pushCard(card)NavigationTransfère la carte donnée sur la pile.

RemoveSection

Méthodes

MéthodeType renvoyéBrève description
setSectionId(sectionId)RemoveSectionDéfinit l'ID de la section à supprimer.

RemoveWidget

Méthodes

MéthodeType renvoyéBrève description
setWidgetId(widgetId)RemoveWidgetDéfinit l'ID du widget à supprimer.

RenderAction

Méthodes

MéthodeType renvoyéBrève description
printJson()StringAffiche la représentation JSON de cet objet.

RenderActionBuilder

Méthodes

MéthodeType renvoyéBrève description
build()RenderActionCrée l'action de rendu actuelle et la valide.
setAction(action)RenderActionBuilderDéfinit l'action que les modules complémentaires peuvent utiliser pour mettre à jour l'UI sur l'action de rendu.
setHostAppAction(hostAppAction)RenderActionBuilderDéfinit les HostAppAction gérés par les applications hôtes individuelles sur l'action de rendu.

ResourceData

Méthodes

MéthodeType renvoyéBrève description
addVariableData(key, value)ResourceDataAjoute un VariableData identifié par son nom de variable. Si la clé existe déjà, la valeur est remplacée.
setVariableDataMap(fields)ResourceDataDéfinit la carte des données de variables associées aux noms de variables.

ResourceField

Méthodes

MéthodeType renvoyéBrève description
setDataType(dataType)ResourceFieldDéfinit le type de données du champ et permet aux autres étapes de filtrer les variables par type lors de la sélection.
setDisplayText(displayText)ResourceFieldDéfinit la description du champ qui s'affiche pour l'utilisateur final lors de la sélection des variables dans les étapes suivantes.
setSelector(selector)ResourceFieldDéfinit une clé pour que la fonction de fournisseur fournisse la valeur lors de l'exécution de l'étape.

ResourceFieldsDefinitionRetrievedAction

Méthodes

MéthodeType renvoyéBrève description
addDynamicResourceDefinition(dynamicResourceDefinition)ResourceFieldsDefinitionRetrievedActionAjoute un DynamicResourceDefinition à l'action de récupération de la définition des champs de ressource.

ResourceRetrievedAction

Méthodes

MéthodeType renvoyéBrève description
setResourceData(resourceData)ResourceRetrievedActionDéfinit ResourceData sur l'action de récupération de la ressource pour fournir des valeurs aux champs de ressources dynamiques ou aux champs de ressources personnalisés.

ResourceType

Méthodes

MéthodeType renvoyéBrève description
setWorkflowResourceDefinitionId(resourceType)ResourceTypeDéfinit l'ID de définition de ressource de workflow.

ReturnElementErrorAction

Méthodes

MéthodeType renvoyéBrève description
setErrorActionability(errorActionability)ReturnElementErrorActionDéfinit l'actionnabilité de l'erreur. Une erreur doit être actionable si elle peut être résolue en reconfigurant l'étape.
setErrorLog(log)ReturnElementErrorActionDéfinit le journal des erreurs à afficher à l'utilisateur final dans le flux d'activité du workflow.
setErrorRetryability(errorRetryability)ReturnElementErrorActionDéfinit la possibilité de nouvelle tentative en cas d'erreur. Le flux se termine après la première tentative si une erreur ne peut pas faire l'objet d'une nouvelle tentative.

ReturnOutputVariablesAction

Méthodes

MéthodeType renvoyéBrève description
addVariableData(key, value)ReturnOutputVariablesActionAjoute une variable de données indexée par son nom de variable. Une valeur est écrasée si la clé existe déjà.
setLog(log)ReturnOutputVariablesActionDéfinit le journal de l'action de workflow exécutée pour l'utilisateur final dans le flux d'activité du workflow.
setVariableDataMap(variables)ReturnOutputVariablesActionDéfinit le mappage des données de variables identifiées par le nom de la variable. Une valeur est écrasée si la clé existe déjà.

SaveWorkflowAction

StyledText

Méthodes

MéthodeType renvoyéBrève description
addStyle(style)StyledTextDéfinit le style du texte stylisé. Plusieurs styles peuvent être appliqués à un même texte stylisé.
setColor(color)StyledTextDéfinit la couleur du texte stylisé.
setFontWeight(fontWeight)StyledTextDéfinit l'épaisseur de la police du texte stylisé.
setText(text)StyledTextDéfinit le contenu principal du texte stylisé.

TextFormatChip

Méthodes

MéthodeType renvoyéBrève description
setLabel(label)TextFormatChipDéfinit le texte affiché dans le chip.
setTextFormatIcon(icon)TextFormatChipDéfinit l'icône affichée dans le chip.
setUrl(url)TextFormatChipDéfinit l'URL vers laquelle rediriger l'utilisateur lorsqu'il clique sur le chip.

TextFormatElement

Méthodes

MéthodeType renvoyéBrève description
setHyperlink(hyperlink)TextFormatElementDéfinit l'élément de format de texte comme Hyperlink.
setListContainer(listContainer)TextFormatElementDéfinit l'élément de format de texte comme ListContainer.
setStyledText(styledText)TextFormatElementDéfinit l'élément de format de texte comme StyledText.
setText(text)TextFormatElementDéfinit l'élément de format de texte en tant que chaîne de texte.
setTextFormatChip(chip)TextFormatElementDéfinit l'élément de format de texte comme TextFormatChip.

TextFormatIcon

Méthodes

MéthodeType renvoyéBrève description
setIconUrl(iconUrl)TextFormatIconDéfinit l'URL de l'icône.
setMaterialIconName(materialIconName)TextFormatIconDéfinit le nom de l'icône Material défini dans Google Material Icons.

TextStyle

Propriétés

PropriétéTypeDescription
STYLE_UNSPECIFIEDEnumAucun style appliqué.
ITALICEnumStyle italique.
UNDERLINEEnumStyle de soulignement.
STRIKETHROUGHEnumStyle barré.
LINE_BREAKEnumSaut de ligne.
UPPERCASEEnumStyle en majuscules.
CODEEnumStyle de code.
CODE_BLOCKEnumStyle du bloc de code.

TimeStamp

Méthodes

MéthodeType renvoyéBrève description
setNanos(nanos)TimeStampDéfinit les nanosecondes du code temporel. Il s'agit du nombre de nanosecondes dans la seconde actuelle.
setSeconds(seconds)TimeStampDéfinit les secondes du code temporel. Il représente le nombre de secondes écoulées depuis l'époque Unix(1er janvier 1970, 00:00:00 UTC).

UpdateWidget

Méthodes

MéthodeType renvoyéBrève description
addSuggestion(text, value, selected, startIconUri, bottomText)UpdateWidgetAjoute un nouvel élément pouvant être sélectionné pour les menus à sélection multiple.

ValidationErrorSeverity

Propriétés

PropriétéTypeDescription
SEVERITY_UNSPECIFIEDEnumNon spécifié.
CRITICALEnumCritique : l'erreur est critique et doit être corrigée avant la publication.
WARNINGEnumAvertissement : l'erreur n'est pas critique et n'empêche pas la publication.

ValueMetadata

Méthodes

MéthodeType renvoyéBrève description
addCastableType(dataType)ValueMetadataAjoute des types autorisés facultatifs qui peuvent être convertis dynamiquement pour les données d'une variable à ces métadonnées de valeur.
addEnumValue(enumValue)ValueMetadataAjoute une valeur de chaîne facultative aux valeurs d'énumération autorisées d'une variable. Ce champ ne peut être défini que si DataType est défini sur le type "String".
setDefaultValue(defaultValue)ValueMetadataDéfinit la valeur par défaut facultative de la variable. Par exemple, si le type de variable est booléen, defaultValue peut être défini sur "true" ou "false".

VariableData

Méthodes

MéthodeType renvoyéBrève description
addBooleanValue(value)VariableDataAjoute une valeur booléenne aux données de la variable.
addEmailAddress(emailAddress)VariableDataAjoute une adresse e-mail aux données de variable.
addFloatValue(value)VariableDataAjoute une valeur float aux données de la variable.
addGoogleUser(googleUser)VariableDataAjoute un utilisateur Google aux données de la variable.
addIntegerValue(value)VariableDataAjoute une valeur entière aux données de la variable.
addResourceData(resourceData)VariableDataAjoute une valeur ResourceData aux données de la variable.
addResourceReference(resourceReference)VariableDataAjoute un ID de référence de ressource aux données de la variable.
addStringValue(value)VariableDataAjoute une valeur de chaîne aux données de la variable.
addTimestampValue(value)VariableDataAjoute une valeur TimeStamp aux données de la variable.
addWorkflowTextFormat(workflowTextFormat)VariableDataAjoute une valeur WorkflowTextFormat aux données de la variable.

WorkflowAction

WorkflowTextFormat

Méthodes

MéthodeType renvoyéBrève description
addTextFormatElement(textFormatElement)WorkflowTextFormatAjoute un TextFormatElement au format texte du workflow.

WorkflowValidationErrorAction

Méthodes

MéthodeType renvoyéBrève description
setSeverity(severity)WorkflowValidationErrorActionDéfinit la gravité de l'erreur de validation.