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

النتائج فقط. نوع المورد. وهي دائمًا "tasks#task".

id

string

معرِّف المهمة.

etag

string

علامة ETag للمورد.

title

string

تمثّل هذه السمة عنوان المهمة. الحد الأقصى المسموح به للطول: 1,024 حرفًا.

updated

string

النتائج فقط. وقت آخر تعديل للمهمة (كطابع زمني RFC 3339).

parent

string

النتائج فقط. معرّف المهمة الرئيسية يتم حذف هذا الحقل إذا كان مهمة ذات مستوى أعلى. استخدام الزر "نقل" لنقل المهمة تحت مسئول مختلف أو إلى المستوى الأعلى. لا يمكن أبدًا تعيين مهمة رئيسية (من مساحات Chat و"مستندات Google") للمهمة الرئيسية. هذا الحقل للقراءة فقط.

position

string

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

notes

string

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

status

string

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

due

string

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

completed

string

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

deleted

boolean

علامة تشير إلى ما إذا تم حذف المهمة هذا الحقل للقراءة فقط بالنسبة إلى المهام المحدّدة. لا يمكن حذفهما إلا من خلال استدعاء المهام.delete، وفي هذه الحالة، يتم حذف كل من المهمة المُسنَدة والمهمة الأصلية (في "مستندات Google" أو "مساحات Chat"). لحذف المهمة التي تم إسنادها فقط، انتقِل إلى مساحة عرض المهام وأسندها إليها. وتكون القيمة التلقائية False.

hidden

boolean

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

links[].type

string

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

links[].description

string

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

links[].link

string

عنوان URL

assignmentInfo

object (AssignmentInfo)

النتائج فقط. معلومات السياق للمهام المُسنَدة يمكن تعيين مهمة إلى مستخدم، وهو متاح حاليًا من مساحات عرض مثل "مستندات Google" و"مساحات 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. معلومات عن مساحة العرض ("مستندات Google" و"مساحات Chat") التي تم إسناد هذه المهمة منها يمكن أن يكون surface_info واحدًا فقط مما يلي:
driveResourceInfo

object (DriveResourceInfo)

النتائج فقط. معلومات عن ملف Drive الذي نشأت منه هذه المهمة. في الوقت الحالي، يمكن أن يكون ملف 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

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