Taslak ileti oluşturma

Eklentilerde, bağlı işlemleri olan widget'lar oluşturabilirsiniz. Yeni e-posta taslakları oluşturmak için bir işlem kullanabilirsiniz. İsteğe bağlı olarak, eklenti kullanıcı arayüzüne girilen bilgileri veya açık bir iletideki bilgileri kullanarak taslakları doldurabilirsiniz. Örneğin, eklentinizin mesaj kullanıcı arayüzünde, eklentideki bilgilerle önceden doldurulmuş ve şu anda açık olan mesaja yanıt oluşturan bir düğme olabilir.

İleti oluşturan bir işlem tetiklendiğinde Gmail, taslağı oluşturup döndürmek için bir geri çağırma işlevi yürütür. Gmail daha sonra bu taslağı kullanıcı arayüzünde standart bir e-posta oluşturma penceresinde gösterir. Kullanıcı da bu taslağı gerektiği gibi düzenleyip gönderebilir.

Taslak mesaj oluşturmak için bir işlem yapılandırma

Bir widget'ı seçildiğinde taslak oluşturma işlemini başlatacak şekilde yapılandırmak için şunları yapmanız gerekir:

1. Manifest dosyanızın action.compose kapsamını içerdiğinden emin olun:

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

   Bunun yerine daha izin verici bir kapsam kullanabilirsiniz ancak bunu yalnızca bu kapsam kesinlikle gerekliyse yapmalısınız.

2. Bir Action nesnesi oluşturun ve bunu tanımladığınız bir geri çağırma işleviyle ilişkilendirin.

3. setComposeAction widget işleyici işlevini çağırın, Action nesnesini sağlayın ve ComposeEmailType'ı belirtin.

4. Taslak oluşturma işlemini yürüten geri çağırma işlevini uygulayın. Bu işlev, bağımsız değişken olarak bir etkinlik nesnesi alır. Geri çağırma işlevi şunları yapmalıdır:

   1. GmailDraft nesnesi oluşturun.
   2. ComposeActionResponseBuilder sınıfını ve GmailDraft nesnesini kullanarak ComposeActionResponse nesnesi oluşturun.
   3. Oluşturulan ComposeActionResponse öğesini döndürün.

Geri çağırma işlevinde oluşturduğunuz GmailDraft iletiyi alıcılar, konu, ileti gövdesi ve eklerle önceden doldurabilirsiniz. Taslağı doldurmak için veriler herhangi bir kaynaktan gelebilir ancak genellikle eklentinin kendisine sağlanan bilgilerden, açık mesajdaki bilgilerden veya üçüncü taraf bir hizmetten toplanan bilgilerden elde edilir. Geri çağırma işlevine iletilen event object, açık mesaj kimliğini ve taslağı önceden doldurmak için kullanabileceğiniz diğer eklenti bilgilerini içerir.

Taslağı yeni bir bağımsız mesaj veya mevcut bir mesaja yanıt olarak oluşturabilirsiniz. Bu, setComposeAction öğesine verilen ComposeEmailType enum'ı tarafından kontrol edilir. Yanıt taslaklarını tek yanıt veya "tümünü yanıtla" mesajı olarak oluşturabilirsiniz.

Bağımsız taslaklar

Bağımsız bir taslak, yeni bir ileti dizisi başlatır ve mevcut bir iletiye yanıt değildir. Aşağıdaki Gmail hizmeti işlevlerinden birini kullanarak bağımsız bir taslak oluşturabilirsiniz:

• GmailApp.createDraft(recipient, subject, body)
• GmailApp.createDraft(recipient, subject, body, options)

Yanıt taslakları

Yanıt taslağı, mevcut bir mesaj dizisinin parçasıdır. Yanıt taslakları, yalnızca iletinin gönderenine gönderilen tek yanıtlar veya iletiyi alan herkese gönderilen "tümünü yanıtla" taslaklarıdır. Şu Gmail hizmeti işlevlerinden birini kullanarak yanıt taslağı oluşturabilirsiniz:

• GmailMessage.createDraftReply(body)
• GmailMessage.createDraftReply(body, options)
• GmailMessage.createDraftReplyAll(body)
• GmailMessage.createDraftReplyAll(body, options)
• GmailThread.createDraftReply(body)
• GmailThread.createDraftReply(body, options)
• GmailThread.createDraftReplyAll(body)
• GmailThread.createDraftReplyAll(body, options)

Örnek

Aşağıdaki kod snippet'inde, yanıtlama taslağı oluşturan bir işlemin düğmeye nasıl atanacağı gösterilmektedir.

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