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
}
שדות
kind

string

סוג המשאב. זו תמיד "tasks#task".

id

string

מזהה המשימה.

etag

string

ה-ETag של המשאב.

title

string

שם המשימה. האורך המקסימלי המותר: 1,024 תווים.

updated

string

מועד השינוי האחרון של המשימה (כחותמת זמן RFC 3339).

parent

string

מזהה המשימה הראשית. השדה הזה יושמט אם זו משימה ברמה עליונה. השדה הזה הוא לקריאה בלבד. אפשר להשתמש בשיטה 'העברה' כדי להעביר את המשימה להורים אחרים או לרמה העליונה שלה.

position

string

מחרוזת שמציינת את מיקום המשימה בין המשימות הבאות שלה באותה משימה ברמה העליונה או ברמה העליונה. אם המחרוזת הזו גדולה ממחרוזת המיקום התואמת של משימה אחרת לפי הסדר המילולי, היא תמוקם אחרי המשימה השנייה באותה משימת הורה (או ברמה העליונה). השדה הזה הוא לקריאה בלבד. אפשר להשתמש בשיטה 'העברה' כדי להעביר את המשימה למיקום אחר.

notes

string

הערות שמתארות את המשימה. זה שינוי אופציונלי. האורך המקסימלי המותר: 8,192 תווים.

status

string

הסטטוס של המשימה. השדה הוא "needsAction" או "complete".

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

מתבצע עדכון של המשימה שצוינה.