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

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

string

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

string

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

string

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

string

ملاحظات تصف المهمة لا يمكن أن تتضمّن المهام المُسندة من "مستندات Google" ملاحظات. اختيارية: الحد الأقصى للطول المسموح به: 8192 حرفًا.
status

string

تمثّل هذه السمة حالة المهمة. تكون القيمة إما "needsAction" أو "completed".
due

string

تاريخ جدولة المهمة (كطابع زمني RFC 3339). اختيارية: يمثّل هذا الحقل اليوم الذي يجب إكمال المهمة فيه أو اليوم الذي تظهر فيه المهمة في شبكة التقويم. ولا يمثّل الموعد النهائي للمهمة. يتم تسجيل معلومات التاريخ فقط، ويتم تجاهل جزء الوقت من الطابع الزمني عند ضبط هذا الحقل. لا يمكن قراءة أو كتابة الوقت المحدّد لمهمة باستخدام واجهة برمجة التطبيقات.
completed

string

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

boolean

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

boolean

علامة تشير إلى ما إذا كانت المهمة مخفية. ويحدث ذلك إذا تم وضع علامة "مكتملة" على المهمة عند آخر مرة تم فيها محو قائمة المهام. القيمة التلقائية هي False. هذا الحقل مخصّص للقراءة فقط.
links[].type

string

نوع الرابط، مثل "email" أو "generic" أو "chat_message" أو "keep_note"
links[].description

string

الوصف (قد يكون فارغًا)
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

 تعدّل هذه الطريقة المهمة المحدّدة.