Tasks 매개변수 사용
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
대부분의 Google API에서 사용할 수 있는 표준 쿼리 매개변수 외에 Tasks 매개변수 세트가 있습니다.
다음 표에는 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 |
작업의 상위 작업 ID를 지정합니다. |
- 할 일 목록의 최상위 수준으로의 삽입 또는 이동을 나타내는 매개변수는 없습니다.
|
|
previous |
작업의 이전 작업 ID를 지정합니다. |
- 하위 목록의 첫 번째 위치로의 삽입 또는 이동을 나타내는 매개변수는 없습니다.
|
|
showCompleted |
완료된 할 일을 표시할지 여부를 지정합니다. |
|
|
showDeleted |
삭제된 할 일을 표시할지 여부를 지정합니다. |
|
|
showHidden |
숨겨진 할 일을 표시할지 여부를 지정합니다. |
|
|
updatedMin |
필터링할 최종 수정 시간의 하한값입니다 (RFC 3339 타임스탬프). |
- RFC 3339 타임스탬프 형식을 사용하세요. 예:
2010-08-09T10:57:00.000-08:00Z
- 기본값은 마지막 수정 시간을 기준으로 필터링하지 않는 것입니다.
|
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Use Tasks Parameters\n\nIn addition to the standard query parameters that can be used with most Google APIs, there is a set of Tasks parameters.\n\nRequest parameters that apply only to specific operations in the Google Tasks API are summarized in the following table. All parameter values need to be URL encoded.\n\n| Parameter | Meaning | Notes | Applicability |\n|-----------------|------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|\n| `completedMax` | Upper bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `completedMin` | Lower bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMax` | Upper bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMin` | Lower bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `maxResults` | The maximum number of elements to return with this request. | - Default: `maxResults=20` - Maximum allowable value: `maxResults=100.` | - Retrieving a user's task lists - Retrieving tasks |\n| `pageToken` | Token specifying the result page to return. | - The default is to return the first page. | - Retrieving a user's task lists - Retrieving tasks |\n| `parent` | Specify the task's parent task ID. | - No parameter indicates an insertion or a move to the top level of the task list. | - Creating a task - Ordering a task |\n| `previous` | Specify the task's previous task ID. | - No parameter indicates an insertion or a move to the first position in the sublist. | - Creating a task - Ordering a task |\n| `showCompleted` | Specify whether or not to show completed tasks. | - Default: `showCompleted=true` | - Retrieving tasks |\n| `showDeleted` | Specify whether or not to show deleted tasks. | - Default: `showDeleted=false` | - Retrieving tasks |\n| `showHidden` | Specify whether or not to show hidden tasks. | - Default: `showHidden=true` | - Retrieving tasks |\n| `updatedMin` | Lower bound for a task's last modification time (as an RFC 3339 timestamp) to filter by. | - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00Z`. - The default is not to filter by last modification time. | - Retrieving tasks |"]]