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 الموقع الجغرافي المرتبط بهذا العنصر قابل للكتابة
notification nested object تتحكّم هذه السياسة في كيفية عرض إشعارات هذا العنصر على الجهاز. وفي حال عدم توفّر هذه المعلومات، لن يتم إنشاء أي إشعار. قابل للكتابة
notification.deliveryTime datetime وقت إرسال الإشعار قابل للكتابة
notification.level string تصف هذه السمة مدى أهمية الإشعار. القيم المسموح بها هي:
  • DEFAULT: إشعارات بالأهمية التلقائية سيتم تشغيل رنين لتنبيه المستخدمين.
قابل للكتابة
pinScore integer بالنسبة إلى العناصر المثبَّتة، يحدِّد هذا الخيار ترتيب عرض العنصر في المخطط الزمني، حيث تظهر نتيجة أعلى بالقرب من الساعة. ملاحظة: لا يمكن حاليًا ضبط هذا الحقل.
recipients[] list قائمة بالمستخدمين أو المجموعات التي تمت مشاركة هذا العنصر معها قابل للكتابة
sourceItemId string سلسلة معتمة يمكنك استخدامها لربط عنصر مخطط زمني ببيانات في خدمتك الخاصة. قابل للكتابة
speakableText string تمثّل هذه السمة النسخة المقروءة لمحتوى هذا العنصر. بالإضافة إلى عنصر القائمة READ_ALOUD، يمكنك استخدام هذا الحقل لتقديم نص يكون أكثر وضوحًا عند قراءته بصوت عالٍ، أو لتقديم معلومات موسعة إلى ما يتم عرضه بشكل مرئي على Glass.

يجب أن تحدِّد Glassware أيضًا الحقل SpeakableType الذي سيتم قوله قبل هذا النص في الحالات التي يكون فيها السياق الإضافي مفيدًا، على سبيل المثال عندما يطلب المستخدم قراءة العنصر بصوت عالٍ بعد الإشعار.
قابل للكتابة
speakableType string تمثّل هذه السمة وصفًا شفهيًا لنوع هذا العنصر. يتم إشعار المستخدم بذلك قبل قراءة محتوى العنصر في الحالات التي يكون فيها السياق الإضافي مفيدًا، على سبيل المثال عندما يطلب المستخدم قراءة العنصر بصوت عالٍ بعد تلقّي إشعار.

يجب أن تكون هذه العبارة اسمية قصيرة وبسيطة مثل "البريد الإلكتروني" أو "رسالة نصية" أو "موجز أخبار Daily Planet".

ننصح باستخدام Glassware بملء هذا الحقل لكل عنصر من عناصر المخطط الزمني، حتى إذا كان العنصر لا يحتوي على نص SpeakableText أو نص حتى يتمكن المستخدم من معرفة نوع العنصر بدون النظر إلى الشاشة.
قابل للكتابة
text string المحتوى النصي لهذا العنصر قابل للكتابة
title string تمثّل هذه السمة عنوان هذا العنصر. قابل للكتابة
updated datetime تمثّل هذه السمة الوقت الذي تم فيه تعديل هذا العنصر آخر مرة وفقًا لمعيار RFC 3339.

الطُرق

حذف
حذف عنصر من المخطط الزمني.
الحصول على
الحصول على عنصر واحد للمخطط الزمني من خلال رقم التعريف
إدراج
إدراج عنصر جديد في المخطط الزمني.
list
استرداد قائمة بعناصر المخطط الزمني للمستخدم الذي تمت مصادقته.
التصحيح
يعدّل هذا العنصر أحد عناصر المخطط الزمني. تتوافق هذه الطريقة مع دلالات التصحيح.
تعديل
يعدّل هذا العنصر أحد عناصر المخطط الزمني.