Использовать параметры задач
В дополнение к стандартным параметрам запроса, которые можно использовать с большинством API Google, существует набор параметров задач.
Параметры запроса, применимые только к определенным операциям в Google Tasks API, приведены в следующей таблице. Все значения параметров должны быть закодированы в URL.
| Параметр | Значение | Примечания | Применимость |
|---|
completedMax | Верхняя граница даты завершения задачи (как метка времени RFC 3339) для фильтрации. | - По умолчанию:
completedMax=2031-01-01 - Используйте формат отметки времени RFC 3339. Например:
2010-08-09T10:57:00.000-08:00
| |
completedMin | Нижняя граница даты завершения задачи (как метка времени RFC 3339) для фильтрации. | - По умолчанию:
completedMin=1970-01-01 - Используйте формат отметки времени RFC 3339. Например:
2010-08-09T10:57:00.000-08:00
| |
dueMax | Верхняя граница срока выполнения задачи (как метка времени RFC 3339) для фильтрации. | - По умолчанию:
dueMax=2031-01-01 - Используйте формат отметки времени RFC 3339. Например:
2010-08-09T10:57:00.000-08:00
| |
dueMin | Нижняя граница срока выполнения задачи (как метка времени RFC 3339) для фильтрации. | - По умолчанию:
dueMin=1970-01-01 - Используйте формат отметки времени RFC 3339. Например:
2010-08-09T10:57:00.000-08:00
| |
maxResults | Максимальное количество элементов, возвращаемых этим запросом. | - По умолчанию:
maxResults=20 - Максимально допустимое значение:
maxResults=100.
| - Получение списков задач пользователя
- Получение задач
|
pageToken | Токен, указывающий возвращаемую страницу результатов. | - По умолчанию возвращается первая страница.
| - Получение списков задач пользователя
- Получение задач
|
parent | Укажите идентификатор родительской задачи задачи. | - Отсутствие параметра указывает на вставку или перемещение на верхний уровень списка задач.
| - Создание задачи
- Заказ задачи
|
previous | Укажите идентификатор предыдущей задачи задачи. | - Ни один параметр не указывает на вставку или перемещение на первую позицию в подсписке.
| - Создание задачи
- Заказ задачи
|
showCompleted | Укажите, показывать ли выполненные задачи. | - По умолчанию:
showCompleted=true
| |
showDeleted | Укажите, показывать ли удаленные задачи. | - По умолчанию:
showDeleted=false
| |
showHidden | Укажите, показывать ли скрытые задачи. | - По умолчанию:
showHidden=true
| |
updatedMin | Нижняя граница времени последней модификации задачи (как метка времени RFC 3339) для фильтрации. | - Используйте формат отметки времени RFC 3339. Например:
2010-08-09T10:57:00.000-08:00Z . - По умолчанию фильтрация по времени последнего изменения не выполняется.
| |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-10-30 UTC.
[null,null,["Последнее обновление: 2024-10-30 UTC."],[[["In addition to standard query parameters, the Google Tasks API utilizes specific parameters for refined task management."],["These parameters control filtering by due dates, completion dates, modification times, and the visibility of completed, deleted, or hidden tasks."],["Developers can use these parameters to retrieve specific sets of tasks based on various criteria, such as completion status and due dates, using RFC 3339 timestamps for filtering."],["Parameters like `maxResults` and `pageToken` allow for pagination and control over the number of tasks returned in a response."],["The `parent` and `previous` parameters enable developers to manage task hierarchy and ordering within task lists."]]],["The Google Tasks API uses specific parameters for operations, all of which require URL encoding. These parameters filter tasks by `completedMin/Max`, `dueMin/Max`, and `updatedMin` date ranges using RFC 3339 timestamps. `maxResults` limits the number of returned items, and `pageToken` specifies the result page. `parent` and `previous` parameters determine task order, while `showCompleted`, `showDeleted`, and `showHidden` control the visibility of tasks. These parameters apply to retrieving tasks and task lists, creating, and ordering tasks.\n"]]
