Timeline

للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.

تمثيلات الموارد

يتم تمثيل كل عنصر في المخطط الزمني للمستخدم على هيئة بنية TimelineItem بتنسيق JSON، كما هو موضّح أدناه.

{
  "kind": "mirror#timelineItem",
  "id": string,
  "sourceItemId": string,
  "canonicalUrl": string,
  "bundleId": string,
  "isBundleCover": boolean,
  "selfLink": string,
  "created": datetime,
  "updated": datetime,
  "displayTime": datetime,
  "isPinned": boolean,
  "pinScore": integer,
  "isDeleted": boolean,
  "etag": etag,
  "creator": contacts Resource,
  "recipients": [
    contacts Resource
  ],
  "inReplyTo": string,
  "title": string,
  "text": string,
  "html": string,
  "speakableType": string,
  "speakableText": string,
  "attachments": [
    timeline.attachments Resource
  ],
  "location": locations Resource,
  "menuItems": [
    {
      "id": string,
      "action": string,
      "values": [
        {
          "state": string,
          "displayName": string,
          "iconUrl": string
        }
      ],
      "removeWhenSelected": boolean,
      "payload": string
    }
  ],
  "notification": {
    "level": string,
    "deliveryTime": datetime
  }
}

اسم الموقع	القيمة	الوصف	ملاحظات
attachments[]	list	قائمة بمرفقات الوسائط المرتبطة بهذا العنصر ولتسهيل الأمر، يمكنك الرجوع إلى المرفقات في أحمال HTML التي تتضمّن مرفقًا أو مخطط CID. على سبيل المثال: المرفق: <img src="attachment:attachment_index"> حيث يكون invoice_index هو الفهرس الذي يستند إلى 0 لهذه الصفيفة. الرقم التعريفي للعميل: <img src="cid:attachment_id"> حيث يكون معرف المرفق هو رقم تعريف المرفق.
bundleId	string	معرِّف الحزمة لهذه السلعة. يمكن للخدمات تحديد packageId لتجميع العديد من العناصر معًا. وتظهر تحت عنصر واحد من المستوى الأعلى على الجهاز.	قابل للكتابة
canonicalUrl	string	عنوان URL أساسي يشير إلى النسخة الأساسية/عالية الجودة من البيانات التي يمثّلها عنصر المخطط الزمني.	قابل للكتابة
created	datetime	تمثّل هذه السمة وقت إنشاء هذا العنصر، ويكون منسَّقًا وفقًا لمعيار RFC 3339.
creator	nested object	المستخدِم أو المجموعة التي أنشأت هذا العنصر.	قابل للكتابة
displayTime	datetime	الوقت الذي يجب عرضه عند عرض هذا العنصر في المخطط الزمني، ويكون منسَّقًا وفقًا لمعيار RFC 3339. يتم ترتيب المخطط الزمني لهذا المستخدم حسب وقت العرض، وبالتالي سيحدّد هذا أيضًا مكان عرض العنصر في المخطط الزمني. وفي حال عدم ضبط هذه السياسة من خلال الخدمة، يتم ضبط وقت العرض تلقائيًا على updated.	قابل للكتابة
etag	etag	علامة ETag لهذا العنصر.
html	string	محتوى HTML لهذا العنصر. في حال توفير كلّ من text وhtml لعنصر، سيتم عرض html في المخطط الزمني. عناصر HTML المسموح بها: يمكنك استخدام هذه العناصر في بطاقات المخطط الزمني. العناوين: h1, h2, h3, h4, h5, h6 الصور: img القوائم: li, ol, ul دلالات HTML5: article, aside, details, figure, figcaption, footer, header, nav, section, summary, time الهيكلية: blockquote, br, div, hr, p, span النمط: b, big, center, em, i, u, s, small, strike, strong, style, sub, sup الجداول: table, tbody, td, tfoot, th, thead, tr عناصر HTML المحظورة: تتم إزالة هذه العناصر ومحتواها من حمولات HTML. عناوين المستندات: head, title العناصر المضمَّنة: audio, embed, object, source, video الإطارات: frame, frameset برمجة نصية: applet, script العناصر الأخرى: تتم إزالة أي عناصر غير مُدرَجة، ولكن يتم الإبقاء على محتواها.	قابل للكتابة
id	string	رقم تعريف عنصر المخطط الزمني. وهو فريد ضمن المخطط الزمني للمستخدم.
inReplyTo	string	إذا تم إنشاء هذا العنصر كرد على عنصر آخر، سيتم ضبط هذا الحقل على رقم تعريف العنصر الذي يتم الرد عليه. ويمكن استخدام هذا الإجراء لإرفاق ردّ بالمحادثة أو المشاركة المناسبة.
isBundleCover	boolean	ما إذا كان هذا العنصر غلاف حزمة. إذا تم تصنيف سلعة على أنها غلاف حزمة، سيكون هذا هو نقطة الدخول إلى حزمة السلع التي تحمل القيمة bundleId نفسها لتلك السلعة. وسيتم عرضها على المخطّط الزمني الرئيسي فقط، وليس ضمن الحزمة المفتوحة. في المخطط الزمني الرئيسي، في ما يلي العناصر التي تظهر: العناصر التي تم ضبط isBundleCover فيها على true العناصر التي لا تحتوي على bundleId في المخطط الزمني الفرعي للحزمة، تكون السلع المعروضة هي: العناصر التي تحتوي على القيمة bundleId المعنيّة و isBundleCover التي تم ضبطها على false	قابل للكتابة
isDeleted	boolean	عندما تكون القيمة true، تشير إلى حذف هذا العنصر، ويتم ضبط خاصية ID فقط.
isPinned	boolean	عندما تكون القيمة true، تشير إلى أنّ هذا العنصر مثبَّت، ما يعني أنّه قد تم تجميعه بجانب "active" (نشط). عناصر مثل التنقل ودردشة الفيديو الجماعية، على الجانب الآخر من الشاشة الرئيسية من عناصر المخطط الزمني السابقة (غير المثبتة). يمكنك السماح للمستخدم بتبديل قيمة هذه السمة باستخدام عنصر القائمة TOGGLE_PINNED المضمّن.
kind	string	نوع المورد. دائمًا ما تكون هذه هي mirror#timelineItem.
location	nested object	الموقع الجغرافي المرتبط بهذا العنصر	قابل للكتابة
menuItems[]	list	قائمة بعناصر القائمة التي سيتم عرضها للمستخدم عند اختيار هذا العنصر في المخطط الزمني.	قابل للكتابة
menuItems[].action	string	تتحكّم هذه السياسة في السلوك عندما يحدّد المستخدم خيار القائمة. القيم المسموح بها هي: CUSTOM: إجراء مخصّص حدّدته الخدمة عندما يختار المستخدم هذا menuItem، ترسل واجهة برمجة التطبيقات إشعارًا إلى callbackUrl مع ضبط userActions.type على CUSTOM وضبط userActions.payload على ID لهذا العنصر في القائمة. هذه هي القيمة الافتراضية. الإجراءات المضمنة: REPLY: يمكنك بدء الردّ على عنصر المخطط الزمني باستخدام واجهة مستخدم التسجيل الصوتي. يجب ضبط السمة creator في عنصر المخطط الزمني لتصبح هذه القائمة متوفرة. REPLY_ALL: لديه سلوك مماثل لسلوك REPLY. ستتم إضافة recipients لعنصر المخطط الزمني الأصلي إلى عنصر الرد. DELETE: حذف عنصر المخطط الزمني SHARE - يمكنك مشاركة عنصر المخطط الزمني مع جهات الاتصال المتاحة. READ_ALOUD - قراءة speakableText لعنصر المخطط الزمني بصوت عالٍ وإذا لم يتم ضبط هذا الحقل، اقرأ الحقل text. فإذا لم يتم تعيين أي من هذه الحقول، فسيتم تجاهل عنصر القائمة هذا. GET_MEDIA_INPUT - السماح للمستخدمين بتقديم حمولات الوسائط إلى Glassware من عنصر قائمة (لا يتوفّر حاليًا سوى النص المكتوب من الإدخال الصوتي). يمكنك الاشتراك في الإشعارات عندما يستدعي المستخدمون عنصر القائمة هذا لتلقّي معرّف عنصر المخطط الزمني. استرداد الوسائط من عنصر المخطط الزمني في السمة payload. VOICE_CALL: يمكنك بدء مكالمة هاتفية باستخدام سمة creator.phoneNumber لعنصر المخطط الزمني كمستلِم. NAVIGATE - الانتقال إلى location في عنصر المخطط الزمني TOGGLE_PINNED: تبديل حالة isPinned لعنصر المخطط الزمني OPEN_URI: فتح payload لعنصر في القائمة في المتصفّح PLAY_VIDEO - افتح payload لعنصر القائمة في مشغّل فيديو Glass. SEND_MESSAGE - بدء إرسال رسالة إلى عنصر المخطط الزمني creator: إذا تم ضبط creator.phoneNumber وتم توصيل Glass بهاتف Android، تكون الرسالة رسالة قصيرة. بخلاف ذلك، إذا تم ضبط creator.email، تكون الرسالة إلكترونية.	قابل للكتابة
menuItems[].id	string	رقم التعريف لهذا العنصر في القائمة. يتم إنشاء هذا بواسطة التطبيق ويتم التعامل معه كرمز مميز مبهم.	قابل للكتابة
menuItems[].payload	string	حمولة عامة يتغير معنىها بناءً على إجراء MenuItem هذا. عندما يكون الإجراء OPEN_URI، تكون الحمولة هي عنوان URL للموقع الإلكتروني الذي تريد عرضه. عندما يكون الإجراء PLAY_VIDEO، تكون الحمولة هي عنوان URL لبث الفيديو. عندما يكون الإجراء GET_MEDIA_INPUT، تكون الحمولة هي تحويل النص إلى نص لإدخال الكلام للمستخدم.	قابل للكتابة
menuItems[].removeWhenSelected	boolean	في حال ضبط السياسة على "صحيح" في عنصر قائمة CUSTOM، ستتم إزالة هذا العنصر من القائمة بعد اختياره.	قابل للكتابة
menuItems[].values[]	list	تشمل هذه السمة قائمة بالقيم التي تتحكّم في شكل عنصر القائمة في كل حالة من حالاتها بالنسبة إلى العناصر التي يبلغ عددها CUSTOM. يجب تقديم قيمة للحالة DEFAULT. في حال عدم توفّر إحدى الولايات PENDING أو CONFIRMED، لن تظهر الحالة.	قابل للكتابة
menuItems[].values[].displayName	string	الاسم الذي سيتم عرضه لعنصر القائمة. إذا حددت هذه السمة لعنصر قائمة مدمج، لن يتم عرض الأمر الصوتي التلقائي السياقي لعنصر القائمة هذا.	قابل للكتابة
menuItems[].values[].iconUrl	string	عنوان URL لرمز يتم عرضه مع عنصر القائمة.	قابل للكتابة
menuItems[].values[].state	string	الولاية التي تنطبق عليها هذه القيمة. القيم المسموح بها هي: DEFAULT - القيمة التلقائية التي تظهر عند عرضها في قائمة menuItems. PENDING - القيمة التي يتم عرضها عندما يختار المستخدم menuItem، ولكن يظل من الممكن إلغاؤها. CONFIRMED - القيمة التي تظهر عندما يختار المستخدم عنصر القائمة ولا يمكن إلغاؤه بعد الآن.	قابل للكتابة
notification	nested object	تتحكّم هذه السياسة في كيفية عرض إشعارات هذا العنصر على الجهاز. وفي حال عدم توفّر هذه المعلومات، لن يتم إنشاء أي إشعار.	قابل للكتابة
notification.deliveryTime	datetime	وقت إرسال الإشعار	قابل للكتابة
notification.level	string	تصف هذه السمة مدى أهمية الإشعار. القيم المسموح بها هي: DEFAULT: إشعارات بالأهمية التلقائية سيتم تشغيل رنين لتنبيه المستخدمين.	قابل للكتابة
pinScore	integer	بالنسبة إلى العناصر المثبَّتة، يحدِّد هذا الخيار ترتيب عرض العنصر في المخطط الزمني، حيث تظهر نتيجة أعلى بالقرب من الساعة. ملاحظة: لا يمكن حاليًا ضبط هذا الحقل.
recipients[]	list	قائمة بالمستخدمين أو المجموعات التي تمت مشاركة هذا العنصر معها	قابل للكتابة
selfLink	string	تمثّل هذه السمة عنوان URL يمكن استخدامه لاسترداد هذا العنصر.
sourceItemId	string	سلسلة معتمة يمكنك استخدامها لربط عنصر مخطط زمني ببيانات في خدمتك الخاصة.	قابل للكتابة
speakableText	string	تمثّل هذه السمة النسخة المقروءة لمحتوى هذا العنصر. بالإضافة إلى عنصر القائمة READ_ALOUD، يمكنك استخدام هذا الحقل لتقديم نص يكون أكثر وضوحًا عند قراءته بصوت عالٍ، أو لتقديم معلومات موسّعة حول ما يتم عرضه بشكل مرئي على Glass. يجب أن تحدد Glassware أيضًا حقل speechableType الذي سيتم قوله قبل هذا النص في الحالات التي يكون فيها السياق الإضافي مفيدًا، على سبيل المثال عندما يطلب المستخدم قراءة العنصر بصوت عالٍ بعد الإشعار.	قابل للكتابة
speakableType	string	تمثّل هذه السمة وصفًا شفهيًا لنوع هذا العنصر. يتم إشعار المستخدم بذلك قبل قراءة محتوى العنصر في الحالات التي يكون فيها السياق الإضافي مفيدًا، على سبيل المثال عندما يطلب المستخدم قراءة العنصر بصوت عالٍ بعد تلقّي إشعار. يجب أن تكون هذه العبارة اسمية قصيرة وبسيطة مثل "البريد الإلكتروني" أو "رسالة نصية" أو "موجز أخبار Daily Planet". ننصح باستخدام Glassware بملء هذا الحقل لكل عنصر من عناصر المخطط الزمني، حتى إذا كان العنصر لا يحتوي على نص SpeakableText أو نص حتى يتمكن المستخدم من معرفة نوع العنصر بدون النظر إلى الشاشة.	قابل للكتابة
text	string	المحتوى النصي لهذا العنصر	قابل للكتابة
title	string	تمثّل هذه السمة عنوان هذا العنصر.	قابل للكتابة
updated	datetime	تمثّل هذه السمة الوقت الذي تم فيه تعديل هذا العنصر آخر مرة وفقًا لمعيار RFC 3339.

الطُرق

حذف

حذف عنصر من المخطط الزمني.

الحصول على

الحصول على عنصر واحد للمخطط الزمني من خلال رقم التعريف

إدراج

إدراج عنصر جديد في المخطط الزمني.

list

استرداد قائمة بعناصر المخطط الزمني للمستخدم الذي تمت مصادقته.

التصحيح

يعدّل هذا العنصر أحد عناصر المخطط الزمني. تتوافق هذه الطريقة مع دلالات التصحيح.

تعديل

يعدّل هذا العنصر أحد عناصر المخطط الزمني.