Redactar borradores de mensajes

En un complemento , puedes crear widgets que tengan acciones vinculadas actions. Puedes usar una acción para redactar borradores de correo electrónico nuevos y, de manera opcional, completarlos con la información ingresada en la IU del complemento o la información de un mensaje abierto. Por ejemplo, puedes tener un botón en la IU de mensajes de tu complemento que cree una respuesta al mensaje abierto actualmente con información del complemento.

Cuando se activa una acción que crea mensajes, Gmail ejecuta una función de devolución de llamada para crear y mostrar el borrador. Luego, Gmail muestra ese borrador en su IU en una ventana de redacción de correo electrónico estándar, que el usuario puede editar y enviar según sea necesario.

Configura una acción para crear un mensaje borrador

Para configurar un widget para que inicie una acción de creación de borrador cuando se selecciona, debes hacer lo siguiente:

  1. Asegúrate de que tu manifiesto incluya el action.compose alcance:

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

    Puedes usar un alcance más permisivo, pero solo debes hacerlo si ese alcance es absolutamente necesario.

  2. Crea un objeto Action y asócialo con una función de devolución de llamada que definas.

  3. Llama a la función del controlador de widgets setComposeAction del widget, proporciónale el objeto Action y especifica el ComposeEmailType.

  4. Implementa la función de devolución de llamada que ejecuta la acción de creación de borrador. Esta función recibe un objeto de evento como argumento. La función de devolución de llamada debe hacer lo siguiente:

    1. Crea un GmailDraft objeto.
    2. Crea un ComposeActionResponse objeto con la clase ComposeActionResponseBuilder y el GmailDraft objeto.
    3. Muestra el ComposeActionResponse creado.

Puedes completar previamente el GmailDraft que creas en la función de devolución de llamada con destinatarios, un asunto, un cuerpo del mensaje y archivos adjuntos. Para completar el borrador, los datos pueden provenir de cualquier fuente, pero, por lo general, se derivan de la información proporcionada al complemento, la información del mensaje abierto o la información recopilada de un servicio de terceros. El objeto de evento que se pasa a la función de devolución de llamada contiene el ID del mensaje abierto y otra información del complemento que puedes usar para completar previamente el borrador.

Puedes crear el borrador como un mensaje independiente nuevo o como una respuesta a un mensaje existente. Esto se controla con la ComposeEmailType enumeración que se le da a la setComposeAction. Puedes crear borradores de respuesta como respuestas únicas o mensajes de "responder a todos".

Borradores independientes

Un borrador independiente inicia un nuevo subproceso y no es una respuesta a ningún mensaje existente. Puedes crear un borrador independiente con una de las siguientes funciones del servicio de Gmail:

Borradores de respuesta

Un borrador de respuesta forma parte de un subproceso de mensajes existente. Los borradores de respuesta son respuestas únicas que solo se envían al remitente de un mensaje o borradores de "responder a todos" que se envían a todos los que recibieron ese mensaje. Puedes crear un borrador de respuesta con una de estas funciones del servicio de Gmail:

Ejemplo

En el siguiente fragmento de código, se muestra cómo asignar una acción que crea un borrador de respuesta a un botón.

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 previously
  // specified.
  return CardService.newComposeActionResponseBuilder()
      .setGmailDraft(draft).build();
}