Google Directory – Google Service Account

In this article

Overview

You can use this account type to connect the Google Directory Snaps with data sources that use the Google Service Account.

When using the Google Service Account, you must pass the customerID as a filter key and set the filter value (for example, C125v1gta) in the Filter attributes settings in the Google Directory Read Snap. The filter attributes are optional when using other accounts. This step is mandatory when using the Google Directory Read Snap configured with the Google Service Account because, by default, it is not associated with any customer. Learn more about finding the customer ID in the Google Workspace.

google-directory-read.png

Alternatively, you can follow the below steps to obtain the Customer ID:

  1. Sign in using your administrator account in Google Workspace.

  2. Navigate to your Admin Console.

  3. Click on Account > Select Account Settings.

  4. Check for Customer ID.

 

Prerequisites

Limitations

  • When you read a Group Resource using the userkey as a filter key under the Filter attributes settings in the Google Directory Read Snap, a 404 error displays because the get API for the Google Resource supports only the groupkey as the filter key. Learn more.

Known Issues

None.

Account Settings

google-service-account.png

 

  • Asterisk ( * ): Indicates a mandatory field.

  • Suggestion icon ( ): Indicates a list that is dynamically populated based on the configuration.

  • Expression icon ( ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon ( ): Indicates that you can add fields in the field set.

  • Remove icon ( ): Indicates that you can remove fields from the field set.

Field Name

Field Type

Description

Field Name

Field Type

Description

Label*

 

Default ValueGoogle Service Account
ExampleGoogle Directory - Service Account

String

Specify a unique label for the account.

 

JSON key*

 

Default Value: N/A
Exampleroot-beacon-429915-m9-12hj8jkln,.json

String/Expression

Specify the JSON key created for the service account. Learn how to create a JSON key.

Troubleshooting

Error

Reason

Resolution

Error

Reason

Resolution

Security Exception occurred while accessing the Google Directory API

Unable to make a call and access the Google Directory API.

Provide the correct credentials and retry.

Failure: IO error occurred

400 Bad Request GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits { "code": 400, "errors": [ { "domain": "global", "message": "Invalid Customer Id", "reason": "invalid" } ], "message": "Invalid Customer Id" },

Provide the customerID because the Google Service Account is not associated with any customer. Ensure that the scope is correctly defined for the action/resource being executed.

directory/v1/groups?customer=my_customer { "code": 404, "errors": [ { &qu