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

리소스의 eETag입니다.

title

string

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

updated

string

출력 전용입니다. 작업의 마지막 수정 시간 (RFC 3339 타임스탬프)

parent

string

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

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

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