Install Gmail / Google Workspace

Download and extract the ZIP

Also download checksums.sha256. Compare the file SHA-256 with the line bearing its exact name before installing.

Create the Apps Script project

Open script.google.com with the account used in Gmail. Select New project and name it PrivCloud Gmail. Replace all content in Code.gs with the Code.gs file from the ZIP, then save.

Show and replace the manifest

Select the Project Settings gear. Enable Show appsscript.json manifest file in editor. Return to Editor, open appsscript.json, replace its entire content with the manifest below and save. This configures the add-on permissions. PrivCloud sign-in OAuth settings are separate.

{
  "timeZone": "Europe/Paris",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/gmail.addons.execute",
    "https://www.googleapis.com/auth/gmail.addons.current.action.compose"
  ],
  "addOns": {
    "common": {
      "name": "PrivCloud",
      "logoUrl": "https://share.privcloud.fr/install/assets/privcloud-gmail-logo-v1.png",
      "openLinkUrlPrefixes": [
        "https://share.privcloud.fr/"
      ],
      "homepageTrigger": {
        "runFunction": "homepage"
      }
    },
    "gmail": {
      "composeTrigger": {
        "selectActions": [
          {
            "text": "Envoyer avec PrivCloud",
            "runFunction": "composeAction"
          }
        ],
        "draftAccess": "NONE"
      }
    }
  }
}

Authorize the add-on with your account

In Editor, select authorizePrivCloud from the function list, then Run. If Google prompts you, select Review permissions, choose your account and grant the displayed permissions. If your organization blocks the app, ask its administrator to approve it. A completed execution does not yet mean the add-on is installed.

Install the test deployment

Select Deploy in the top-right corner, then Test deployments. Choose Google Workspace Add-on if needed, select Install, then OK or Done. If an older version is installed, select Uninstall first, then Install. Refresh the Gmail tab.

Find PrivCloud in Gmail

Create a new email. In the toolbar near Send, select the PrivCloud icon. If it is hidden, look in the three-dot menu. The add-on may also appear in the right sidebar. It shows three steps for sharing your files.

Insert your first link

In the pane, select Choose my files in PrivCloud. Finish uploading in the new tab and copy the full share link. Return to the draft, paste it into the pane field, then select Insert link into email. Check the result before sending your message.