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,
  "assignmentInfo": {
    object (AssignmentInfo)
  }
}
필드
kind

string

출력 전용입니다. 리소스 유형입니다. 항상 'tasks#task'입니다.
id

string

작업 식별자입니다.
etag

string

리소스의 ETag입니다.
title

string

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

string

출력 전용입니다. 작업의 최종 수정 시간입니다 (RFC 3339 타임스탬프로 표시됨).
parent

string

출력 전용입니다. 상위 태스크 식별자입니다. 최상위 태스크인 경우 이 필드는 생략됩니다. 'move' 메서드를 사용하여 다른 상위 요소 아래로 또는 최상위로 할 일을 이동합니다. 상위 할 일은 할당된 할 일 (Chat 스페이스, Docs)이 될 수 없습니다. 이 필드는 읽기 전용입니다.
position

string

출력 전용입니다. 동일한 상위 태스크 아래 또는 최상위 수준의 동료 태스크 중에서 태스크의 위치를 나타내는 문자열입니다. 이 문자열이 사전순으로 다른 작업의 해당 위치 문자열보다 크면 작업이 동일한 상위 작업 아래 (또는 최상위 수준)에 있는 다른 작업 뒤에 배치됩니다. '이동' 메서드를 사용하여 할 일을 다른 위치로 이동합니다.
notes

string

할 일을 설명하는 메모입니다. Google Docs에서 할당된 할 일에는 메모를 추가할 수 없습니다. 선택사항입니다. 허용되는 최대 길이: 8,192자
status

string

할 일의 상태입니다. 'needsAction' 또는 'completed'입니다.
due

string

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

string

할 일의 완료일 (RFC 3339 타임스탬프로 표시됨)입니다. 작업이 완료되지 않은 경우 이 필드는 생략됩니다.
deleted

boolean

태스크가 삭제되었는지 여부를 나타내는 플래그입니다. 할당된 작업의 경우 이 필드는 읽기 전용입니다. 할당된 할 일은 tasks.delete를 호출하여만 삭제할 수 있으며, 이 경우 할당된 할 일과 원래 할 일 (Docs 또는 Chat 스페이스)이 모두 삭제됩니다. 할당된 작업만 삭제하려면 할당 표시 경로로 이동하여 할당을 해제합니다. 기본값은 False입니다.
hidden

boolean

할 일이 숨겨져 있는지 여부를 나타내는 플래그입니다. 할 일 목록을 마지막으로 지울 때 할 일이 완료로 표시된 경우 이러한 상황이 발생합니다. 기본값은 False입니다. 이 필드는 읽기 전용입니다.
links[].type

string

링크 유형입니다(예: 'email', 'generic', 'chat_message', 'keep_note').
links[].description

string

설명 (비어 있을 수 있음)
links[].link

string

URL입니다.
assignmentInfo

object (AssignmentInfo)

출력 전용입니다. 할당된 작업의 컨텍스트 정보입니다. 할 일을 사용자에게 할당할 수 있으며, 현재 Docs 및 Chat 스페이스와 같은 플랫폼에서 할당할 수 있습니다. 이 필드는 현재 사용자에게 할당된 태스크에 채워지며 태스크가 할당된 위치를 식별합니다. 이 필드는 읽기 전용입니다.

AssignmentInfo

할 일 할당 소스 (문서, Chat 스페이스)에 관한 정보입니다.

JSON 표현 
{
  "linkToTask": string,
  "surfaceType": enum (ContextType),

  // Union field surface_info can be only one of the following:
  "driveResourceInfo": {
    object (DriveResourceInfo)
  },
  "spaceInfo": {
    object (SpaceInfo)
  }
  // End of list of possible types for union field surface_info.
}
필드
surfaceType

enum (ContextType)

출력 전용입니다. 할당된 태스크가 출처인 노출 영역의 유형입니다. 현재 DOCUMENT 또는 SPACE로 제한됩니다.
통합 필드 surface_info. 이 할 일이 할당된 노출 영역 (Docs, Chat 스페이스)에 관한 정보입니다. surface_info은 다음 중 하나여야 합니다.
driveResourceInfo

object (DriveResourceInfo)

출력 전용입니다. 이 작업이 시작된 Drive 파일에 대한 정보입니다. 현재 Drive 파일은 문서만 될 수 있습니다. 이 필드는 읽기 전용입니다.
spaceInfo

object (SpaceInfo)

출력 전용입니다. 이 할 일이 발생한 Chat 스페이스에 대한 정보입니다. 이 필드는 읽기 전용입니다.

ContextType

작업과 연결된 제품입니다.

열거형
CONTEXT_TYPE_UNSPECIFIED 이 작업의 컨텍스트에 알 수 없는 값이 있습니다.
GMAIL Gmail에서 할 일이 생성됩니다.
DOCUMENT 문서에서 할당된 작업입니다.
SPACE Chat 스페이스에서 할 일이 할당됩니다.

DriveResourceInfo

작업이 할당된 Drive 리소스 (문서, 시트 등)에 대한 정보입니다.

JSON 표현 
{
  "driveFileId": string,
  "resourceKey": string
}
필드
driveFileId

string

출력 전용입니다. Drive API의 파일 식별자입니다.
resourceKey

string

출력 전용입니다. 공유 링크를 통해 공유된 파일에 액세스하는 데 필요한 리소스 키입니다. 일부 파일에는 필요하지 않습니다. developers.google.com/drive/api/guides/resource-keys도 참고하세요.

SpaceInfo

할 일이 할당된 Chat 스페이스에 대한 정보입니다.

JSON 표현 
{
  "space": string
}
필드
space

string

출력 전용입니다. 이 작업이 시작된 Chat 스페이스입니다. 형식은 'spaces/{space}'입니다.

메서드

clear

 지정된 할 일 목록에서 완료된 모든 할 일을 삭제합니다.

delete

 할 일 목록에서 지정된 할 일을 삭제합니다.

get

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

insert

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

list

 지정된 할 일 목록의 모든 할 일을 반환합니다.

move

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

patch

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

update

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