지정된 할 일 목록의 모든 작업을 반환합니다. 할당된 할 일을 기본값으로 반환하지 않습니다 (Docs, Chat 스페이스에서). 사용자는 목록당 숨기지 않은 할 일을 최대 20,000개까지 한 번에 최대 100,000개까지 보유할 수 있습니다.
HTTP 요청
GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
tasklist |
할 일 목록 식별자입니다. |
쿼리 매개변수
매개변수 | |
---|---|
completedMax |
필터링할 작업 완료 날짜의 상한값 (RFC 3339 타임스탬프)입니다. 선택사항입니다. 기본적으로 완료일을 기준으로 필터링하지 않습니다. |
completedMin |
필터링할 작업 완료 날짜의 하한값 (RFC 3339 타임스탬프)입니다. 선택사항입니다. 기본적으로 완료일을 기준으로 필터링하지 않습니다. |
dueMax |
필터링할 작업 마감일의 상한값 (RFC 3339 타임스탬프)입니다. 선택사항입니다. 기본적으로 기한별로 필터링하지 않습니다. |
dueMin |
필터링할 작업 마감일의 하한값 (RFC 3339 타임스탬프)입니다. 선택사항입니다. 기본적으로 기한별로 필터링하지 않습니다. |
maxResults |
한 페이지에서 반환되는 최대 태스크 수 선택사항입니다. 기본값은 20입니다 (최대 허용 수: 100). |
pageToken |
반환할 결과 페이지를 지정하는 토큰입니다. 선택사항입니다. |
showCompleted |
완료된 작업이 결과에 반환되는지 여부를 나타내는 플래그입니다. 웹 UI 및 Google의 모바일 앱과 같은 퍼스트 파티 클라이언트에서 완료된 작업을 표시하려면 showHidden도 True여야 합니다. 선택사항입니다. 기본값은 True입니다. |
showDeleted |
삭제된 작업이 결과에 반환되는지 여부를 나타내는 플래그. 선택사항입니다. 기본값은 False입니다. |
updatedMin |
작업의 마지막 수정 시간 (RFC 3339 타임스탬프)의 하한값입니다. 선택사항입니다. 기본적으로 마지막 수정 시간을 기준으로 필터링하지 않습니다. |
showAssigned |
선택사항입니다. 현재 사용자에게 할당된 작업이 결과에 반환되는지 여부를 나타내는 플래그. 선택사항입니다. 기본값은 False입니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
JSON 표현 |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
입력란 | |
---|---|
kind |
리소스의 유형입니다. 항상 '할 일#할 일'입니다. |
etag |
리소스의 eETag입니다. |
nextPageToken |
이 결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다. |
items[] |
작업 컬렉션입니다. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/tasks
https://www.googleapis.com/auth/tasks.readonly
자세한 내용은 승인 가이드를 참조하세요.
작업
JSON 표현 |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
입력란 | |
---|---|
kind |
리소스의 유형입니다. 항상 '할 일#할 일'입니다. |
etag |
리소스의 eETag입니다. |
nextPageToken |
이 결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다. |
items[] |
작업 컬렉션입니다. |