REST Resource: tasks

리소스: Task

JSON 표현
{
  "kind": string,
  "id": string,
  "etag": string,
  "title": string,
  "updated": string,
  "selfLink": string,
  "parent": string,
  "position": string,
  "notes": string,
  "status": string,
  "due": string,
  "completed": string,
  "deleted": boolean,
  "hidden": boolean,
  "links": [
    {
      "type": string,
      "description": string,
      "link": string
    }
  ],
  "webViewLink": string
}
입력란
kind

string

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

id

string

할 일 식별자.

etag

string

리소스의 ETag입니다.

title

string

할 일의 제목입니다. 허용되는 최대 길이는 1,024자(영문 기준)입니다.

updated

string

작업이 마지막으로 수정된 시간입니다 (RFC 3339 타임스탬프로).

parent

string

상위 작업 식별자입니다. 최상위 작업인 경우 이 필드는 생략됩니다. 이 필드는 읽기 전용입니다. '이동' 메서드를 사용하여 할 일을 다른 상위 요소 아래 또는 최상위 수준으로 이동합니다.

position

string

동일한 상위 작업 아래 또는 최상위 수준에 있는 동위 작업 간의 작업 위치를 나타내는 문자열입니다. 사전 순서에 따라 이 문자열이 다른 작업의 해당 위치 문자열보다 크면 작업은 동일한 상위 작업 아래 (또는 최상위 수준)에 다른 작업 뒤에 배치됩니다. 이 필드는 읽기 전용입니다. 'move' 메서드를 사용하여 할 일을 다른 위치로 이동합니다.

notes

string

작업을 설명하는 메모입니다. 선택사항입니다. 허용되는 최대 길이는 8,192자(영문 기준)입니다.

status

string

작업의 상태입니다. 'needsAction' 또는 'completed'입니다.

due

string

태스크 기한 (RFC 3339 타임스탬프)입니다. 선택사항입니다. 마감일은 날짜 정보만 기록합니다. 마감일을 설정할 때 타임스탬프의 시간 부분은 삭제됩니다. API를 통해 작업 마감 시간을 읽거나 쓸 수 없습니다.

completed

string

작업 완료 날짜 (RFC 3339 타임스탬프로) 작업이 완료되지 않으면 이 필드는 생략됩니다.

deleted

boolean

할 일이 삭제되었는지 여부를 나타내는 플래그. 기본값은 False입니다.

hidden

boolean

작업이 숨겨져 있는지 여부를 나타내는 플래그. 이는 할 일 목록이 마지막으로 지워졌을 때 할 일이 완료로 표시된 경우입니다. 기본값은 False입니다. 이 필드는 읽기 전용입니다.

links[].type

string

링크의 유형입니다(예: '이메일').

links[].description

string

설명입니다. HTML 말하기: <a>와 </a> 사이의 모든 문자를 사용합니다.

links[].link

string

URL입니다.

방법

clear

지정된 작업 목록에서 완료된 모든 작업을 지웁니다.

delete

작업 목록에서 지정된 작업을 삭제합니다.

get

지정된 작업을 반환합니다.

insert

지정된 할 일 목록에 새 할 일을 만듭니다.

list

지정된 작업 목록의 모든 작업을 반환합니다.

move

지정된 할 일을 할 일 목록의 다른 위치로 이동합니다.

patch

지정된 작업을 업데이트합니다.

update

지정된 작업을 업데이트합니다.