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

نوع الرابط، مثل "البريد الإلكتروني"
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)

النتائج فقط. نوع السطح الذي نشأت منه هذه المهمة المُسنَدة. تقتصر حاليًا على "مستند" أو "مساحة".
حقل الربط 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

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