Rédaction de brouillons

Dans un module complémentaire Google Workspace, vous pouvez créer des widgets associés à des actions. Vous pouvez utiliser une action pour rédiger des brouillons d'e-mails, en les remplissant éventuellement avec des informations saisies dans l'interface utilisateur du module complémentaire ou des informations provenant d'un message ouvert. Par exemple, vous pouvez ajouter un bouton dans l'interface utilisateur de message de votre module complémentaire qui crée une réponse au message actuellement ouvert, préremplie avec des informations provenant du module complémentaire.

Lorsqu'une action qui crée des messages est déclenchée, Gmail exécute une fonction de rappel pour créer et renvoyer le brouillon. Gmail affiche ensuite ce brouillon dans son interface utilisateur, dans une fenêtre de rédaction d'e-mail standard, que l'utilisateur peut ensuite modifier et envoyer si nécessaire.

Configurer une action pour créer un brouillon de message

Pour configurer un widget afin qu'il lance une action de création de brouillon lorsqu'il est sélectionné, vous devez procéder comme suit :

  1. Assurez-vous que votre fichier manifeste inclut le champ d'application action.compose :

    https://www.googleapis.com/auth/gmail.addons.current.action.compose

    Vous pouvez utiliser un champ d'application plus permissif, mais uniquement si ce champ d'application est absolument nécessaire.

  2. Créez un objet Action et associez-le à une fonction de rappel que vous définissez.

  3. Appelez la fonction de gestionnaire de widget setComposeAction() du widget en lui fournissant l'objet Action et en spécifiant ComposeEmailType.

  4. Implémentez la fonction de rappel qui exécute l'action de création du brouillon. Cette fonction reçoit un objet d'événement en tant qu'argument. La fonction de rappel doit effectuer les opérations suivantes :

    1. Créez un objet GmailDraft.
    2. Créez un objet ComposeActionResponse à l'aide de la classe ComposeActionResponseBuilder et de l'objet GmailDraft.
    3. Renvoie le ComposeActionResponse créé.

Vous pouvez préremplir le GmailDraft que vous créez dans la fonction de rappel avec des destinataires, un objet, un corps de message et des pièces jointes. Pour remplir le brouillon, les données peuvent provenir de n'importe quelle source, mais elles sont généralement issues des informations fournies au module complémentaire lui-même, des informations contenues dans le message ouvert ou des informations collectées à partir d'un service tiers. L'objet d'événement transmis à la fonction de rappel contient l'ID du message ouvert et d'autres informations sur le module complémentaire que vous pouvez utiliser pour préremplir le brouillon.

Vous pouvez créer le brouillon en tant que nouveau message autonome ou en réponse à un message existant. Ce paramètre est contrôlé par l'énumération ComposeEmailType fournie à setComposeAction(). Vous pouvez créer des brouillons de réponses uniques ou des brouillons de réponses à tous les destinataires.

Brouillons autonomes

Un brouillon autonome démarre un fil de discussion et ne répond à aucun message existant. Vous pouvez créer un brouillon autonome à l'aide de l'une des fonctions suivantes du service Gmail :

Brouillons de réponses

Une réponse en cours de rédaction fait partie d'un fil de discussion existant. Les brouillons de réponse sont soit des réponses uniques qui ne sont envoyées qu'à l'expéditeur d'un message, soit des brouillons de réponse à tous qui sont envoyés à tous les destinataires du message. Vous pouvez créer un brouillon de réponse avec l'une des fonctions du service Gmail suivantes :

Exemple

L'extrait de code suivant montre comment attribuer une action qui crée un brouillon de réponse à un bouton.

  var composeAction = CardService.newAction()
      .setFunctionName('createReplyDraft');
  var composeButton = CardService.newTextButton()
      .setText('Compose Reply')
      .setComposeAction(
          composeAction,
          CardService.ComposedEmailType.REPLY_AS_DRAFT);

  // ...

  /**
   *  Creates a draft email (with an attachment and inline image)
   *  as a reply to an existing message.
   *  @param {Object} e An event object passed by the action.
   *  @return {ComposeActionResponse}
   */
  function createReplyDraft(e) {
    // Activate temporary Gmail scopes, in this case to allow
    // a reply to be drafted.
    var accessToken = e.gmail.accessToken;
    GmailApp.setCurrentMessageAccessToken(accessToken);

    // Creates a draft reply.
    var messageId = e.gmail.messageId;
    var message = GmailApp.getMessageById(messageId);
    var draft = message.createDraftReply('',
        {
            htmlBody: "Kitten! <img src='cid:kitten'/>",
            attachments: [
              UrlFetchApp.fetch('https://example.com/images/myDog.jpg')
                  .getBlob()
            ],
            inlineImages: {
              "kitten": UrlFetchApp.fetch('https://example.com/images/myKitten.jpg')
                           .getBlob()
            }
        }
    );

    // Return a built draft response. This causes Gmail to present a
    // compose window to the user, pre-filled with the content specified
    // above.
    return CardService.newComposeActionResponseBuilder()
        .setGmailDraft(draft).build();
  }