Google Directory

Overview

The Directory source supports Full Refresh syncs. It uses Google Directory API.

Output schema

This Source is capable of syncing the following Streams:

• users
• groups
• group members

Data type mapping

Integration Type	Airbyte Type	Notes
string	string
number	number
array	array
object	object

Features

Feature	Supported?(Yes/No)	Notes
Full Refresh Sync	Yes
Incremental Sync	No
Replicate Incremental Deletes	Coming soon
SSL connection	Yes
Namespaces	No

Performance considerations

This connector attempts to back off gracefully when it hits Directory API's rate limits. To find more information about limits, see Google Directory's Limits and Quotas documentation.

Getting Started (Airbyte Cloud)

1. Click OAuth2.0 authorization then Authenticate your Google Directory account.
2. You're done.

Getting Started (Airbyte Open Source)

Google APIs use the OAuth 2.0 protocol for authentication and authorization. This connector supports Web server application and Service accounts scenarios. Therefore, there are 2 options of setting up authorization for this source:

• Use your Google account and authorize over Google's OAuth on connection setup. Select "Default OAuth2.0 authorization" from dropdown list.
• Create service account specifically for Airbyte.

Service account requirements

• Credentials to a Google Service Account with delegated Domain Wide Authority
• Email address of the workspace admin which created the Service Account

Create a Service Account with delegated domain wide authority

Follow the Google Documentation for performing Domain Wide Delegation of Authority to create a Service account with delegated domain wide authority. This account must be created by an administrator of the Google Workspace. Please make sure to grant the following OAuth scopes to the service user:

1. https://www.googleapis.com/auth/admin.directory.user.readonly
2. https://www.googleapis.com/auth/admin.directory.group.readonly

At the end of this process, you should have JSON credentials to this Google Service Account.

You should now be ready to use the Google Directory connector in Airbyte.

Changelog

<details> <summary>Expand to review</summary>

Version	Date	Pull Request	Subject
0.2.45	2025-07-07	62526	Add group and email fields to group_members stream
0.2.44	2025-05-17	60641	Update dependencies
0.2.43	2025-05-10	59799	Update dependencies
0.2.42	2025-05-03	59264	Update dependencies
0.2.41	2025-04-26	58792	Update dependencies
0.2.40	2025-04-19	58186	Update dependencies
0.2.39	2025-04-12	57701	Update dependencies
0.2.38	2025-04-05	57024	Update dependencies
0.2.37	2025-03-29	56657	Update dependencies
0.2.36	2025-03-22	55973	Update dependencies
0.2.35	2025-03-08	55331	Update dependencies
0.2.34	2025-03-01	54413	Update dependencies
0.2.33	2025-02-15	53756	Update dependencies
0.2.32	2025-02-01	52855	Update dependencies
0.2.31	2025-01-25	52346	Update dependencies
0.2.30	2025-01-18	51620	Update dependencies
0.2.29	2025-01-11	51098	Update dependencies
0.2.28	2025-01-04	50925	Update dependencies
0.2.27	2024-12-28	50578	Update dependencies
0.2.26	2024-12-21	49987	Update dependencies
0.2.25	2024-12-14	49168	Update dependencies
0.2.24	2024-11-25	48638	Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.2.23	2024-10-29	47736	Update dependencies
0.2.22	2024-10-22	47071	Update dependencies
0.2.21	2024-10-12	46785	Update dependencies
0.2.20	2024-10-05	46422	Update dependencies
0.2.19	2024-09-28	46136	Update dependencies
0.2.18	2024-09-21	45733	Update dependencies
0.2.17	2024-09-14	45540	Update dependencies
0.2.16	2024-09-07	45268	Update dependencies
0.2.15	2024-08-31	45006	Update dependencies
0.2.14	2024-08-24	44625	Update dependencies
0.2.13	2024-08-17	44243	Update dependencies
0.2.12	2024-08-10	43480	Update dependencies
0.2.11	2024-08-03	43089	Update dependencies
0.2.10	2024-07-27	42615	Update dependencies
0.2.9	2024-07-20	42191	Update dependencies
0.2.8	2024-07-13	41704	Update dependencies
0.2.7	2024-07-10	41468	Update dependencies
0.2.6	2024-07-09	41233	Update dependencies
0.2.5	2024-07-06	40948	Update dependencies
0.2.4	2024-06-25	40319	Update dependencies
0.2.3	2024-06-22	39961	Update dependencies
0.2.2	2024-05-20	38449	[autopull] base image + poetry + up_to_date
0.2.1	2023-05-30	27236	Autoformat code
0.2.0	2023-05-30	26775	Remove authSpecification from spec; update stream schemas.
0.1.9	2021-12-06	8524	Update connector fields title/description
0.1.8	2021-11-02	7409	Support oauth (update publish)
0.1.7	2021-11-02	7409	Support oauth
0.1.6	2021-11-02	7464	Migrate to the CDK
0.1.5	2021-10-20	6930	Fix crash when a group don't have members
0.1.4	2021-10-19	7167	Add organizations and phones to users schema

</details>