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

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

position

string

النتائج فقط. سلسلة تشير إلى موضع المهمة بين المهام التابعة لها ضمن نفس المهمة الرئيسية أو في المستوى الأعلى. إذا كانت هذه السلسلة أكبر من سلسلة الموضع المقابلة لمهمة أخرى وفقًا للترتيب اللغوي، يتم وضع المهمة بعد المهمة الأخرى ضمن نفس المهمة الرئيسية (أو في المستوى الأعلى). استخدِم طريقة "move" لنقل المهمة إلى موضع آخر.

notes

string

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

status

string

حالة المهمة هذه السمة إما "needsAction" أو "مكتملة".

due

string

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

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

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