IT and Development

Google Workspace Admin

50min
with the google workspace admin modules in make, you can watch, list, create, update, retrieve, and delete users, roles, role assignments, and organizational units to get started with google workspace admin, create an account at https //workspace google com https //workspace google com/intl/en in/ make's use and transfer of information received from google apis to any other app will adhere to google api services user data policy https //developers google com/terms/api services user data policy connect google workspace admin to make log in to your make account, add a google workspace admin module to your make, and click create a connection optional in the connection name field, enter a name for the connection optional click show advanced settings field, and enter the client credentials from your custom application see connecting to google services using oauth2 click the sign in with google button and select your google account review the access information and click allow you have successfully established the connection you can now begin editing scenarios and adding more google workspace admin modules if your connection needs reauthorization at any point, follow the connection renewal steps here https //www make com/en/help/connections/connecting to services html connecting to google services using oauth2 make's modules' advanced settings let you enter your own oauth2 client credentials oauth is a security authorization protocol to interact with your protected data that does not require sending your login information in order to use oauth2 with your google apps, you need to create your own project and a custom oauth client in google cloud console this is useful for connecting restricted google services, like google drive or gmail, to make the following procedure is intended for personal use ( @gmail com and @googlemail com users) organizational use (internal use within a business or other organization google workspace (formerly gsuite) users that prefer to use a custom oauth client) prerequisites a google account to create a custom oauth client for google service you must do the following create a project on the google cloud platform google workspace admin docid 59gqzq b0w2qglggz1h89 on the google cloud platform google workspace admin docid 59gqzq b0w2qglggz1h89 on the google cloud platform google workspace admin docid 59gqzq b0w2qglggz1h89 on the google cloud platform google workspace admin docid 59gqzq b0w2qglggz1h89 on make create a project sign in to google cloud platform https //console developers google com/ using your google credentials open the dashboard https //console cloud google com/apis/dashboard , and click the create project button googleoauthcreateproject png choose a name for your project, then click create googleoauth2nameproject png enable api click enable apis and services googleoauth2enableapis png enter the name of the service you want to use (for example, gmail api or google drive api) in the enable apis and services field the desired service option should display as you type click on the api/service you want to connect to make googleoauth2searchapis png click enable googleoauth2clickenable png configure your oauth consent form go to apis & services > https //console cloud google com/apis/credentials/consent settings, choose the external option, then click create googleoauth2createconsentscreen png fill in the required fields as follows for the scopes section on the test users section, click add users to add the email address associated with the google account you want to connect to make for example make enter the name of the app asking for consent make com integromat com service/api required scopes \<app> \<scopes> \<app> \<scope> add required scopes for the google service you want to connect to make create credentials open the https //console cloud google com/apis/credentials settings page click + create credentials , and select the oauth client id option googleoauth2createcredentials png fill in the required fields as follows, then click create googleoauth2enterclientinfo png a dialog containing the app's client id and client secret is displayed googleoauth2clientcreated png oauth redirect uri domain notice that the redirect uri starts with https //www integromat com instead of https //www make com this is currently a known issue in make make was formerly called integromat, which means you can trust this url as much as any make url https //www integromat com/oauth/cb/google restricted for gmail or google drive https //www integromat com/oauth/cb/google/ for other google apps https //www integromat com/oauth/cb/google custom for google text to speech and google natural language https //www integromat com/oauth/cb/app for any app created via the make developer platform add one of the following uris enter your credentials go to your make make and choose the google module you want to use next to connection , click add click show advanced settings enter the client id and client secret you retrieved in step 4 of the preceding procedure into the respective fields, then click continue create credentials sign in with your google account the this app isn't verified window appears click on continue googleoauth2googlehasntverified png click the check box next to google product and click allow to confirm your choices you have now established the connection to your chosen google service using a custom oauth client user using the following modules, you can watch, create, update, list, retrieve, and delete users and make users super admin watch users triggers when a new user is created connection establish a connection to your g suite admin account your domain select the domain whose users you want to watch query search projection custom field mask enter a comma separated list of schema names limit the maximum number of users make should return during one make execution cycle for more details, refer to the search query documentation https //developers google com/admin sdk/directory/v1/guides/search users field specifies the user attribute to search for example, givenname operator test is performed on this attribute for example, contains a value value specifies the content to test for example, andrew enter the search query you can search the users with the following three attributes basic do not include any custom fields for the user custom include custom fields from schemas requested in customfieldmask full include all fields associated with this user select the subset to fetch the user details list users retrieves a list of users in a domain connection establish a connection to your g suite admin account your domain select the domain whose users you want to list query search order by projection custom field mask enter a comma separated list of schema names show deleted when selected, lists the users who are deleted sort oder view type limit the maximum number of users make should return during one make execution cycle for more details, refer to the search query documentation https //developers google com/admin sdk/directory/v1/guides/search users field specifies the user attribute to search for example, givenname operator test is performed on this attribute for example, contains a value value specifies the content to test for example, andrew enter the search query you can search the users with the following three attributes email family name given name select the order in which you want to list the users basic do not include any custom fields for the user custom include custom fields from schemas requested in customfieldmask full include all fields associated with this user select the subset to fetch the user details ascending descending select the order in which you list the users admin view domain view select the option to view the users get a user gets the details of a user connection establish a connection to your g suite admin account user id select the user id whose details you want to retrieve projection custom field mask enter a comma separated list of schema names view type basic do not include any custom fields for the user custom include custom fields from schemas requested in customfieldmask full include all fields associated with this user select the subset to fetch the user details admin view domain view select the view create a user creates a new user connection establish a connection to your g suite admin account first name enter the first name of the user last name enter the last name of the user password enter the password of the user your domain select the domain for the user phones secondary email change password at next login when selected, it prompts the user to change the password when tried to login next time yes no not defined select whether this is the primary phone number of the user primary select the phone number type type enter the phone number phone number add the phone numbers of the user home work other select the email address type type enter the email address email address add the secondary email address update a user updates an existing user connection establish a connection to your g suite admin account user id select the user id you want to update first name enter the first name of the user last name enter the last name of the user password enter the password of the user your domain select the domain for the user phones secondary email yes no not defined select whether this is the primary phone number of the user primary select the phone number type type enter the phone number phone number add the phone numbers of the user home work other select the email address type type enter the email address email address add the secondary email address delete a user deletes a user connection establish a connection to your g suite admin account user id select the user id of the user you want to delete make a user a super admin makes a user a super administrator connection establish a connection to your g suite admin account user id select the user id of the user whom you make a super admin organizational unit using the following modules, you can list, retrieve, create, update, and delete organizational units list organizational units retrieves a list of all organizational units for an account connection establish a connection to your google workspace admin account path select the path whose organizational units you want to list type limit the maximum number of organizational units make should return during one make execution cycle all children select the type of organizational units you want to list get an organizational unit gets the details of an organizational unit connection establish a connection to your google workspace admin account get organizational unit organizational unit path select the organizational path whose organizational unit details you want to retrieve by path by id select the method by which you want to retrieve the organizational units create an organizational unit creates a new organizational unit connection establish a connection to your google workspace admin account name enter the name of the organizational unit description enter the details of the organizational unit parent organizational unit path enter the path to the parent organizational unit if this organization is a subsidiary of any other organization update an organizational unit updates an existing organizational unit connection establish a connection to your google workspace admin account get organizational path organizational unit path select the organizational path whose organizational unit details you want to update name enter a new name for the organizational unit description enter the details of the organizational unit by path by id select the method by which you want to retrieve the organizational units delete an organizational unit deletes an organizational unit connection establish a connection to your google workspace admin account get organizational path organizational unit path select the organizational path whose organizational unit details you want to delete by path by id select the method by which you want to retrieve the organizational units role using the following modules, you can create, update, list, retrieve, and delete roles list roles retrieves a list of all roles in a domain connection establish a connection to your g suite admin account limit the maximum number of roles make should return during one make execution cycle get a role gets the details of a role connection establish a connection to your g suite admin account role id select the role id whose details you want to retrieve create a role creates a new role connection establish a connection to your g suite admin account role name enter a name for the role role privileges role description enter the details of the role select the permission privilege name select the service service id add the permissions for the role update a role updates an existing role connection establish a connection to your g suite admin account role id select the role id you want to update role name enter a name for the role role privileges role description enter the details of the role select the permission privilege name select the service service id add the permissions for the role delete a role deletes a role connection establish a connection to your g suite admin account role id select the role id you want to delete role assignment using the following modules, you can list, retrieve, assign, and delete role assignments list role assignments retrieves a list of all role assignments connection establish a connection to your g suite admin account search role assignments your domain select the domain whose role assignments you want to list limit the maximum number of role assignments make should return during one make execution cycle by user email name by user id by role id select the option to search the role assignments you want to list get a role assignment gets the details of a role assignment connection establish a connection to your g suite admin account role assignment id select the role assignment id whose details you want to retrieve assign a user to a role assigns a user to a specific role connection establish a connection to your g suite admin account role id select the role id which you want to assign to the user assign to select the user to whom you want to assign the role delete a role assignment deletes a role assignment connection establish a connection to your g suite admin account role assignment id select the role assignment id you want to delete other list privileges retrieves a list of all privileges for a customer connection establish a connection to your g suite admin account limit the maximum number of privileges make should return during one make execution cycle make an api call performs an arbitrary authorized api call connection establish a connection to your g suite admin account url method 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 note for the list of available endpoints, refer to the g suite admin api documentation https //developers google com/admin sdk directory api https //developers google com/admin sdk/directory/v1/reference enterprise license manager api https //developers google com/admin sdk/licensing/v1/reference reports api https //developers google com/admin sdk/reports/v1/reference g suite reseller api https //developers google com/admin sdk/reseller/v1/reference groups settings api https //developers google com/admin sdk/groups settings/v1/reference groups migration api https //developers google com/admin sdk/groups migration/v1/reference data transfer api https //developers google com/admin sdk/data transfer/v1/reference enter a path relative to https //www googleapis com for example /admin/directory/v1/users to delete an entry delete to make a partial entry update patch to update/replace an existing entry put to create a new entry post to retrieve information for an entry get select the http method you want to use example of use list users in a domain the following api call returns all the users in the same domain from your g suite admin account url /admin/directory/v1/users method get query string key domain value {{domain you want to retrieve users from}} 61f26e2f89538 png matches of the search can be found in the module's output under bundle > body > users in our example, 3 users were returned 61f26e307dc54 png