Documentation for Jira Checklist with Google Tasks Integration
Please note that actions such as creating, editing, or deleting tasks will also reflect in Google Tasks.
Our plugin integrates with Google Tasks to enhance functionality. Using OAuth2, the plugin allows users to create, edit, and delete Google task lists and tasks directly from Jira. We use task list IDs to synchronize tasks with Jira. Both the task list IDs are stored on Atlassian's systems. We do not store any other data from Google Tasks, and we do not send this data to any third parties.
Data Access and Sharing
We access Google API data only as necessary to provide the functionality of the plugin, including task list IDs. We do not access, store, or share any other Google user data beyond what is needed for the integration. All interactions with Google APIs comply with Google’s API policies, OAuth2 standards, and Atlassian's security practices. Data is securely handled and stored on Atlassian's systems, ensuring compliance with relevant data protection and privacy regulations.
1. Install
Go to the issue page
Find the "Checklist" plugin button.
Please note that the button may be in a drop-down menu
Click on the button
The plugin should appear above the "activity" section
If you do not see the plugin content, then click on the expand button
2. Grant Permissions
To work with the plugin, you need to provide access to your Google Tasks data. To do this, please click the "Configure access" button.
You will be redirected to a Google authorization page where you will see two screens:
Screen 1: Permissions Request
- This screen will display a message indicating that "Jira Checklist with Google Tasks Integration" is requesting access to your Google account.
- The plugin requires access to your Google account to connect to Jira on id.atlassian.com.
- Actions: By allowing access, the app will be able to perform the following actions on your account:
- Access Google Tasks:
https://www.googleapis.com/auth/tasks
- See details on how we handle this data in our privacy policy. - Access your email address:
https://www.googleapis.com/auth/userinfo.email
- See details on how we handle this data in our privacy policy. - Continue: Click "Continue" to proceed to the external site and provide the app with the necessary access.
- Access Google Tasks:
Authorization Confirmation
- Overview: This screen will show the following information:
- Google Tasks Access: The app will be able to create, edit, organize, and delete all your tasks.
- Proceed: If you agree with the terms, click "Allow" to grant the requested permissions.
- Overview: This screen will show the following information:
After completing the authorization process, you will be redirected back to the plugin. You should now have access to your Google Tasks data within the plugin.
3. Tasklist Tab
To start using the tasklist feature, you need to attach a tasklist to an issue.
Attach Tasklist: Click the "Attach Tasklist" button or navigate to the "Tasklist" tab to begin the process of attaching a tasklist to your Jira issue.
You should see the following screen:
Generate Title for Tasklist: You can generate a title for your tasklist by clicking the "Generate Title for Tasklist" button. This will help you name your tasklist appropriately.
Create New Tasklist: Click the "Create" button to create a new tasklist. Note that this will create a tasklist both in Jira and in Google Tasks.
Dropdown Menu: Click on the dropdown menu labeled "Tasklist".
View Tasklists: You will see a list of all your tasklists. Select the desired tasklist from the list to proceed with managing or viewing tasks.
Attach to Tasks Tab: After selecting a tasklist, click the "Attach to Tasks Tab" button. This will attach the selected tasklist to the Tasks tab of your Jira issue, allowing you to view and manage the tasks within Jira.
4. Tasks Tab
Navigate to Tasks Tab: Click on the "Tasks" tab within your Jira issue.
Verify Attachment: You should see the title of the attached tasklist displayed. This confirms that the tasklist has been successfully linked to your Jira issue and is now visible in the Tasks tab.
Create a New Task:
Add Title: In the "Add a task" input field, enter a title for your new task.
Create Task: Click the "Create" button to add the task to your tasklist.
Update Task Details:
Edit Details: Click on the "details" input field of the task you want to update. Modify the text as needed to update the task details.
Add Due Date:
Select Due Date: Click on the calendar icon next to the task. Choose the desired due date from the calendar to set a deadline for your task.
Add Subtask:
Add Subtask: Click the "..." button on the task to open the dropdown menu. Select "Add a subtask" to create and add a subtask under the main task.
Attach File:
Open File Menu: Click the "..." button on the task to open the dropdown menu.
Select Attach File: Choose "Attach File" from the dropdown menu.
Attach File: Select the file you wish to attach from your device and click the "+" button to attach it.