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 계열사의 등록 상표입니다.
최종 업데이트: 2024-09-03(UTC)
[null,null,["최종 업데이트: 2024-09-03(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"]]