Class: Google::Apis::TasksV1::TasksService
- Inherits:
-
Core::BaseService
- Object
- Core::BaseService
- Google::Apis::TasksV1::TasksService
- Defined in:
- lib/google/apis/tasks_v1/service.rb
Overview
Google Tasks API
The Google Tasks API lets you manage your tasks and task lists.
Constant Summary collapse
- DEFAULT_ENDPOINT_TEMPLATE =
"https://tasks.$UNIVERSE_DOMAIN$/"
Instance Attribute Summary collapse
-
#key ⇒ String
API key.
-
#quota_user ⇒ String
Available to use for quota purposes for server-side applications.
Instance Method Summary collapse
-
#clear_task(tasklist, fields: nil, quota_user: nil, options: nil) {|result, err| ... }
Clears all completed tasks from the specified task list.
-
#delete_task(tasklist, task, fields: nil, quota_user: nil, options: nil) {|result, err| ... }
Deletes the specified task from the task list.
-
#delete_tasklist(tasklist, fields: nil, quota_user: nil, options: nil) {|result, err| ... }
Deletes the authenticated user's specified task list.
-
#get_task(tasklist, task, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Task
Returns the specified task.
-
#get_tasklist(tasklist, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::TaskList
Returns the authenticated user's specified task list.
-
#initialize ⇒ TasksService
constructor
A new instance of TasksService.
-
#insert_task(tasklist, task_object = nil, parent: nil, previous: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Task
Creates a new task on the specified task list.
-
#insert_tasklist(task_list_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::TaskList
Creates a new task list and adds it to the authenticated user's task lists.
-
#list_tasklists(max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::TaskLists
Returns all the authenticated user's task lists.
-
#list_tasks(tasklist, completed_max: nil, completed_min: nil, due_max: nil, due_min: nil, max_results: nil, page_token: nil, show_completed: nil, show_deleted: nil, show_hidden: nil, updated_min: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Tasks
Returns all tasks in the specified task list.
-
#move_task(tasklist, task, parent: nil, previous: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Task
Moves the specified task to another position in the task list.
-
#patch_task(tasklist, task, task_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Task
Updates the specified task.
-
#patch_tasklist(tasklist, task_list_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::TaskList
Updates the authenticated user's specified task list.
-
#update_task(tasklist, task, task_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Task
Updates the specified task.
-
#update_tasklist(tasklist, task_list_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::TaskList
Updates the authenticated user's specified task list.
Constructor Details
#initialize ⇒ TasksService
Returns a new instance of TasksService.
47 48 49 50 51 52 |
# File 'lib/google/apis/tasks_v1/service.rb', line 47 def initialize super(DEFAULT_ENDPOINT_TEMPLATE, '', client_name: 'google-apis-tasks_v1', client_version: Google::Apis::TasksV1::GEM_VERSION) @batch_path = 'batch' end |
Instance Attribute Details
#key ⇒ String
Returns API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
40 41 42 |
# File 'lib/google/apis/tasks_v1/service.rb', line 40 def key @key end |
#quota_user ⇒ String
Returns Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
45 46 47 |
# File 'lib/google/apis/tasks_v1/service.rb', line 45 def quota_user @quota_user end |
Instance Method Details
#clear_task(tasklist, fields: nil, quota_user: nil, options: nil) {|result, err| ... }
This method returns an undefined value.
Clears all completed tasks from the specified task list. The affected tasks will be marked as 'hidden' and no longer be returned by default when retrieving all tasks for a task list.
267 268 269 270 271 272 273 |
# File 'lib/google/apis/tasks_v1/service.rb', line 267 def clear_task(tasklist, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'tasks/v1/lists/{tasklist}/clear', ) command.params['tasklist'] = tasklist unless tasklist.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#delete_task(tasklist, task, fields: nil, quota_user: nil, options: nil) {|result, err| ... }
This method returns an undefined value.
Deletes the specified task from the task list.
297 298 299 300 301 302 303 304 |
# File 'lib/google/apis/tasks_v1/service.rb', line 297 def delete_task(tasklist, task, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'tasks/v1/lists/{tasklist}/tasks/{task}', ) command.params['tasklist'] = tasklist unless tasklist.nil? command.params['task'] = task unless task.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#delete_tasklist(tasklist, fields: nil, quota_user: nil, options: nil) {|result, err| ... }
This method returns an undefined value.
Deletes the authenticated user's specified task list.
74 75 76 77 78 79 80 |
# File 'lib/google/apis/tasks_v1/service.rb', line 74 def delete_tasklist(tasklist, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'tasks/v1/users/@me/lists/{tasklist}', ) command.params['tasklist'] = tasklist unless tasklist.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#get_task(tasklist, task, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Task
Returns the specified task.
328 329 330 331 332 333 334 335 336 337 |
# File 'lib/google/apis/tasks_v1/service.rb', line 328 def get_task(tasklist, task, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'tasks/v1/lists/{tasklist}/tasks/{task}', ) command.response_representation = Google::Apis::TasksV1::Task::Representation command.response_class = Google::Apis::TasksV1::Task command.params['tasklist'] = tasklist unless tasklist.nil? command.params['task'] = task unless task.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#get_tasklist(tasklist, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::TaskList
Returns the authenticated user's specified task list.
102 103 104 105 106 107 108 109 110 |
# File 'lib/google/apis/tasks_v1/service.rb', line 102 def get_tasklist(tasklist, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'tasks/v1/users/@me/lists/{tasklist}', ) command.response_representation = Google::Apis::TasksV1::TaskList::Representation command.response_class = Google::Apis::TasksV1::TaskList command.params['tasklist'] = tasklist unless tasklist.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#insert_task(tasklist, task_object = nil, parent: nil, previous: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Task
Creates a new task on the specified task list. A user can have up to 20,000 non-hidden tasks per list and up to 100,000 tasks in total at a time.
367 368 369 370 371 372 373 374 375 376 377 378 379 |
# File 'lib/google/apis/tasks_v1/service.rb', line 367 def insert_task(tasklist, task_object = nil, parent: nil, previous: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'tasks/v1/lists/{tasklist}/tasks', ) command.request_representation = Google::Apis::TasksV1::Task::Representation command.request_object = task_object command.response_representation = Google::Apis::TasksV1::Task::Representation command.response_class = Google::Apis::TasksV1::Task command.params['tasklist'] = tasklist unless tasklist.nil? command.query['parent'] = parent unless parent.nil? command.query['previous'] = previous unless previous.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#insert_tasklist(task_list_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::TaskList
Creates a new task list and adds it to the authenticated user's task lists. A user can have up to 2000 lists at a time.
132 133 134 135 136 137 138 139 140 141 |
# File 'lib/google/apis/tasks_v1/service.rb', line 132 def insert_tasklist(task_list_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'tasks/v1/users/@me/lists', ) command.request_representation = Google::Apis::TasksV1::TaskList::Representation command.request_object = task_list_object command.response_representation = Google::Apis::TasksV1::TaskList::Representation command.response_class = Google::Apis::TasksV1::TaskList command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#list_tasklists(max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::TaskLists
Returns all the authenticated user's task lists. A user can have up to 2000 lists at a time.
167 168 169 170 171 172 173 174 175 176 |
# File 'lib/google/apis/tasks_v1/service.rb', line 167 def list_tasklists(max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'tasks/v1/users/@me/lists', ) command.response_representation = Google::Apis::TasksV1::TaskLists::Representation command.response_class = Google::Apis::TasksV1::TaskLists command.query['maxResults'] = max_results unless max_results.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#list_tasks(tasklist, completed_max: nil, completed_min: nil, due_max: nil, due_min: nil, max_results: nil, page_token: nil, show_completed: nil, show_deleted: nil, show_hidden: nil, updated_min: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Tasks
Returns all tasks in the specified task list. A user can have up to 20,000 non- hidden tasks per list and up to 100,000 tasks in total at a time.
432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 |
# File 'lib/google/apis/tasks_v1/service.rb', line 432 def list_tasks(tasklist, completed_max: nil, completed_min: nil, due_max: nil, due_min: nil, max_results: nil, page_token: nil, show_completed: nil, show_deleted: nil, show_hidden: nil, updated_min: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'tasks/v1/lists/{tasklist}/tasks', ) command.response_representation = Google::Apis::TasksV1::Tasks::Representation command.response_class = Google::Apis::TasksV1::Tasks command.params['tasklist'] = tasklist unless tasklist.nil? command.query['completedMax'] = completed_max unless completed_max.nil? command.query['completedMin'] = completed_min unless completed_min.nil? command.query['dueMax'] = due_max unless due_max.nil? command.query['dueMin'] = due_min unless due_min.nil? command.query['maxResults'] = max_results unless max_results.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['showCompleted'] = show_completed unless show_completed.nil? command.query['showDeleted'] = show_deleted unless show_deleted.nil? command.query['showHidden'] = show_hidden unless show_hidden.nil? command.query['updatedMin'] = updated_min unless updated_min.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#move_task(tasklist, task, parent: nil, previous: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Task
Moves the specified task to another position in the task list. This can include putting it as a child task under a new parent and/or move it to a different position among its sibling tasks. A user can have up to 2,000 subtasks per task.
483 484 485 486 487 488 489 490 491 492 493 494 |
# File 'lib/google/apis/tasks_v1/service.rb', line 483 def move_task(tasklist, task, parent: nil, previous: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'tasks/v1/lists/{tasklist}/tasks/{task}/move', ) command.response_representation = Google::Apis::TasksV1::Task::Representation command.response_class = Google::Apis::TasksV1::Task command.params['tasklist'] = tasklist unless tasklist.nil? command.params['task'] = task unless task.nil? command.query['parent'] = parent unless parent.nil? command.query['previous'] = previous unless previous.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#patch_task(tasklist, task, task_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Task
Updates the specified task. This method supports patch semantics.
519 520 521 522 523 524 525 526 527 528 529 530 |
# File 'lib/google/apis/tasks_v1/service.rb', line 519 def patch_task(tasklist, task, task_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:patch, 'tasks/v1/lists/{tasklist}/tasks/{task}', ) command.request_representation = Google::Apis::TasksV1::Task::Representation command.request_object = task_object command.response_representation = Google::Apis::TasksV1::Task::Representation command.response_class = Google::Apis::TasksV1::Task command.params['tasklist'] = tasklist unless tasklist.nil? command.params['task'] = task unless task.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#patch_tasklist(tasklist, task_list_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::TaskList
Updates the authenticated user's specified task list. This method supports patch semantics.
200 201 202 203 204 205 206 207 208 209 210 |
# File 'lib/google/apis/tasks_v1/service.rb', line 200 def patch_tasklist(tasklist, task_list_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:patch, 'tasks/v1/users/@me/lists/{tasklist}', ) command.request_representation = Google::Apis::TasksV1::TaskList::Representation command.request_object = task_list_object command.response_representation = Google::Apis::TasksV1::TaskList::Representation command.response_class = Google::Apis::TasksV1::TaskList command.params['tasklist'] = tasklist unless tasklist.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#update_task(tasklist, task, task_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::Task
Updates the specified task.
555 556 557 558 559 560 561 562 563 564 565 566 |
# File 'lib/google/apis/tasks_v1/service.rb', line 555 def update_task(tasklist, task, task_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:put, 'tasks/v1/lists/{tasklist}/tasks/{task}', ) command.request_representation = Google::Apis::TasksV1::Task::Representation command.request_object = task_object command.response_representation = Google::Apis::TasksV1::Task::Representation command.response_class = Google::Apis::TasksV1::Task command.params['tasklist'] = tasklist unless tasklist.nil? command.params['task'] = task unless task.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |
#update_tasklist(tasklist, task_list_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TasksV1::TaskList
Updates the authenticated user's specified task list.
233 234 235 236 237 238 239 240 241 242 243 |
# File 'lib/google/apis/tasks_v1/service.rb', line 233 def update_tasklist(tasklist, task_list_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:put, 'tasks/v1/users/@me/lists/{tasklist}', ) command.request_representation = Google::Apis::TasksV1::TaskList::Representation command.request_object = task_list_object command.response_representation = Google::Apis::TasksV1::TaskList::Representation command.response_class = Google::Apis::TasksV1::TaskList command.params['tasklist'] = tasklist unless tasklist.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end |