Organization Google app

What an organization Google app is, what it lets your members' Gmail, Google Calendar and Google Drive connections do, and what members see when their organization has one.

What an organization Google app is

When someone connects Gmail, Google Calendar or Google Drive, Haruno asks Google for permission through a Google app: Haruno's built-in one, or your organization's own. If your organization has one, members' new sign-ins go through it, and Google's permission screen shows its name. It changes what Haruno can do in chats and scheduled tasks; the month-end close never reads these services.

  • It is a Desktop app client in a Google Cloud project your organization controls. An organization has one; the Mac and Windows apps have no setting for it.
  • Haruno stores the client secret encrypted and hands it only to signed-in members' Haruno apps. No Haruno screen shows it.
  • It gives you no access to anyone's mailbox, calendar or Drive: each member signs in to their own Google account, and the sign-in stays on their computer.
  • Existing connections move to it only when the member signs in to that connector again. On Windows, Google Drive uses it only when the member chooses My Drive.

To have one set up or changed, see Setting one up. Members need only How members connect.

Why a finance team uses one

You need one if you want Haruno to find a company's email and save its export attachments, or to work with folders that already exist in your own Google Drive. Reading mail and reaching a whole Drive are permissions Google restricts, and Haruno's built-in app does not ask for them. An app your organization owns can.

What Haruno can doBuilt-in appYour organization's app
Send email with attachments; create and rename Gmail labelsYesYes
Search and read mail, save attachments, reply in a conversation, move mail to TrashNoYes
Reach Google DriveOnly a folder Haruno createsFolders in the member's own My Drive, if the member keeps full Drive access

With your app, a member can ask Haruno in a chat to find a company's email and save its export attachments:

text
Find this week's email from Acme Corp with their QuickBooks exports, save the attachments, and tell me where you saved them.

Unless you name another folder, Haruno saves them in a hidden folder inside the folder the chat works in (the Workspace folder, unless you opened another), so ask for the path. Neither Google app puts anything into a company's books: add the files yourself, with Add data until the mapping exists and Books ▸ Import Exports… after that. To reach a saved attachment, press ⇧⌘G in the Upload company files window and paste the path. Sending works on either app, so emailing companies for their exports needs no organization app.

Keep each company's Drive folder in your own My Drive
On a Mac, Haruno reaches only folders in the member's own My Drive: not a folder a company shares with you (Shared with me), even through a shortcut, and not a shared drive. So create each company's folder in your own My Drive, share it with the company, and tick it in Folders Haruno can use. The built-in app sees only a folder it created, and not files someone adds to it in Google Drive.
Mail Haruno reads becomes part of the chat
The permission to read mail covers the member's whole mailbox; Haruno cannot be limited to one label or one company's mail. What a chat or scheduled task reads becomes part of the conversation, which goes through Inferara's hosted service to the model provider. Tell members which mail they should and should not ask Haruno to read.

What you'll need

As a member you need nothing beyond a Haruno account in the organization: sign in to Haruno with it, then connect the Google service as usual (How members connect). A person can belong to only one organization (Organizations).

Internal or External

Choose Internal if every member connects an account in your firm's own Google Workspace, and External for any other Google accounts.

AudienceWho can connectWhat members go through
InternalOnly accounts in your Google WorkspaceNo weekly sign-in and no unverified-app warning.
External, in TestingOnly the test users you addGoogle may warn that it has not verified the app. Each sign-in lasts about seven days. You maintain the test-user list and the Data Access permissions.
External, out of TestingAccounts beyond your test usersNo weekly sign-in, but members may see the unverified-app warning until Google verifies the app. Google may require verification of sensitive or restricted scopes; reading mail and full Drive access are restricted.

On a Mac, Haruno gives no warning before a weekly sign-in lapses. The next time it uses the connector, the row reads Credential rejected — sign in again to reconnect. and a chat notice says, for example, “Gmail rejected its saved sign-in. Reconnect it in Connectors — its tools are off until you do.” New chats leave the connector out for up to a day, or until the member signs in again. Google's warning reads “Google hasn't verified this app”: tell members your app's name, so they continue past it only for your app.

Addresses in a company's Google Workspace
An Internal app admits only accounts in your own Workspace, and a company's Workspace administrator can block apps they have not approved. Only that administrator can lift the block.

Setting one up

Registering, replacing or removing an organization Google app is not offered in the account dashboard at the moment. To have one set up or changed, talk to us or write to info@inferara.com. An app your organization saved earlier keeps working.

How members connect

Members set nothing up: they connect as usual, and Google's permission screen names the organization's app.

On a Mac

  1. Sign in to Haruno with your organization's account.

    Check the account row at the bottom of the sidebar, and sign in if needed. Signed out, a Google sign-in goes through Haruno's built-in app, which cannot read mail.

  2. Click the account row and choose Connectors….

    If the window was already open when the app changed, close and reopen it.

  3. Click Sign in on the Gmail or Google Calendar row, keep every permission selected on Google's screen, and allow access.

    The row then reads Connected through your organization's Google app; the confirmation switch under it is on by default (Connector confirmations). For Google Drive, see Connect Google Drive.

If a member connected before the app existed

The connection keeps working; its row says, for example, Gmail is still connected through Haruno's built-in Google app. Sign in again to switch to your organization's Google app. Choose Sign in again in the row's ⋯ menu, or for Google Drive Edit…, Continue to Google Drive and Save. Moving to full Drive access clears Drive's folders: pick them again with Choose folders….

On Windows

On Windows the Google connectors (Settings ▸ Connectors, Integrations card) use the same app: Gmail and Google Calendar for every new connection while the member is signed in to Haruno. Google Drive asks first: Haruno connection folder uses the built-in app and reaches only files Haruno creates there; My Drive uses your app with full Drive access, and needs an app saved and the member signed in.

What the member sees on WindowsWhat to do
Sign in to Haruno before connecting My Drive.Sign in to Haruno, then connect.
My Drive requires a Google app configured by your organization. …Ask us about an app (see Setting one up), or choose Haruno connection folder.
Your organization's Google app could not be checked, so this sign-in was stopped. …Haruno could not fetch your app. Try again.
Update this integration before connecting it with your organization's Google app.Update the connector, then connect.
These Gmail permissions require an organization Google app. …No organization app was used. Ask us about an app, then reconnect Gmail.
Choose either the Haruno connection folder or My Drive before connecting Google Drive.Pick one in the Google Drive access field.

What each permission unlocks

A member can untick items on Google's permission screen. Gmail needs the send permission and Google Drive at least one Drive permission; anything else unticked connects with less.

ScopeAsked for byWhat it allows
openid, userinfo.emailYour appKnow which Google account connected.
gmail.send (“Send email on your behalf”)Both appsSend mail with attachments. Required.
gmail.labelsBuilt-in app onlyCreate and rename labels (your app uses gmail.modify).
gmail.modifyYour appSearch, read and reply to mail, save attachments, manage labels, move mail to Trash.
calendar.eventsBoth appsRead the calendar and create, change or cancel events.
drive.fileBuilt-in app; your app on a MacReach only files Haruno creates, in its own folder.
driveYour appReach the member's own My Drive; on a Mac, only the folders the member chooses.

When a member unticks a permission

On a Mac, leaving out:

  • Send email on your behalf: Gmail does not connect (“Google did not grant permission to send email, so Gmail was not connected. …”).
  • Reading mail (gmail.modify): Gmail can only send, and its caption ends “Reading mail needs the Google app your organization sets up.”
  • Every Drive permission: Google Drive does not connect (“Google did not grant access to Drive, so the connection was not created. …”).
  • Full Drive access only: Drive reaches only the Haruno folder; an existing connection narrowed this way warns “This connection now only sees the Haruno folder in your Google Drive. …”

The fix each time: sign in again and keep every permission selected.

What this means for scheduled tasks

In a scheduled task on a Mac, your app lets Haruno search and read mail and move it to Trash without asking; Gmail keeps trashed mail for 30 days, after which it cannot be recovered. Emails and replies still wait in Waiting unless the task may send on its own, and with the permission to read mail, each held one also sits in the member's Gmail drafts. See What waits and what happens at once.

Replacing or removing the organization app

Replacing or removing an app is not offered in the account dashboard at the moment either: talk to us or write to info@inferara.com. Disbanding the organization removes its app too. Without an organization app, new Gmail and Google Calendar sign-ins use Haruno's built-in app, so Gmail cannot read mail; a new Google Drive connection on a Mac reaches only a Haruno folder; on Windows, My Drive cannot be connected until an app is saved again.

What happens to members' connections

Nothing is changed at Google, and connections on a Mac react as below. A Mac picks up a change when Haruno starts or the Connectors window opens; members need not sign out of Haruno or restart it.

ChangeOn a Mac
New secret, same client IDConnections keep working.
A different clientConnections through the old app stop: “Gmail was connected through an older Google app. Sign in again to move it to the one your organization uses now.”
App removed, or organization disbandedConnections through it stop: “Gmail was connected through a Google app that is no longer set up. Sign in again to reconnect through Haruno's built-in app, which has less access.”
The member signs out of Haruno, leaves the organization or is removedConnections through your app stop until the member signs back in to Haruno within the organization.
Any of these, for a built-in-app connectionIt keeps working.

Ask members to sign in again: Sign in again in the row's ⋯ menu, or for Google Drive Edit…, Continue to Google Drive and Save. A Drive row may read This connection was set up through a Google app that is no longer configured. Sign in again to reconnect. After a removal, Drive reconnects to Haruno's own folder only, and its folders must be chosen again. Until then, new chats leave the connector's tools off.

On Windows, Gmail and Google Calendar connections keep the app they were made with; the member connects again to use your current one.

If something goes wrong

Most sign-in problems come from the Google Cloud project, which only an admin can fix.

In the account dashboard

The account dashboard has no Google app card at the moment, so none of its messages about the app appear there. For anything about a saved app, talk to us or write to info@inferara.com.

On a member's Mac

What the member seesWhat it means, and what to do
Google didn't finish the sign-in. If you didn't cancel it yourself, …, or Error 403: access_denied on Google's pageThe member canceled, or the account is not a test user. Add it under Test users.
Google didn't accept the Google app this sign-in used, … (sending from Waiting), or a Google error page instead of the permission screenThe client was deleted or disabled, or its secret no longer matches. Create a new Desktop app client if needed and ask us to replace the app. The member signs in again, clicking Cancel first if the row still reads Finish signing in in your browser….
A chat, a held item (Google refused it (403).) or the Drive sheet (Request failed (403) …) reports that the API has not been used in the project or is disabledEnable that service's API. No new sign-in is needed.
Your Google Workspace administrator blocks this app, so it can't be connected. …The Workspace that owns the address, perhaps a company's, must allow the app.
This Google account isn't part of your organization's Google Workspace, …Your app is Internal. Sign in with the work account; other addresses need an External app.
Haruno couldn't read your organization's Google app just now, …Haruno stops rather than sign in through another app. Try again in a few minutes.
This connection can't be used right now — … Unlock your keychain and try again.Unlock the Mac's login keychain.
Google returned no refresh token. …Remove Haruno's access in the Google account's settings, then sign in again.

A rejected saved sign-in (Credential rejected — sign in again to reconnect.) and other connector problems: Troubleshooting ▸ Connectors.

Next steps

Members connect from the Connectors window.