Provider guide

Connect a Google Workspace staff directory

Use domain-wide delegation and organizational scoping to import active staff profiles.

Google Workspace administrators11 min readUpdated July 17, 2026

Prepare Google Workspace

  1. Enable the Admin SDK Directory API in an organization-controlled Google Cloud project.
  2. Create a dedicated service account and enable domain-wide delegation.
  3. Authorize only the read-only Directory API scopes required for user and optional group data.
  4. Choose a delegated administrator that can read the intended staff population.

Configure the source

  1. Enter the Workspace customer ID, delegated administrator email, and service account JSON.
  2. Prefer staff organizational units or explicit groups instead of the whole customer.
  3. Exclude student, alumni, contractor, resource, and automation organizational units.
  4. Add every permitted primary email domain and choose locked profile fields.
  5. Save the draft and verify that suspended accounts and non-person objects are absent from the expected population.

Provider reference