المورد: مهمة
تمثيل 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 ( |
الحقول | |
---|---|
kind |
النتائج فقط. نوع المورد. وهي دائمًا "tasks#task". |
id |
معرِّف المهمة. |
etag |
علامة ETag للمورد. |
title |
تمثّل هذه السمة عنوان المهمة. الحد الأقصى المسموح به للطول: 1,024 حرفًا. |
updated |
النتائج فقط. وقت آخر تعديل للمهمة (كطابع زمني RFC 3339). |
selfLink |
النتائج فقط. تشير هذه العلامة إلى عنوان URL الذي يوجِّه إلى هذه المهمة. يتم استخدام البيانات لاسترداد هذه المهمة أو تعديلها أو حذفها. |
parent |
النتائج فقط. معرّف المهمة الرئيسية يتم حذف هذا الحقل إذا كان مهمة ذات مستوى أعلى. استخدام الزر "نقل" لنقل المهمة تحت مسئول مختلف أو إلى المستوى الأعلى. لا يمكن أبدًا تعيين مهمة رئيسية (من مساحات Chat و"مستندات Google") للمهمة الرئيسية. هذا الحقل للقراءة فقط. |
position |
النتائج فقط. سلسلة تشير إلى موضع المهمة بين المهام التابعة لها ضمن نفس المهمة الرئيسية أو في المستوى الأعلى. إذا كانت هذه السلسلة أكبر من سلسلة الموضع المقابلة لمهمة أخرى وفقًا للترتيب المعجم، يتم وضع المهمة بعد المهمة الأخرى ضمن نفس المهمة الرئيسية (أو في المستوى الأعلى). استخدام الزر "نقل" لنقل المهمة إلى موضع آخر. |
notes |
الملاحظات التي تصف المهمة لا يمكن إضافة ملاحظات إلى المهام التي تم تعيينها من "مستندات Google". اختياريّ. الحد الأقصى المسموح به للطول: 8,192 حرفًا. |
status |
حالة المهمة هذا إما "needsAction" أو "مكتملة". |
due |
تاريخ استحقاق المهمة (كطابع زمني RFC 3339) اختياريّ. لا يسجل تاريخ الاستحقاق سوى معلومات التاريخ؛ يتم تجاهل الجزء الزمني من الطابع الزمني عند تعيين تاريخ الاستحقاق. ليس من الممكن قراءة أو كتابة وقت إنجاز المهمة عبر واجهة برمجة التطبيقات. |
completed |
تاريخ اكتمال المهمة (كطابع زمني RFC 3339). يتم حذف هذا الحقل إذا لم تكتمل المهمة. |
deleted |
علامة تشير إلى ما إذا تم حذف المهمة هذا الحقل للقراءة فقط بالنسبة إلى المهام المحدّدة. لا يمكن حذفهما إلا من خلال استدعاء المهام.delete، وفي هذه الحالة، يتم حذف كل من المهمة المُسنَدة والمهمة الأصلية (في "مستندات Google" أو "مساحات Chat"). لحذف المهمة التي تم إسنادها فقط، انتقِل إلى مساحة عرض المهام وأسندها إليها. وتكون القيمة التلقائية False. |
links[] |
النتائج فقط. مجموعة الروابط هذه المجموعة للقراءة فقط. |
links[].type |
نوع الرابط، على سبيل المثال: "البريد الإلكتروني". |
links[].description |
الوصف. في HTML تحدث: كل شيء بين <a> و</a>. |
links[].link |
عنوان URL |
webViewLink |
النتائج فقط. رابط مطلق إلى المهمة في واجهة مستخدم "مهام Google" على الويب. |
assignmentInfo |
النتائج فقط. معلومات السياق للمهام المُسنَدة يمكن تعيين مهمة إلى مستخدم، وهو متاح حاليًا من مساحات عرض مثل "مستندات Google" و"مساحات Chat". تتم تعبئة هذا الحقل للمهام التي تم تعيينها للمستخدم الحالي والتي تحدد المكان الذي تم تعيين المهمة منه. هذا الحقل للقراءة فقط. |
AssignmentInfo
معلومات عن مصدر إسناد المهمة (مستند أو مساحة Chat)
تمثيل JSON |
---|
{ "linkToTask": string, "surfaceType": enum ( |
الحقول | |
---|---|
linkToTask |
النتائج فقط. رابط مطلق إلى المهمة الأصلية في سطح المهمة ("مستندات Google" أو مساحات Chat أو غير ذلك). |
surfaceType |
النتائج فقط. نوع سطح العرض الذي تنشأ منه هذه المهمة المعيّنة. تقتصر حاليًا على DOCUMENT أو SPACE. |
حقل الاتحاد surface_info . معلومات عن مساحة العرض ("مستندات Google" و"مساحات Chat") التي تم إسناد هذه المهمة منها يمكن أن يكون surface_info واحدًا فقط مما يلي: |
|
driveResourceInfo |
النتائج فقط. معلومات عن ملف Drive الذي نشأت منه هذه المهمة. في الوقت الحالي، يمكن أن يكون ملف Drive مستندًا فقط. هذا الحقل للقراءة فقط. |
spaceInfo |
النتائج فقط. معلومات عن مساحة Chat التي نشأت منها هذه المهمة. هذا الحقل للقراءة فقط. |
ContextType
المنتج المرتبط بالمهمة.
عمليات التعداد | |
---|---|
CONTEXT_TYPE_UNSPECIFIED |
قيمة غير معروفة لسياق هذه المهمة. |
GMAIL |
يتم إنشاء المهمة من Gmail. |
DOCUMENT |
تم تعيين المهمة من مستند. |
SPACE |
تم إسناد المهمة من مساحة Chat. |
DriveResourceInfo
معلومات حول مورد Drive الذي تم تعيين مهمة منه (المستند أو ورقة البيانات أو غير ذلك).
تمثيل JSON |
---|
{ "driveFileId": string, "resourceKey": string } |
الحقول | |
---|---|
driveFileId |
النتائج فقط. معرّف الملف في Drive API |
resourceKey |
النتائج فقط. مفتاح المورد مطلوب للوصول إلى الملفات التي تمت مشاركتها من خلال رابط مشترك. غير مطلوبة مع جميع الملفات. يمكنك الاطّلاع أيضًا على الرابط developers.google.com/drive/api/guides/resource-keys. |
SpaceInfo
معلومات عن مساحة Chat التي تم إسناد المهمة منها
تمثيل JSON |
---|
{ "space": string } |
الحقول | |
---|---|
space |
النتائج فقط. مساحة Chat التي تم إنشاء هذه المهمة منها التنسيق هو "spaces/{space}". |
الطُرق |
|
---|---|
|
يؤدي هذا الإجراء إلى محو جميع المهام المكتملة من قائمة المهام المحدّدة. |
|
يؤدي هذا الإجراء إلى حذف المهمة المحدّدة من قائمة المهام. |
|
تعرض المهمة المحددة. |
|
إنشاء مهمة جديدة في قائمة المهام المحدّدة |
|
عرض جميع المهام في قائمة المهام المحددة. |
|
نقل المهمة المحددة إلى موضع آخر في قائمة مهام الوجهة. |
|
يتم تعديل المهمة المحدّدة. |
|
يتم تعديل المهمة المحدّدة. |