Method: tasks.list

지정된 할 일 목록의 모든 할 일을 반환합니다. 기본적으로 할당된 할 일 (Docs, Chat 스페이스)을 반환하지 않습니다. 사용자는 목록당 최대 20,000개의 숨겨지지 않은 할 일을 보유할 수 있으며 한 번에 최대 100,000개의 할 일을 보유할 수 있습니다.

HTTP 요청

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
tasklist

string

할 일 목록 식별자입니다.

쿼리 매개변수

매개변수
completedMax

string

필터링할 할 일 완료일의 상한 (RFC 3339 타임스탬프로 표시됨)입니다. 선택사항입니다. 기본적으로 완료일을 기준으로 필터링하지 않습니다.
completedMin

string

필터링할 할 일 완료 날짜의 하한값 (RFC 3339 타임스탬프로 표시됨)입니다. 선택사항입니다. 기본적으로 완료일을 기준으로 필터링하지 않습니다.
dueMax

string

필터링할 작업의 기한 상한 (RFC 3339 타임스탬프로 표시됨)입니다. 선택사항입니다. 기본적으로 마감일을 기준으로 필터링하지 않습니다.
dueMin

string

필터링할 할 일의 기한 하한 (RFC 3339 타임스탬프로 표시됨)입니다. 선택사항입니다. 기본적으로 마감일을 기준으로 필터링하지 않습니다.
maxResults

integer

페이지 하나에 반환되는 태스크의 최대 수입니다. 선택사항입니다. 기본값은 20이고 허용되는 최대값은 100입니다.
pageToken

string

반환할 결과 페이지를 지정하는 토큰입니다. 선택사항입니다.
showCompleted

boolean

완료된 할 일이 결과에 반환되는지 여부를 나타내는 플래그입니다. 웹 UI 및 Google의 모바일 앱과 같은 퍼스트 파티 클라이언트에서 완료된 할 일을 표시하려면 showHidden도 true여야 합니다. 선택사항입니다. 기본값은 true입니다.
showDeleted

boolean

삭제된 태스크가 결과에 반환되는지 여부를 나타내는 플래그입니다. 선택사항입니다. 기본값은 False입니다.
showHidden

boolean

숨겨진 태스크가 결과에 반환되는지 여부를 나타내는 플래그입니다. 선택사항입니다. 기본값은 False입니다.
updatedMin

string

필터링할 작업의 마지막 수정 시간 하한값 (RFC 3339 타임스탬프로 표시됨)입니다. 선택사항입니다. 기본적으로 마지막 수정 시간을 기준으로 필터링하지 않습니다.
showAssigned

boolean

선택사항입니다. 현재 사용자에게 할당된 작업이 결과에 반환되는지 여부를 나타내는 플래그입니다. 선택사항입니다. 기본값은 False입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
필드
kind

string

리소스 유형입니다. 항상 'tasks#tasks'입니다.
etag

string

리소스의 ETag입니다.
nextPageToken

string

이 결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다.
items[]

object (Task)

할 일 모음입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

자세한 내용은 승인 가이드를 참고하세요.

작업

JSON 표현 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
필드
kind

string

리소스 유형입니다. 항상 'tasks#tasks'입니다.
etag

string

리소스의 ETag입니다.
nextPageToken

string

이 결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다.
items[]

object (Task)

할 일 모음입니다.