Haruno Knowledge base

Gmail

Connect a Google account so Haruno can send mail and manage labels. Reading, searching and replying need a Google app that an organization sets up.

  • Mac appAvailableWith Haruno's own Google sign-in it sends mail and manages labels only. Reading needs a Google app an organization sets up.
  • Windows appAvailableWith Haruno's own Google sign-in it sends mail and manages labels only. Reading needs a Google app an organization sets up.

What it connects

Gmail connects one Google account's mailbox to Haruno. Find it in Settings ▸ Connectors, under the Mail button.

Gmail and Outlook sit together under the Mail button. The one-line descriptions in this demo are placeholders.
The Connectors list narrowed to Mail, showing the Gmail and Outlook cards, both switched off.The Connectors list narrowed to Mail, showing the Gmail and Outlook cards, both switched off.

What Haruno can do

With Haruno's own Google sign-in, Haruno can send a new email and list, create and rename labels. A label is Gmail's tag for sorting mail.

With a Google app set up by an organization, it can also search and read mail, save an attachment to a file, reply in the same thread and move a message to Trash. Trash keeps it for about 30 days.

Reading mail is not on by default

Haruno's own sign-in does not ask Google for permission to read. Search, read, reply and Trash then say an organization Google app is needed. The dashboard's Google app card is hidden for now, so only an organization that saved an app earlier gets reading. Do not promise it. The card may also say "Google account" instead of the address.

How to connect

  1. Turn it on
    Open the Gmail card and turn on Enable. Haruno downloads what it needs.
  2. Sign in
    Choose Connect. Your browser opens Google's sign-in. Keep "Send email on your behalf" ticked, or Haruno refuses to connect.

Disconnect also asks Google to end Haruno's access.

What needs your approval

Sending, replying, moving to Trash, and creating or renaming a label each show an approval card. Choose Allow once or Allow for this session. A remembered approval for a mail covers only the same people. Searching, reading and listing labels ask nothing.

A scheduled task or a hook has nobody to ask, so these steps are refused and the run says the step needed approval. The advanced view lets you set each action to On, Off or Confirm.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    PR #2944Commit a2a7836The page at this version
    What changed
    @@ -0,0 +1,39 @@
+---
+title: Gmail
+summary: Connect a Google account so Haruno can send mail and manage labels. Reading, searching and replying need a Google app that an organization sets up.
+feature: connector-gmail
+covers:
+  - Integrations/gmail/**
+  - IntegrationPlatform/Haruno.Integrations.Core/Packages/GoogleUserApp.cs
+---
+
+## What it connects
+
+Gmail connects one Google account's mailbox to Haruno. Find it in <Ui>Settings ▸ Connectors</Ui>, under the **Mail** button.
+
+<Shot src="/m/d6056feb4b87-windows-connector-mail-light.png" dark="/m/7b7238b8df23-windows-connector-mail-dark.png" alt="The Connectors list narrowed to Mail, showing the Gmail and Outlook cards, both switched off." caption="Gmail and Outlook sit together under the Mail button. The one-line descriptions in this demo are placeholders." />
+
+## What Haruno can do
+
+With Haruno's own Google sign-in, Haruno can send a new email and list, create and rename labels. A label is Gmail's tag for sorting mail.
+
+With a Google app set up by an organization, it can also search and read mail, save an attachment to a file, reply in the same thread and move a message to Trash. Trash keeps it for about 30 days.
+
+<Callout variant="warning" title="Reading mail is not on by default">
+Haruno's own sign-in does not ask Google for permission to read. Search, read, reply and Trash then say an organization Google app is needed. The dashboard's Google app card is hidden for now, so only an organization that saved an app earlier gets reading. Do not promise it. The card may also say "Google account" instead of the address.
+</Callout>
+
+## How to connect
+
+<Steps>
+<Step title="Turn it on">Open the Gmail card and turn on <Ui>Enable</Ui>. Haruno downloads what it needs.</Step>
+<Step title="Sign in">Choose <Ui>Connect</Ui>. Your browser opens Google's sign-in. Keep "Send email on your behalf" ticked, or Haruno refuses to connect.</Step>
+</Steps>
+
+<Ui>Disconnect</Ui> also asks Google to end Haruno's access.
+
+## What needs your approval
+
+Sending, replying, moving to Trash, and creating or renaming a label each show an approval card. Choose **Allow once** or **Allow for this session**. A remembered approval for a mail covers only the same people. Searching, reading and listing labels ask nothing.
+
+A scheduled task or a hook has nobody to ask, so these steps are refused and the run says the step needed approval. The advanced view lets you set each action to **On**, **Off** or **Confirm**.