REST Resource: tasks

منبع: وظیفه
نمایندگی 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

فقط خروجی نوع منبع این همیشه "وظایف# وظیفه" است.

id

string

شناسه وظیفه

etag

string

ETag منبع

title

string

عنوان تکلیف حداکثر طول مجاز: 1024 کاراکتر.

updated

string

فقط خروجی آخرین زمان تغییر کار (به عنوان مهر زمانی RFC 3339).

parent

string

فقط خروجی شناسه وظیفه والد. اگر یک کار سطح بالا باشد، این قسمت حذف می شود. از روش "Move" استفاده کنید تا کار را در زیر والدین متفاوت یا به سطح بالا حرکت دهید. وظیفه والد هرگز نمی تواند وظیفه ای اختصاص داده شده باشد (از Chat Spaces، Docs). این فیلد فقط خواندنی است.

position

string

فقط خروجی رشته ای که موقعیت تکلیف را در بین وظایف خواهر و برادر تحت همان وظیفه والد یا در سطح بالا نشان می دهد. اگر این رشته بر اساس ترتیب واژگانی، از رشته موقعیت متناظر کار دیگری بزرگتر باشد، وظیفه بعد از کار دیگر در زیر همان وظیفه والد (یا در سطح بالا) قرار می گیرد. از روش "حرکت" برای انتقال کار به موقعیت دیگری استفاده کنید.

notes

string

یادداشت هایی که وظیفه را توصیف می کند. وظایف محول شده از Google Docs نمی توانند یادداشت داشته باشند. اختیاری. حداکثر طول مجاز: 8192 کاراکتر.

status

string

وضعیت تکلیف این یا "needsAction" است یا "تکمیل شده".

due

string

تاریخ سررسید انجام کار (به عنوان مهر زمانی RFC 3339). اختیاری. تاریخ سررسید فقط اطلاعات تاریخ را ثبت می کند. هنگام تنظیم تاریخ سررسید، بخش زمانی مهر زمانی کنار گذاشته می شود. خواندن یا نوشتن زمان موعد انجام کار از طریق API امکان پذیر نیست.

completed

string

تاریخ تکمیل کار (به عنوان مهر زمانی RFC 3339). اگر کار تکمیل نشده باشد، این قسمت حذف می شود.

deleted

boolean

پرچم را نشان می دهد که آیا کار حذف شده است. برای وظایف محول شده، این قسمت فقط خواندنی است. آنها را فقط می توان با فراخوانی tasks.delete حذف کرد، در این صورت هم وظیفه تعیین شده و هم وظیفه اصلی (در Docs یا Chat Spaces) حذف می شوند. برای حذف فقط وظیفه اختصاص داده شده، به سطح تخصیص رفته و از آنجا تکلیف را لغو کنید. پیش فرض نادرست است.

hidden

boolean

پرچم را نشان می دهد که آیا کار پنهان است یا خیر. این در صورتی است که کار در آخرین پاک شدن لیست کار به پایان رسیده باشد. پیش فرض نادرست است. این فیلد فقط خواندنی است.

links[].type

string

نوع پیوند، به عنوان مثال "email"، "generic"، "chat_message"، "keep_note".

links[].description

string

توضیحات (ممکن است خالی باشد).

links[].link

string

URL.

assignmentInfo

object ( AssignmentInfo )

فقط خروجی اطلاعات زمینه برای وظایف محول شده یک کار را می توان به یک کاربر اختصاص داد که در حال حاضر از سطوحی مانند Docs و Chat Spaces امکان پذیر است. این فیلد برای کارهایی که به کاربر فعلی تخصیص داده شده است پر می شود و مشخص می کند که کار از کجا تعیین شده است. این فیلد فقط خواندنی است.

AssignmentInfo

اطلاعات مربوط به منبع تکلیف (سند، فضای گفتگو).

نمایندگی 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 . اطلاعات مربوط به سطح (سندنگار، فضاهای گپ) که این کار از آنجا تعیین شده است. surface_info فقط می تواند یکی از موارد زیر باشد:
driveResourceInfo

object ( DriveResourceInfo )

فقط خروجی اطلاعات مربوط به فایل Drive که این کار از آنجا منشا گرفته است. در حال حاضر، فایل Drive فقط می‌تواند یک سند باشد. این فیلد فقط خواندنی است.

spaceInfo

object ( SpaceInfo )

فقط خروجی اطلاعاتی در مورد فضای چت که این کار از آنجا منشا گرفته است. این فیلد فقط خواندنی است.

ContextType

محصول مرتبط با کار.

Enums
CONTEXT_TYPE_UNSPECIFIED مقدار نامشخص برای زمینه این کار.
GMAIL وظیفه از جیمیل ایجاد شده است.
DOCUMENT وظیفه از یک سند تعیین می شود.
SPACE وظیفه از فضای چت اختصاص داده شده است.
DriveResourceInfo

اطلاعات مربوط به منبع Drive که یک کار از آنجا تعیین شده است (سند، برگه و غیره).

نمایندگی JSON 
{
  "driveFileId": string,
  "resourceKey": string
}
فیلدها
driveFileId

string

فقط خروجی شناسه فایل در Drive API.

resourceKey

string

فقط خروجی کلید منبع مورد نیاز برای دسترسی به فایل های به اشتراک گذاشته شده از طریق پیوند مشترک. برای همه فایل ها لازم نیست به developers.google.com/drive/api/guides/resource-keys نیز مراجعه کنید.

SpaceInfo

اطلاعاتی در مورد فضای چت که از آنجا یک کار تعیین شده است.

نمایندگی JSON 
{
  "space": string
}
فیلدها
space

string

فقط خروجی فضای چت که این کار از آنجا سرچشمه می گیرد. قالب "space/{space}" است.

روش ها
clear تمام کارهای تکمیل شده را از لیست وظایف مشخص شده پاک می کند.
delete وظیفه مشخص شده را از لیست وظایف حذف می کند.
get وظیفه مشخص شده را برمی گرداند.
insert یک کار جدید در لیست وظایف مشخص شده ایجاد می کند.
list تمام وظایف موجود در لیست وظایف مشخص شده را برمی گرداند.
move وظیفه مشخص شده را به موقعیت دیگری در لیست کار مقصد منتقل می کند.
patch وظیفه مشخص شده را به روز می کند.
update وظیفه مشخص شده را به روز می کند.