Timeline

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

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

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

{
  "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"> حيث يكون index_index عبارة عن فهرس يستند إلى 0 لهذه المصفوفة. cid: <img src="cid:attachment_id"> حيث يكون المرفقات_id معرّف المرفق.
bundleId	string	معرّف الحزمة لهذا العنصر. يمكن للخدمات تحديد bundleId لتجميع العديد من العناصر معًا. وتظهر أسفل عنصر واحد في المستوى العلوي على الجهاز.	قابلة للكتابة
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"، تشير هذه القيمة إلى أنه تم حذف هذا العنصر، وتم ضبط خاصية رقم التعريف فقط.
isPinned	boolean	عند التعيين على "true"، يشير ذلك إلى تثبيت هذا العنصر، مما يعني أنه قد تم تجميعه مع العناصر "النشطة" مثل التنقل وجلسات hangout، على الجانب الآخر من الشاشة الرئيسية من عناصر المخطط الزمني القديمة (غير المثبتة). يمكنك السماح للمستخدم بتبديل قيمة هذا الموقع باستخدام عنصر القائمة المضمّن 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 من عنصر قائمة (لا يتوفر حاليًا إلا النص المحوّل صوتيًا من الإدخال الصوتي). يمكنك الاشتراك في الإشعارات عندما يستدعي المستخدمون عنصر القائمة هذا للحصول على رقم تعريف عنصر المخطط الزمني. استرجع الوسائط من عنصر المخطط الزمني في السمة loadload. VOICE_CALL - يمكنك بدء مكالمة هاتفية باستخدام السمة creator.phoneNumber لعنصر المخطط الزمني كمُستلِم. NAVIGATE - الانتقال إلى location لعنصر المخطط الزمني. TOGGLE_PINNED - تبديل حالة isPinned لعنصر المخطط الزمني. OPEN_URI - افتح payload لعنصر القائمة في المتصفح. PLAY_VIDEO - افتح payload لعنصر القائمة في مشغّل فيديو Glass. SEND_MESSAGE - بدء إرسال رسالة إلى عنصر creator في المخطط الزمني: إذا تم ضبط creator.phoneNumber وتم توصيل Glass بهاتف Android، فستكون الرسالة رسالة قصيرة SMS. بخلاف ذلك، في حال ضبط 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 - يتم عرض القيمة عند تحديد المستخدم MenuItem ولم يعُد إلغاؤه ممكنًا.	قابلة للكتابة
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 حقل SpeakableType، الذي سيتم نطقه قبل هذا النص في الحالات التي يكون فيها السياق الإضافي مفيدًا، على سبيل المثال عندما يطلب المستخدم قراءة العنصر بصوت عالٍ بعد تلقي إشعار.	قابلة للكتابة
speakableType	string	وصف شفهي لنوع هذا العنصر. وسيتم إعلام المستخدم بذلك قبل قراءة محتوى العنصر في الحالات التي يكون فيها السياق الإضافي مفيدًا، مثلاً عندما يطلب المستخدم قراءة العنصر بصوت عالٍ بعد تلقّي إشعار. يجب أن تكون العبارة قصيرة أو بسيطة، مثل "البريد الإلكتروني" أو "رسالة نصية" أو "آخر الأخبار اليومية على الكوكب". ننصح باستخدام هذا الحقل لكل عنصر في المخطط الزمني، حتى إذا كان العنصر لا يحتوي على نص يمكن قوله أو حتى لا يتمكن المستخدم من معرفة نوع العنصر بدون النظر إلى الشاشة.	قابلة للكتابة
text	string	محتوى النص لهذا العنصر.	قابلة للكتابة
title	string	عنوان هذا العنصر.	قابلة للكتابة
updated	datetime	وقت آخر تعديل لهذا العنصر، تم تنسيقه وفقًا لـ RFC 3339.

الطُرق

حذف

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

الحصول

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

إدراج

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

list

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

تصحيح

لتحديث عنصر المخطط الزمني في مكانه. تتيح هذه الطريقة استخدام دلالات التصحيح.

تحديث

لتحديث عنصر المخطط الزمني في مكانه.