Skip to content
This repository has been archived by the owner on Sep 28, 2020. It is now read-only.
/ gmail_v1 Public archive

⛔️ DEPRECATED, Send email using Gmail in Sheetbase backend app.

License

Notifications You must be signed in to change notification settings

sheetbase/gmail_v1

Repository files navigation

Sheetbase Module: @sheetbase/gmail

Send email using Gmail in Sheetbase backend app.

Build Status Coverage Status NPM License clasp Support me on Patreon PayPal Ask me anything

Install

Using npm: npm install --save @sheetbase/gmail

import * as Gmail from "@sheetbase/gmail";

As a library: 1cKQyLf_OZwivLAiNBw-naLV_uq-lmf8AcOEnE9t5E9IQhA1Fo8JTV_sm

Set the Indentifier to GmailModule and select the lastest version, view code.

declare const GmailModule: { Gmail: any };
const Gmail = GmailModule.Gmail;

Usage

Getting started

Install: npm install --save @sheetbase/gmail

Usage:

import { gmail } from "@sheetbase/gmail";

const Gmail = gmail(
  /* options */ {
    prefix: "MyApp"
  }
);

const { threadId } = Gmail.send({
  recipient: "xxx@xxx.xxx"
});

Configs

forwarding

  • Type: string
  • Default: current account email.

Manage email from different account.

prefix

  • Type: string
  • Default: Sheetbase.

For better management, all email subject will be prefix with a string and labeled prefix:category.

categories

  • Type: object
  • Default: an uncategoriezed category: { uncategorized: { title: 'Uncategorized', silent: true } }.

List of support categories, all email will be sorted to one of these categories.

{
  categories: {
    message: 'Messages',
    misc: {
      title: 'Misc',
      silent: true
    }
  }
}

templates

  • Type: object
  • Default: {}.

List of supported templates.

{
  templates: {
    hello: (data: any) => `Hello ${data.name}!`,
  }
}

Gmail

Interface for sending email.

  • quota: view remaining daily quota.
  • send: send email.

quota

View remaining daily quota.

const { remainingDailyQuota } = Gmail.quota();

send

Send email.

// To: xxx@xxx.xxx
// Subject: Send me email
// Content: Hello world!
// Label: <prefix>:Uncategorized
const { threadId } = Gmail.send({
  recipient: "xxx@xxx.xxx",
  subject: "Send me email",
  options: {
    htmlBody: `<p>Hello world!</p>`
  }
});

// To: ...
// Subject: ...
// Content: ...
// Label: <prefix>:Messages
Gmail.send(
  {
    /* ... */
  },
  "message"
);

// To: ...
// Subject: ...
// Content: Hello John!
// Label: ...
Gmail.send(
  {
    recipient: "xxx@xxx.xxx",
    subject: "Send me email"
  },
  "message",
  {
    hello: { name: "John" }
  }
);

// force silent = false
Gmail.send(
  {
    /* ... */
  },
  null,
  null,
  false
);

Routes

To add routes to your app, see options AddonRoutesOptions:

Gmail.registerRoutes(options?: AddonRoutesOptions);

Default disabled

Disabled routes by default, to enable set { disabledRoutes: [] } in registerRoutes():

[
  "post:/mail" // send email
];

Endpoints

GET /mail

Get quota.

POST /mail

Send email. Route body:

  • mailingData: mail data
  • category: category name
  • template: template config
  • silent: override category silent

Send an email:

{
  mailingData: {
    recipient: 'xxx@xxx.xxx',
    subject: 'Send me email',
    options: {
      htmlBody: `<p>Hello world!</p>`,
    }
  }
}

With category:

{
  mailingData: { /*  */ },
  category: 'message'
}

With template:

{
  mailingData: { /*  */ },
  template: {
    hello: { name: 'John' }
  }
}

Override category silent:

{
  mailingData: { /*  */ },
  silent: false,
}

License

@sheetbase/gmail is released under the MIT license.

About

⛔️ DEPRECATED, Send email using Gmail in Sheetbase backend app.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published