Cloud Upload: Google G Suite

Attention: You need Service Account credentials to connect to GMail API. Also, you need access to specified domains to collect. To get it, you need a GSuite account with access to:

To view steps for creating a Service Account, click Closedhere.

  1. Service account creation:

    1. Go to https://console.developers.google.com/

    2. Create project if needed.

    3. Go to hamburger-button > IAM & admin > Service accounts.

    4. Click "Create service account".

    5. In "Service account details" window:

      1. enter name ("gmail-reader-1" for example)

      2. continue.

    6. In "Grant this service account access to project" window:

      1. skip roles granting

      2. continue.

    7. In "Grant users access to this service account" window:

      1. "Create key"

      2. select JSON format

      3. json file will be downloaded automatically, store it securely!

      4. done.

    8. In list of all service accounts:

      1. open your new account

      2. Copy Unique ID somewhere

  2. GMail API enabling:

    1. Go to https://console.developers.google.com/

    2. Go to Library

    3. Go to GMail API

    4. Click Enable

  3. Giving access to gmail api of organisation:

    1. Go to https://admin.google.com > Security > Advanced settings > Manage API client access

    2. Create new client access:

      1. Client Name - previously copied Unique ID

      2. API Scopes - "https://www.googleapis.com/auth/gmail.readonly"

Connection

Connect with Gmail

  • Service Account JSON Key: Enter the content of the JSON key file.

  • Click Next.

Data Selection

Select GSuite Data

  • Search Query: Enter the same query that is used in the search box of Gmail website. Avoid using queries that are specific to a particular mailbox - this query will be applied to all mailboxes.

    Note: Please note that text queries used in Gmail will become exact in ZyLAB ONE, which may lead to different results. For example, where the text query 'invite' in Gmail will also find the word 'invitation', in ZyLAB ONE it will only find the word 'invite'.

  • Mailboxes: Define the mailboxes accounts that must be collected. Make sure accounts are split with either a comma or a semicolon.

    For example: user01@zylab.com, user02@zylab.com

  • Checkbox: Include spam and trash

  • Checkbox: Skip mailboxes validation: Select this checkbox, if you want to skip the verification of settings and validation of all mailboxes. You might want to do this if you are collecting from many mailboxes.

  • Click Next.

Settings

Assign Custodian and Source

  • Set the custodian(s) and source(s) at the bottom of the screen.

    Tip: First select the custodian/source that needs to be assigned to all or most mailboxes. Then, select one or more mailboxes in the table for which a different custodian/source needs to be assigned.

    Attention: Please note that whenever no mailboxes are selected and you assign another custodian/source, all previously assigned custodians/sources will be overwritten.

  • View the list of assigned custodian(s) and source(s) in the table.

  • When ready, click Save.

Set Custodian and Source

  • Custodian: Select a Custodian from the dropdown list or create a new one.

  • Source: Select a Source from the dropdown list or create a new one.