Timeline

Bu kaynağa yönelik yöntem listesi için bu sayfanın sonuna bakın.

Kaynak temsilleri

Kullanıcının zaman çizelgesindeki her öğe, aşağıda açıklanan bir TimelineItem JSON yapısı olarak temsil edilir.

{
  "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
  }
}
Mülk adı Değer Açıklama Notlar
attachments[] list Bu öğeyle ilişkili medya eklerinin listesi. Kolaylık olması açısından, ek veya cid şemasıyla HTML yüklerinizdeki eklere referansta bulunabilirsiniz. Örneğin:
  • ek: <img src="attachment:attachment_index">; burada ek_dizini, bu dizinin 0 tabanlı dizinidir.
  • cid: <img src="cid:attachment_id"> burada ek_kimliği, ekin kimliği olur.
bundleId string Bu öğenin paket kimliği. Hizmetler, birçok öğeyi birlikte gruplandırmak için bir BundleId belirtebilir. Cihazda tek bir üst düzey öğenin altında görünürler. yazılabilir
canonicalUrl string Zaman çizelgesi öğesi tarafından temsil edilen verilerin standart/yüksek kaliteli sürümüne işaret eden standart URL. yazılabilir
created datetime RFC 3339'a göre biçimlendirilmiş bu öğenin oluşturulduğu saat.
creator nested object Bu öğeyi oluşturan kullanıcı veya grup. yazılabilir
displayTime datetime Bu öğe, RFC 3339'a göre biçimlendirilmiş olarak zaman çizelgesinde görüntülenirken gösterilmesi gereken zaman. Bu kullanıcının zaman çizelgesi, görüntüleme zamanına göre kronolojik olarak sıralanır; dolayısıyla, öğenin zaman çizelgesinde nerede görüntüleneceğini de bu belirler. Hizmet tarafından ayarlanmazsa görüntüleme süresi varsayılan olarak updated saatine ayarlanır. yazılabilir
etag etag Bu öğenin eTag'i.
html string Bu öğenin HTML içeriği. Bir öğe için hem text hem de html sağlanırsa html zaman çizelgesinde oluşturulur.

İzin verilen HTML öğeleri: Bu öğeleri zaman çizelgesi kartlarınızda kullanabilirsiniz.

  • Başlıklar: h1, h2, h3, h4, h5, h6
  • Resim sayısı: img
  • Listeler: li, ol, ul
  • HTML5 anlamı: article, aside, details, figure, figcaption, footer, header, nav, section, summary, time
  • Yapısal: blockquote, br, div, hr, p, span
  • Stil: b, big, center, em, i, u, s, small, strike, strong, style, sub, sup
  • Tablolar: table, tbody, td, tfoot, th, thead, tr

Engellenen HTML öğeleri: Bu öğeler ve içerikleri HTML yüklerinden kaldırılır.

  • Doküman başlıkları: head, title
  • Yerleştirilmiş öğeler: audio, embed, object, source, video
  • Çerçeveler: frame, frameset
  • Komut dosyası çalıştırma: applet, script

Diğer öğeler: Listelenmeyen tüm öğeler kaldırılır ancak içerikleri korunur.

yazılabilir
id string Zaman çizelgesi öğesinin kimliği. Bu, kullanıcının zaman çizelgesinde benzersizdir.
inReplyTo string Bu öğe başka bir öğenin yanıtı olarak oluşturulmuşsa bu alan, yanıtlanan öğenin kimliğine ayarlanır. Bu özellik, ilgili görüşmeye veya yayına yanıt eklemek için kullanılabilir.
isBundleCover boolean Bu öğenin paket kapağı olup olmadığı.

Bir öğe paket kapağı olarak işaretlenirse bu öğe ile aynı bundleId öğesine sahip öğe paketine giriş noktası olur. Yalnızca ana zaman çizelgesinde gösterilir; açık pakette gösterilmez.

Ana zaman çizelgesinde gösterilen öğeler:
  • isBundleCover bulunan öğeler true olarak ayarlandı
  • bundleId içermeyen öğeler
Paket alt zaman çizelgesinde gösterilen öğeler şunlardır:
  • Söz konusu bundleId VE isBundleCover öğesinin false olarak ayarlandığı öğeler
yazılabilir
isDeleted boolean Değer "doğru" ise bu öğenin silindiğini ve yalnızca kimlik özelliğinin ayarlandığını belirtir.
isPinned boolean Doğru değerine ayarlandığında bu öğenin sabitlendiğini, yani "etkin" ile birlikte gruplandırıldığını belirtir gezinme ve videoyla sohbetler gibi öğeler, geçmiş (sabitlenmemiş) zaman çizelgesi öğelerinden ana ekranın karşı tarafında. Kullanıcının yerleşik TOGGLE_PINNED menü öğesiyle bu özelliğin değerini açıp kapatmasına izin verebilirsiniz.
kind string Kaynağın türü. Bu her zaman mirror#timelineItem.
location nested object Bu öğeyle ilişkilendirilen coğrafi konum. yazılabilir
notification nested object Bu öğeyle ilgili bildirimlerin cihazda nasıl sunulacağını kontrol eder. Bu değer eksikse herhangi bir bildirim oluşturulmaz. yazılabilir
notification.deliveryTime datetime Bildirimin teslim edileceği saat. yazılabilir
notification.level string Bildirimin ne kadar önemli olduğunu açıklar. İzin verilen değerler:
  • DEFAULT - Varsayılan önemdeki bildirimler. Kullanıcıları uyarmak için bir zil çalınır.
yazılabilir
pinScore integer Sabitlenen öğeler için bu, öğenin zaman çizelgesinde görüntülenme sırasını belirler ve saate yaklaştıkça daha yüksek bir puan görüntülenir. Not: Bu alanın ayarlanması şu anda desteklenmemektedir.
recipients[] list Bu öğenin paylaşıldığı kullanıcıların veya grupların listesi. yazılabilir
sourceItemId string Bir zaman çizelgesi öğesini kendi hizmetinizdeki verilerle eşlemek için kullanabileceğiniz şeffaf dize. yazılabilir
speakableText string Bu öğe içeriğinin sesli okunabilir sürümü. READ_ALOUD menü öğesiyle birlikte, sesli okunurken daha net olacak metin sağlamak veya Glass'ta görsel olarak görüntülenenler hakkında genişletilmiş bilgi sağlamak için bu alanı kullanın.

Glassware ayrıca, ek bağlamın faydalı olduğu durumlarda (örneğin, kullanıcı bir bildirimin ardından öğenin sesli okunmasını istediğinde) bu metinden önce sesli olarak söylenen söylenebilirType alanını da belirtmelidir.
yazılabilir
speakableType string Bu öğenin türünün okunabilir bir açıklaması. Bu bilgi, ek bağlamın faydalı olduğu durumlarda (ör. kullanıcı bir bildirimin ardından öğenin sesli okunmasını istediğinde) öğenin içeriğini okumadan önce kullanıcıya duyurulur.

Bu, "E-posta", "Kısa mesaj" veya "Günlük Gezegen Haberleri Güncellemesi" gibi kısa ve basit bir isim ifadesi olmalıdır.

Kullanıcı ekrana bakmadan öğenin türünü öğrenebilmesi için, öğede söylenebilir metin veya metin bulunmasa bile bu alanın her zaman çizelgesi öğesi için doldurulması önerilir.
yazılabilir
text string Bu öğenin metin içeriği. yazılabilir
title string Bu öğenin başlığı. yazılabilir
updated datetime RFC 3339'a göre biçimlendirilmiş, bu öğenin son değiştirilme zamanı.

Yöntemler

sil
Zaman çizelgesi öğesini siler.
al
Kimliğe göre tek bir zaman çizelgesi öğesi alır.
ekle
Zaman çizelgesine yeni bir öğe ekler.
list
Kimliği doğrulanmış kullanıcının zaman çizelgesi öğelerinin listesini alır.
yama
Yerinde bir zaman çizelgesi öğesini günceller. Bu yöntem yama anlamını destekler.
güncelle
Yerinde bir zaman çizelgesi öğesini günceller.