Google Groups
The Google Groups modules enable you to create, update, list, retrieve, or delete groups and members in your Google Groups.
Getting Started with Google Groups
Prerequisites
An admin G Suite account
In order to use Google Groups with Make, it is necessary to have a G Suite account and be an administrator of the G Suite domain.
Obtain client credentials for your custom app
To obtain the client credentials, you must have access to Google Cloud Console and be able to create or edit the project.
Sign in to Google Cloud console using your Google credentials.
Click Select a project > NEW PROJECT. Enter the desired project name, and click the CREATE button.
Select the project you have created.
Go to APIs & Services > Library.
Search and enable the following required APIs:
Cloud Resource Manager API
The desired service option should display as you type. Select the API/service you want to connect to Make.
Click the ENABLE button to enable the selected API.
Navigate to APIs & Services > OAuth consent screen.
Choose the External option, and click the CREATE button.
Note
You will not be charged when selecting this option! For more details, please refer to Google's Exceptions to verification requirements.
Fill in the required fields as follows, and then click Save and Continue:
App name
Enter the name of the app asking for consent. For example,
Make.Authorized domains
make.comintegromat.com
You don't have to set anything in the Scopes and Optional info sections. Click Save and Continue.
In the Test Users section, click ADD USERS and enter the testing user email address to access the app.
Navigate to Credentials. Click the +CREATE CREDENTIALS and select the OAuth Client ID option.
Fill in the required fields as follows, and then click the CREATE button to create the application:
Application type
web applicationName
Name of the application. For example,
Make.Authorized redirect URIs
https://www.integromat.com/oauth/cb/google-restrictedA dialog containing the app's Client ID and Client Secret is displayed. Save them in a safe place for later use.
You have successfully created the client credentials.
Note
If you are using custom apps with publishing state, Testing, then you must set up the access token NOT TO be forced to do re-authentication every week after expiration.
For more information, see on setting up OAuth consent screen.
To set up app token and authentication, see using OAuth 2.0 for Web Server applications.
Connect Google Groups to Make
To connect Google Groups app:
Log in to your Make account, insert a Google Groups module in your scenario, and click the Add button next to the Connection field.
Optional: In the Connection name field, enter a name for the connection.
Optional: Click Show advanced settings and enter the client credentials of your custom app.
Click Save.
Confirm the permissions dialog by clicking the Allow button.
You have successfully established the connection. You can now edit your scenario and add more Google Groups modules. If your connection needs reauthorization at any point, follow the connection renewal steps here.
Group
Retrieves groups in your domain.
Connection | |
Your Domain | Enter or select the G Suite domain you want to list groups from. |
Query | Enter the search query. For more information and examples please refer to the Search for groups documentation. |
Member Email or ID | Enter user's or group's primary email address, or user's ID. You can retrieve the ID, for example, using the Get a Member module. |
Sort Order | Select whether you want to sort results in descending or ascending order. |
Limit | Set the maximum number of groups Make will return during one execution cycle. |
Retrieves group details.
Connection | |
Group ID | Enter (map) or select the group you want to retrieve details about. |
Creates a new group.
Connection | |
Your Domain | Enter or select your G Suite domain you want to create a group for. |
Group Name | Enter the name of the group you want to create. E.g. Sales Group. |
Group Email Prefix | Enter the prefix of the group's email address. E.g. sales_group (for the [email protected]email address). |
Description | Enter the description of the group. E.g. This is the Sales group. |
Updates a group.
Connection | |
Group ID | Enter (map) or select the group you want to update. |
Please find the descriptions of the fields in the Create a Group section above.
Deletes a group.
Note
When a group is deleted:
All members of the group are deleted. The member's user accounts are not deleted.
The group archive is deleted.
Messages sent to the deleted group's address are not delivered. Instead, the sender receives a bounce message.
Connection | |
Group ID | Enter (map) or select the group you want to delete. |
Member
Retrieves members of the selected group.
Connection | |
Group ID | Enter (map) or select the group you want to retrieve members for. |
Roles | Select the role of the member you want to filter results by.
|
Include Derived Membership | Enable this option to list also indirect memberships. |
Limit | Set the maximum number of members Make will return during one execution cycle. |
Retrieves member details.
Connection | |
Group ID | Enter (map) or select the group that contains the member you want to retrieve details about. |
Member ID | Enter (map) or select the member you want to retrieve details about. |
Adds a member to a specified group.
Connection | |
Group ID | Enter (map) or select the group you want to add a member to. |
Member's Email | Enter the email address of the member you want to add to the group. |
Delivery Settings | Select mail delivery preferences of the member.
|
Roles | Select the role you want to assign to the member.
|
Updates the membership of a user in the specified group.
Connection | |
Group ID | Enter (map) or select the group that contains the member you want to update. |
Member ID | Enter (map) or select the member you want to update. |
Member's Email | Enter the email address of the member you want to update. |
Delivery Settings | Select mail delivery preferences of the member.
|
Roles | Select the role you want to assign to the member.
|
Removes a specified member from the group.
Connection | |
Group ID | Enter (map) or select the group that contains the member you want to remove. |
Member ID | Enter (map) or select the member you want to remove from the group. |
Group Settings
Retrieves settings of the specified group.
Connection | |
Group Email | Enter (map) or select the group email of the group you want to retrieve settings for. |
Updates group's properties.
(Reference: https://developers.google.com/admin-sdk/groups-settings/v1/reference/groups)
Connection | ||
Group Email | Enter (map) or select the group email of the group you want to retrieve settings for. | |
Description | An extended description to help users determine the purpose of a group. For example, you can include information about who should join the group, the types of messages to send to the group, links to FAQs about the group, or related groups. Maximum length is 4,096 characters | |
Allow External Members | Select whether members external to your organization can join the group. | |
Allow Web Posting | Select whether members are allowed to post from web. | |
Archive the Group | Select the Yes option to set the group as archived and inactive.New messages to this group are rejected. The older archived messages are browseable and searchable. | |
Message Moderation Level | Select the moderation level of incoming messages. Possible values are:
| |
Who Can Discover | Select the set of users for whom this group is discoverable. | |
Who Can Join | Specify who can join the group. | |
Who Can Moderate Content | Specify who can moderate content. | |
Who Can Moderate Members | Select who can manage members. | |
Who Can Post Messages | Select one of the options for posting messages.
| |
Who Can View Group | Select permissions for viewing the group.
|
Alias
Adds an email alias to a group.
Connection | |
Group ID | Enter (map) or select the group you want to add the alias to. |
Your Domain | Enter or select your G Suite domain that contains the domain you want to add the alias to. |
Alias Name | Enter the alias name. E.g. |
Retrieves all aliases for the group.
Connection | |
Group ID | Enter (map) or select the group you want to retrieve aliases for. |
Limit | Set the maximum number of aliases Make will return during one execution cycle. |
Removes an alias from the specified group.
Connection | |
Group ID | Enter (map) or select the group you want to remove an alias from. |
Alias | Enter (map) or select the alias you want to remove from the group specified above. |
Other
Allows you to perform a custom API call.
Connection | |
Select | Choose:
|
URL | Enter a path relative to:
For the list of available endpoints, refer to:
|
Method | Select the HTTP method you want to use: GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry. |
Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String | Enter the request query string. |
Body | Enter the body content for your API call. |
The following API call returns all members in the specified group:
Select:
Google Groups
URL:
/v1/groups/{{the ID of the group you want to retrieve members from}}/members/
Method:
GET
The result can be found in the module's Output under Bundle > Body > members.
In our example, 1 member was returned:
