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

출력 전용입니다. 동일한 상위 작업 아래 또는 최상위 수준에서 동위 작업 간의 작업 위치를 나타내는 문자열입니다. 이 문자열이 사전순에 따라 다른 작업의 해당 위치 문자열보다 크면 작업이 동일한 상위 작업 아래 (또는 최상위 수준)에서 다른 작업 뒤에 배치됩니다. 'move' 메서드를 사용하여 작업을 다른 위치로 이동합니다.
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 파일에 관한 정보입니다. 현재는 드라이브 파일이 문서여야 합니다. 이 필드는 읽기 전용입니다.
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

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