How to use IBM App Connect with Google Groups
Google Groups is a service provided by Google that allows users to create and manage mailing lists, online discussion forums, and collaborative inboxes.
App Connect Enterprise as a Service connector-
Local
connector in containers (Continuous Delivery release) 12.0.10.0-r2 or later
Connecting to Google Groups
Complete the connection fields that you see in the App Connect Designer Catalog page or flow editor. If necessary, work with your Google Groups administrator to obtain these values.
Google Groups connection fields:
| Authorization type | Connection fields | Applicability |
|---|---|---|
| Use the application's website to sign in (OAUTH 2.0 AUTH CODE) | Application client ID | App Connect Enterprise as a Service |
| Application client secret | ||
| Provide credentials for App Connect to use (BASIC OAUTH) | Application client ID | App Connect Enterprise as a Service and App Connect in containers |
| Application client secret | ||
| Access token | ||
| Refresh token | ||
| Provide credentials for App Connect to use (API KEY) | User email | App Connect in containers |
| Service account email | ||
| Private key |
| Connection field | Description |
|---|---|
| Application client ID | The unique identifier that is generated from the Google API Console that maps to specific project requests. |
| Application client secret | The application client secret for the unique application client ID created for a specific project. |
| Access token | The access token that is generated from the application client ID and client secret. |
| Refresh token | The refresh token that is generated from the application client ID and client secret. |
| User email | The email address that you use to login to your Google Cloud console. |
| Service account email | The service email address of your Google Cloud account. Get this email address from the JSON file, which will be available on your Google Cloud console when you create a project. |
| Private key | The private key for your Google Cloud account. Get this private key from the JSON file, which will be available on your Google Cloud console when you create a project. |
- Log in to the Google Cloud Console.
- On the dashboard, select an existing project, or click NEW PROJECT.
- If you selected a new project, enter a project name and location (organization), then click
Create.
When the project is created, the Project ID is shown on the dashboard.
- On the Welcome page, click APIs & Services, then click + ENABLE APIS AND SERVICES.
- Search for and select Groups Settings API, then click Manage.
- Click CREDENTIALS, then click Credentials in APIs & Services.
- Click CREATE CREDENTIALS, then select Service
account, and follow the on-screen instructions to create a service account.Important: On the Grant this service account access to project section, make sure to add the necessary roles.
- When the service appears on the Credentials page, click the service account, then go to .
- Select JSON as the key type, then click CREATE.
- Save the JSON file to your local system.
- Open the JSON file by using an editor of your choice. This file contains the Client
ID and Private key values.Tip: For detailed information about generating client email and private key, see Create and delete service account keys on the Google Cloud console page.
To connect to a Google Groups endpoint from the App Connect Designer Catalog page for the first time, expand Google Groups, then click Connect.
Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Catalog page, select the account, open its options menu (⋮), then click Rename Account.
General considerations
Before you use App Connect Designer with Google Groups, take note of the following considerations
- (General consideration) You can see lists of the trigger events and
actions that are available on the Catalog page of the App Connect Designer.
For some applications, the events and actions in the catalog depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.
- (General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.
Events and actions
Google Groups events
These events are for changes in this application that trigger a flow to start completing the actions in the flow.
Google Groups actions
Your flow completes these actions on this application.
| Object | Action | Description |
|---|---|---|
| Group aliases | Retrieve group aliases | Retrieves the group aliases from Google Groups |
| Create group aliases | Creates a group alias in Google Groups | |
| Delete group aliases | Deletes the group aliases from Google Groups | |
| Group members | Retrieve members | Retrieves the members from Google Groups |
| Add member to group | Adds a member to a group in Google Groups | |
| Remove member from group | Removes a member from a group in Google Groups | |
| Retrieve member by ID | Retrieves the member by ID from Google Groups | |
| Update member | Updates the members in Google Groups | |
| Groups | Retrieve groups | Retrieves the groups from Google Groups |
| Create group | Creates a group in Google Groups | |
| Delete group | Deletes a group from Google Groups | |
| Retrieve group by ID | Retrieves the group by ID from Google Groups | |
| Update group | Updates the properties of a group in Google Groups |
Examples
Use templates to quickly create flows for Google Groups
Learn how to use App Connect templates to quickly create flows that complete actions on Google Groups. For example, open the Templates gallery, then search for Google Groups.
Use IBM® App Connect to build flows that integrate with Google Groups.
Read the blog in the IBM Community to learn how to add a group member in Google Groups for each employee retrieved from Microsoft Dynamics 365 for Finance and Operations. Click Read the blog to go to the blog.