Skip to content

Install & Configure

Once dependencies are installed and auth is ready, install Salesforce Google Client.

Install

Package install command: 

sf package install --wait 20 --security-type AdminsOnly --package 04tJ80000011MKfIAM

Configure in the Google Client App

Before configuring the application, the administrator must grant themselves access to the app.

Step 1: Assign Admin Permissions

  1. Assign the Google Cloud Client Admin permission set to your user.
  2. This permission grants access to the Google Client application and configuration features.

Step 2: Open the Google Client Application

After permissions are assigned:

  1. Open the Google Client application from the App Launcher.
  2. You will land on the Home page, which displays:
  • Current configuration status
  • Authentication setup details
  • Validation messages for missing or incomplete settings

Step 3: Configure Authentication

Google Client supports two authentication setup options:

  1. Admin setup (recommended for most orgs) — no Apex coding required
  2. Developer setup (custom authorizer class) — for advanced or fully custom scenarios

Both options require that you already uploaded a Salesforce certificate (JKS) as described on the previous page, and that you know your Service Account email.

Option A: Admin Setup (No Code)

Use this option if you want to configure authentication through the UI:

  1. Select Admin setup (recommended for most orgs)
  2. Enter the Service Account Email
  3. Enter the Salesforce Certificate Name (the certificate you uploaded earlier)
  4. Click Save & Validate

Admin Setup

Option B: Developer Setup (Custom Authorizer Class)

Use this option if you need a custom token strategy or want to fully control authorization in Apex:

  1. Select Developer setup (custom authorization class)
  2. Create an Apex class that implements the library’s authorization contract
  3. Reference the class in the Custom Google Authorizer Class field
  4. Click Save & Validate

Developer Setup

📘 Reference documentation: Library Authorization Flow

📘 Certificate setup (use the certificate created earlier): Service Account Setup

Step 4: Complete Application Configuration

After authentication is configured:

  1. Provide the Google Drive Folder ID.
  2. Leave all other settings unchanged unless you have specific requirements.
  • Use a Shared Drive for centralized, team-managed access.
  • Maintain a dedicated root folder per environment (Dev / UAT / Prod).