Google Drive

learn how to connect engini to google drive using engini’s google drive activities, you can upload files, download files, create folders, and manage your documents effortlessly to get started with the google drive app, create a free account at google com or use your organizational google drive account getting started with google drive prerequisites a google drive account add a connection to google drive in engini enter your engini account at https //app engini io/ navigate to connections page by clicking on the connections on the left sidebar or by clicking https //app engini io/connections click on the "new integration" option located at the topbar choose google drive option from the available applications enter the details in the “add connection” form note there are two different authentication methods available, and the required fields differ depending on the option you choose please follow the relevant instructions based on your selected method oauth2 this method uses a predefined authentication flow you don’t need to provide a client id or client secret, you simply sign in using your account connection name enter unique identifier for the connection within engini authentication method select oauth2 fields automatically populated post connecting to a google account include access token a token for authorization to access google services refresh token a token used to obtain a new access token when the current one expires click on the “sign in with google” button sign into your google account click on the save button to save the connection custom oauth2 this method requires you to configure your own oauth2 credentials you must provide both a valid client id and client secret obtained from your google cloud console project connection name – choose a unique identifier for the connection within engini authentication method – select custom oauth2 when connecting to google services using a custom oauth client to learn more about this authentication, enter here client id – enter the client id from the oauth 2 0 credentials in the google cloud project client secret – enter the client secret from the same set of oauth 2 0 credentials in the google cloud project access token – automatically populated post connecting to a your google account refresh token automatically populated post connecting to a your google account sign in with google – click sign in with google and log in with the google account used to create the project in google cloud this ensures access to the correct oauth credentials and permissions click on the save button to save the connection triggers check for file/folder created the trigger monitors the google drive, listening for new files or folders created in the connected drive at scheduled intervals as defined drive id – enter the id of the drive where you want to monitor for new files or folders if left empty, the trigger will search in “my drive” by default folder id – enter the id of the specific folder you want to monitor for new files or folders if left empty, the trigger will search in all folders according to the drive selection content type – select the type of content you want the trigger to monitor you can choose between “files and folders,” “files only,” or “folders only ” starting (utc) – select the start date and time for the scheduled trigger recur every – choose the time interval for triggering and checking emails the minimum time interval is 15 minutes add time frame – you can specify a time frame during which the trigger will operate click on “add time frame” button select a specific time frame to activate the trigger for example, every 15 minutes from 8 am to 5 pm add sorting choose to sort if necessary click in “add sorting” button to select an item from the list, click the small arrow choose the field on which you want to apply the sorting from the drop down select the order of the sorting add conditions choose to add conditions if necessary click in “add condition” button to select an item from the list, click the small arrow choose the field on which you want to apply the condition from the drop down select the desired operator from the drop down list enter the value that the item should match top n specifies the maximum number of entries to retrieve, with a default setting of all entries if left blank check for file/folder modified the trigger monitors the google drive, listening for files or folders that have been modified in the connected drive at scheduled intervals as defined drive id – enter the id of the drive where you want to monitor for modified files or folders if left empty, the trigger will search in “my drive” by default folder id – enter the id of the specific folder you want to monitor for modified files or folders if left empty, the trigger will search in all folders according to the drive selection content type – select the type of content you want the trigger to monitor you can choose between “files and folders,” “files only,” or “folders only ” starting (utc) – select the start date and time for the scheduled trigger recur every – choose the time interval for triggering and checking emails the minimum time interval is 15 minutes add time frame – you can specify a time frame during which the trigger will operate click on “add time frame” button select a specific time frame to activate the trigger for example, every 15 minutes from 8 am to 5 pm add sorting choose to sort if necessary click in “add sorting” button to select an item from the list, click the small arrow choose the field on which you want to apply the sorting from the drop down select the order of the sorting add conditions choose to add conditions if necessary click in “add condition” button to select an item from the list, click the small arrow choose the field on which you want to apply the condition from the drop down select the desired operator from the drop down list enter the value that the item should match top n specifies the maximum number of entries to retrieve, with a default setting of all entries if left blank watch file/folder created the trigger monitors the google drive, listening for new files or folders created in specific drive and folder content type – choose whether to list only files, only folders, or both files and folders drive id – enter the drive id where the folder will be created folder id – enter the folder id field that specifies the parent folder where the new folder will be created actions get file/folder info this activity retrieves metadata about a specified file or folder in google drive file/folder id – enter the id of the file or folder you want to retrieve data about get drive info this activity retrieves metadata about a specified google drive drive id – enter the id of the drive you want to retrieve data about use domain admin access – specify whether to use domain admin access (true or false) output type – specify the output type (compact or full) get file revision this activity retrieves the revision history of a specified file in google drive file id – enter the id of the file you want to retrieve revision history about revision id – enter the id of the specific revision you want to retrieve get file revisions this activity retrieves the entire revision history of a specified file in google drive file id – enter the id of the file you want to retrieve revision history about get shared drives this activity retrieves a list of shared drives in google drive response format – specify the format of the response (compact or full) filters created time – filter shared drives by their creation date hidden – filter based on whether the shared drive is hidden or visible id – filter by the specific id of the shared drive name – filter shared drives by their name top n – you can set the maximum number of shared order drives engini will return during one workflow cycle (default = all drivers) get shared link this activity retrieves the shareable link for a specified file or folder in google drive file/folder id – enter the id of the file or folder to retrieve its shared link create a shared drive this activity creates a new shared drive in google drive request id – enter a unique identifier (uuid) for the new shared drive name – enter the name for the new shared drive create folder this activity creates a new folder in the shared drive drive id – enter the drive id where the folder will be created folder id – enter the folder id field that specifies the parent folder where the new folder will be created folder name – enter the name of the new folder you want create file/folder permission this activity sets or modifies permissions for a specific file or folder, including the option to transfer ownership file id – enter the file id that uniquely identifies the file or folder for which you want to create or modify permissions transfer ownership – specify whether to transfer ownership of the file or folder to another user (true or false), which grants them full control over the item fields – you have the option to choose fields that control access and visibility settings for files or folders in google drive delete shared drive this activity permanently removes a shared drive and all its contents from google drive drive id – enter the drive id that specifies the shared drive you want to delete delete file/folder this activity permanently removes a specified file or folder from google drive file/folder id – enter the file/folder id that identifies the specific file or folder you want to delete delete file/folder permission this activity removes a specific user’s access permissions from a file or folder in google drive however, permission deletion is subject to the following rules the owner of a file cannot have their permission removed by anyone only the owner can remove permissions for other users, such as editors and viewers users who are not the owner can remove their own permission from the file but cannot remove others file id – enter the file id that identifies the specific file or folder from which you want to remove permissions permission id – enter the permission id that specifies the particular permission you want to delete from the file or folder delete file revision this activity removes a specific version of a file in google drive file id – enter the file id that identifies the file from which you want to delete a revision revision id – enter the revision id that specifies the particular version of the file you want to delete update shared drive this activity modifies the settings or metadata of an existing shared drive in google drive drive id – enter the drive id that identifies the shared drive you want to update fields desired description – set a new description for the shared drive desired name – specify a new name for the shared drive use domain admin access – choose whether to use domain admin privileges for the update update file this activity updates the content or metadata of an existing file in google drive file id enter the file id that identifies the file you want to update fields desired description – set a new description for the file desired file type – specify the new file type or format you want to set desired location (list of ids) – provide the ids of the locations (folders) where you want the file to be placed desired name – set a new name for the file undesired location (list of ids) – provide the ids of locations (folders) from which you want to remove the file update file/folder permission this activity changes the access permissions for a specific file or folder in google drive file id – enter the file id that identifies the specific file or folder for which you want to update permissions permission id – enter the permission id that specifies the particular permission you want to modify fields remove expiration – choose whether to remove the expiration date for the permission role – select the new role to assign, such as viewer, commenter, or editor transfer ownership – choose whether to transfer ownership of the file or folder to another user update file revision this activity modifies the metadata or settings of a specific revision of a file in google drive only users with editor or owner access can retrieve and update file revisions file id – enter the file id that identifies the file containing the revision you want to update revision id – enter the revision id that specifies the particular revision of the file you want to modify fields keep revision forever – choose whether to keep this revision permanently publish revision – select whether to publish the revision so it becomes visible publish revision outside the domain – decide if the revision should be accessible outside your organization’s domain republish subsequent revisions automatically – choose whether future revisions should be republished automatically download file this activity retrieves and downloads the content of a specified file from google drive to your local storage file id – enter the file id that identifies the specific file you want to download download file revision this activity retrieves and downloads a specific version of a file from google drive to your local storage, allowing you to access or restore previous file versions file id – enter the file id that identifies the file containing the revision you want to download revision id – enter the revision id that specifies the particular revision of the file you want to download copy file this activity creates a duplicate of an existing file in google drive drive id – enter the drive id that identifies the shared drive where the file is located or where the copy will be placed target folder id – enter the folder id of the destination folder where the copied file will be stored file id – enter the file id that identifies the specific file you want to copy fields copied file name – this field allows you to specify a new name for the copied file if left blank, the copied file will retain the original file’s name list of files/folders this activity retrieves a list of files and folders from google drive, allowing you to view or manage the contents of a specific directory or search results based on specified criteria drive id – enter the drive id to search within a specific shared drive if left empty, the search defaults to my drive folder id – enter the folder id to search within a specific folder if left empty, the search will include all folders according to the drive selection content type – choose whether to list only files, only folders, or both files and folders output – specify the output format, such as compact or detailed add filters – choose filters to refine the list of files or folders by criteria like creation time, file type, and text search for more targeted results add sorting – select a field and order (ascending/descending) to sort the list of files/folders top n – you can set the maximum number of files or folders engini will return during one workflow cycle (default = all items) move file/folder this activity transfers a file or folder from one location to another within google drive target drive id – enter the id of the shared drive where you want to move the file or folder if moving within my drive, leave this empty target folder id – enter the id of the destination folder where you want the file or folder to be moved file/folder id – enter the id of the specific file or folder you want to move to the target location rename file/folder this activity changes the name of a specific file or folder in google drive file/folder id – enter the id of the specific file or folder you want to rename new file/folder name – specify the new name you want to assign to the file or folder upload file this activity allows you to upload a file from your local storage to google drive, either as a new file or as a new version of an existing file drive id – enter the id of the shared drive where you want to upload the file if uploading to my drive, leave this empty folder id – specify the id of the folder within the drive where the file should be uploaded file name – enter the name you want to assign to the uploaded file file content – provide the content of the file in base64 string format to be uploaded to google drive