Google Directory Spoke
Manage groups, members, and users in Google Directory from your ServiceNow instance.
Request apps on the Store
Visit the ServiceNow Store to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.
Integration Hub subscription
This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview.
Note:
- In this version, the alias type is changed to the Connection and Credential. The alias type supports multiple connections.
- If you’re upgrading to Google Directory spoke v1.1.2, you must reconfigure the alias record.
Spoke version
Google Directory spoke v1.6.0 is the latest version.
Spoke dependencies
If you’re having trouble installing the app, ensure that these dependent plugins are installed:
- ServiceNow IntegrationHub Action Template - Data Stream (com.glide.hub.action_type.datastream)
- ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
- ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
- ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
- Complex Object (com.glide.cobject)
Note: Some of these plugins are licensable features and require an appropriate license if used outside the spoke implementation. For information on licenses, contact your account manager.
Google Directory account requirements
The Google Directory spoke requires a custom app that you create in the Google Developers Console.
Supported versions
This spoke was built for API version v1, but may be compatible with later versions.
Spoke subflows
The Google Directory spoke provides sample subflows to demonstrate automating tasks. To customize a sample subflow, copy it to the required application scope. These webhook subflows perform specific tasks when webhooks execute user resource changes in the Google Directory. Available sample subflows include:
| Subflow | Description |
|---|---|
| Create Google Directory User Webhook Subflow | When you update the details of a user in the Google Directory, a webhook notifies your ServiceNow instance. Now, when you execute the Create Directory User Webhook Subflow, it creates a subscription and an entry to the Google Directory Webhook Registries table.Note: To execute the subflow, you must provide the webhook URL that ServiceNow exposes for incoming webhooks in the Test Subflow window. The webhook URL format ishttps://<instance-name>.service-now.com/api/sn_googledir_spoke/google_directory_webhook_callbacks/wh_entry. |
| Process Google Directory User Webhook Subflow | Processes Google Directory webhooks when user details are updated in the Google directory. The Google Directory provides sample subflows to demonstrate automating Google Directory webhook flows. |
Spoke actions
The Google Directory spoke provides actions to automate Google Directory when events occur in ServiceNow. Available actions include:
| Category | Action | Description |
|---|---|---|
| Group Management | Create Group | Creates a group. |
| Delete Group | Deletes a group. | |
| Look up Group Details by Group Email or ID | Retrieves details of the specified groups based on group email or ID. | |
| Look up All Groups Stream | Retrieves the details of all groups. | |
| Look up Groups Stream by Filtering Criteria | Retrieves details of the specified groups based on the provided filter criteria. | |
| Update Group Details | Updates details of the specified group. | |
| Member Management | Add Member To A Group | Adds member to the specified group. |
| Check Membership of a Group | Checks if the given user is a member of the group email or ID. | |
| Look up Member Details from a Group | Retrieves the details of the required member in the specified group. | |
| Look up Members of a Group by Group Email or ID | Retrieves the details of all member in the specified group. | |
| Remove Member from a Group | Removes the specified member from a group. | |
| Update Member | Updates details of the specified member in a group. | |
| User Management | Create User | Creates a user. |
| Delete User | Deletes the specified user. | |
| Generate Random Password | Generates a random password with the specified length. | |
| Grant Admin To User | Grants admin privileges to the specified user. | |
| Look up All Users Stream by Customer ID | Retrieves a paginated list of all users in a domain, including deleted users if showDeleted is set to true. | |
| Look up User Details by User Email or ID | Retrieves details of the given user. | |
| Look up Users Stream by Filtering Criteria | Searches for users matching the filter criteria. This action accepts the query parameter which is a search query combining one or more search clauses. | |
| Reactivate User | Reactivates the specified user.Note: Exercise caution while using this action, as it may affect the other user’s account. | |
| Reset User Password | Resets the password of the user.Note: Exercise caution while using this action, as it may affect the other user’s account. By default, the Force Change Password option is enabled and the user is forced to change the password on the first login. | |
| Revoke Admin from User | Revokes the admin privileges of the specified user. | |
| Suspend User | Suspends the specified user.Note: Exercise caution while using this action, as it may affect the other user’s account. | |
| Update User Details | Updates details of the specified user. | |
| Webhook Management | Create Subscription Channel | Creates a subscription channel that watches for changes in the users list. |
| Stop Subscription Channel | Stops watching resources through the given channel before the expiry of the subscription. | |
| Schema Management | Look up Schema by ID | Retrieves details of the specified schema. |
| Look up schemas | Retrieves details of all schemas for a customer. |
Connection and credential alias requirements
Integration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.
For information about setting up the spoke, see Set up the Google Directory spoke.