Soạn tin nhắn nháp

Trong một tiện ích bổ sung của Google Workspace, bạn có thể tạo tiện ích có hành động được liên kết. Bạn có thể dùng một thao tác để soạn thảo email mới, có thể điền thông tin vào email bằng thông tin đã nhập vào giao diện người dùng của tiện ích bổ sung hoặc thông tin từ một thư đang mở. Ví dụ: bạn có thể có một nút trong giao diện người dùng tin nhắn của tiện ích bổ sung. Nút này sẽ tạo một thư trả lời cho thư hiện đang mở, trong đó có sẵn thông tin từ tiện ích bổ sung.

Khi một thao tác tạo thư được kích hoạt, Gmail sẽ thực thi một hàm gọi lại để tạo và trả về bản nháp. Sau đó, Gmail sẽ hiển thị bản nháp đó trong giao diện người dùng của mình ở cửa sổ soạn thư tiêu chuẩn, người dùng có thể chỉnh sửa và gửi nếu cần.

Định cấu hình thao tác để tạo tin nhắn nháp

Để định cấu hình một tiện ích nhằm bắt đầu thao tác tạo bản nháp khi được chọn, bạn phải làm như sau:

  1. Đảm bảo tệp kê khai của bạn có phạm vi action.compose:

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

    Bạn có thể sử dụng một phạm vi cho phép rộng hơn, nhưng chỉ nên làm như vậy nếu phạm vi đó là hoàn toàn cần thiết.

  2. Tạo một đối tượng Action và liên kết đối tượng đó với một hàm gọi lại mà bạn xác định.

  3. Gọi setComposeAction() của tiện ích hàm trình xử lý tiện ích, cung cấp cho hàm này đối tượng Action và chỉ định ComposeEmailType.

  4. Triển khai hàm gọi lại thực thi thao tác tạo bản nháp. Hàm này nhận một đối tượng sự kiện làm đối số. Hàm callback phải thực hiện những việc sau:

    1. Tạo một đối tượng GmailDraft.
    2. Tạo một đối tượng ComposeActionResponse bằng cách sử dụng lớp ComposeActionResponseBuilder và đối tượng GmailDraft.
    3. Trả về ComposeActionResponse đã tạo.

Bạn có thể điền sẵn GmailDraft mà bạn tạo trong hàm gọi lại bằng người nhận, tiêu đề, nội dung thư và tệp đính kèm. Để điền vào bản nháp, dữ liệu có thể đến từ bất kỳ nguồn nào, nhưng thường là từ thông tin được cung cấp cho chính tiện ích bổ sung, thông tin trong thư mở hoặc thông tin được thu thập từ dịch vụ bên thứ ba. Đối tượng sự kiện được truyền đến hàm gọi lại chứa mã nhận dạng thông báo mở và thông tin bổ sung khác mà bạn có thể dùng để điền sẵn bản nháp.

Bạn có thể tạo bản nháp dưới dạng một tin nhắn độc lập mới hoặc một câu trả lời cho tin nhắn hiện có. Việc này được kiểm soát bằng enum ComposeEmailType được cung cấp cho setComposeAction(). Bạn có thể tạo bản nháp trả lời dưới dạng thư trả lời riêng lẻ hoặc thư "trả lời tất cả".

Bản thảo độc lập

Bản nháp độc lập sẽ bắt đầu một chuỗi tin nhắn mới và không phải là thư trả lời cho bất kỳ tin nhắn nào hiện có. Bạn có thể tạo bản nháp độc lập bằng một trong các chức năng sau đây của dịch vụ Gmail:

Email trả lời nháp

Thư trả lời nháp là một phần của chuỗi thư hiện có. Bản nháp trả lời là bản nháp trả lời riêng lẻ chỉ được gửi cho người gửi thư hoặc bản nháp "trả lời tất cả" được gửi cho tất cả những người nhận được thư đó. Bạn có thể tạo thư nháp trả lời bằng một trong những hàm dịch vụ Gmail sau đây:

Ví dụ:

Đoạn mã sau đây cho biết cách chỉ định một thao tác tạo bản nháp thư trả lời cho một nút.

  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();
  }