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

الملاحظات التي تصف المهمة. اختياريّ. الحدّ الأقصى للطول المسموح به: 8192 حرفًا.

status

string

حالة المهمة وَهْيَ إما "needsAction" أو "مكتمل".

due

string

تاريخ إنجاز المهمة (كطابع زمني RFC 3339). اختياريّ. لا يسجِّل تاريخ التسليم سوى معلومات التاريخ، ويتم تجاهل جزء الوقت من الطابع الزمني عند تحديد تاريخ التسليم. لا يمكن قراءة أو كتابة الوقت المحدد لمهمة ما عبر واجهة برمجة التطبيقات.

completed

string

تاريخ اكتمال المهمة (كطابع زمني RFC 3339). يتم حذف هذا الحقل إذا لم تكتمل المهمة.

deleted

boolean

علامة تشير إلى ما إذا كان قد تم حذف المهمة والقيمة التلقائية هي "خطأ".

hidden

boolean

علامة تشير إلى إخفاء المهمة ويحدث هذا في حال وضع علامة على المهمة باعتبارها مكتملة في آخر مرة تم فيها محو قائمة المهام. والقيمة التلقائية هي "خطأ". هذا الحقل للقراءة فقط.

links[].type

string

نوع الرابط، مثل "بريد إلكتروني".

links[].description

string

الوصف. في HTML، تحدث: كل شيء بين <a> و </a>.

links[].link

string

عنوان URL.

الطُرق

clear

يؤدي إلى محو جميع المهام المكتملة من قائمة المهام المحددة.

delete

حذف المهمة المحددة من قائمة المهام

get

لعرض المهمة المحددة

insert

إنشاء مهمة جديدة في قائمة المهام المحددة

list

عرض جميع المهام في قائمة المهام المحددة

move

نقل المهمة المحددة إلى موضع آخر في قائمة المهام

patch

لتعديل المهمة المحدَّدة

update

لتعديل المهمة المحدَّدة