Timeline

Bu kaynakla ilgili yöntemlerin listesi için bu sayfanın sonuna bakın.

Kaynak temsilleri

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

{
  "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 sağlamak için ek veya cid şemasını kullanarak HTML yükünüzdeki ekleri inceleyebilirsiniz. Örneğin:
  • ek: <img src="attachment:attachment_index">, eki_dizini bu dizinin 0 tabanlı dizinidir.
  • cid: <img src="cid:attachment_id">; eki_id, ekin kimliğidir.
bundleId string Bu öğenin paket kimliği. Hizmetler, birçok öğeyi birlikte gruplandırmak için bir paket kimliği belirtebilir. Cihazda tek bir üst düzey öğenin altında görünür. yazılabilir
canonicalUrl string Zaman çizelgesi öğesi tarafından temsil edilen verilerin standart/yüksek kaliteli sürümünü gösteren standart URL. yazılabilir
created datetime Bu öğenin oluşturulma zamanı, RFC 3339'a göre biçimlendirilmiştir.
creator nested object Bu öğeyi oluşturan kullanıcı veya grup. yazılabilir
displayTime datetime Bu öğe zaman çizelgesinde görüntülendiğinde gösterilmesi gereken zaman (RFC 3339'a göre biçimlendirilmiştir). Bu kullanıcının zaman çizelgesi, görüntüleme zamanında kronolojik olarak sıralanır. Bu nedenle, öğenin zaman çizelgesinde nerede görüntüleneceği de belirlenir. Hizmet tarafından ayarlanmazsa görüntüleme süresi varsayılan olarak updated olur. yazılabilir
etag etag Bu öğenin ETag etiketi.
html string Bu öğenin HTML içeriği. Bir öğe için hem text hem de html sağlanmışsa html, zaman çizelgesinde oluşturulur.

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

  • Üstbilgiler: h1, h2, h3, h4, h5, h6
  • Resimler: img
  • Listeler: li, ol, ul
  • HTML5 semantiği: 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ı: 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şturulduysa bu alan, yanıt verilen öğenin kimliğine ayarlanır. Bu, uygun bir görüşmeye veya yayına yanıt eklemek için kullanılabilir.
isBundleCover boolean Bu öğenin bir paketin olup olmadığı.

Bir öğe paket kapağı olarak işaretlenirse bu öğe, aynı öğeyle aynı bundleId öğesine sahip olan öğe grubunun giriş noktası olur. Yalnızca ana zaman çizelgesinde gösterilir (açık pakette değil).

Ana zaman çizelgesinde şu öğeler gösteriliyor:
  • isBundleCover öğesi true olarak ayarlandı
  • bundleId içermeyen öğeler
Paket alt zaman çizelgesinde gösterilen öğeler şunlardır:
  • Söz konusu bundleId öğesi VE isBundleCover bulunan öğeler false olarak ayarlandı
yazılabilir
isDeleted boolean Doğru değerine ayarlanırsa bu öğenin silindiğini ve yalnızca kimlik özelliğinin ayarlandığını belirtir.
isPinned boolean Bu değer doğru değerine ayarlandığında bu öğenin sabitlendiğini, yani gezinme (ör. gezinme ve Hangout'lar) gibi "etkin" öğelerin yanında, geçmiş (sabitlenmemiş) zaman çizelgesi öğelerinin karşısında gruplandığını belirtir. TOGGLE_PINNED yerleşik menü öğesiyle kullanıcının bu tesisin değerini değiştirmesine 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 öğeye yönelik bildirimlerin cihazda nasıl sunulacağını kontrol eder. Bu eksikse bildirim oluşturulmaz. yazılabilir
notification.deliveryTime datetime Bildirimin iletileceği zaman. yazılabilir
notification.level string Bildirimin ne kadar önemli olduğunu açıklar. İzin verilen değerler şunlardır:
  • DEFAULT - Varsayılan önem bildirimleri. Kullanıcıları uyarmak için bir zil çalınacak.
 yazılabilir
pinScore integer Sabitlenen öğelerde, öğenin zaman çizelgesinde görüntülenme sırası belirlenir. Saate daha yüksek bir puan gösterilir. 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 Zaman çizelgesi öğesini kendi hizmetinizdeki verilerle eşlemek için kullanabileceğiniz opak dize. yazılabilir
speakableText string Bu öğenin içeriğinin söylenebilir sürümü. Sesli okunurken daha net olacak metin sağlamak veya Glass'ta görsel olarak gösterilenlere genişletilmiş bilgiler sağlamak için READ_ALOUD menü öğesinin yanı sıra bu alanı kullanın.

Glassware ayrıca ek bağlamın faydalı olduğu durumlarda (ör. kullanıcı, bildirimin ardından öğenin sesli okunmasını istediğinde) bu metinden önce söylenecek talkableType alanını da belirtmelidir.
 yazılabilir
speakableType string Bu öğenin türünün sesli söylenebilir açıklaması. Bu bilgiler, ek bağlamın faydalı olduğu durumlarda (ör. kullanıcı, bildirimin ardından öğenin sesli okunmasını istediği durumlarda) öğenin içeriğini okumadan önce kullanıcıya bildirilir.

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

Öğe bardaklı metin veya metin içermese bile kullanıcı ekrana bakmadan öğenin türünü öğrenebilmesi için cam eşyasının bu zaman çizelgesi öğesi için bu alanı doldurması önerilir.		 yazılabilir
text string Bu öğenin metin içeriği. yazılabilir
title string Bu öğenin başlığı. yazılabilir
updated datetime Bu öğenin en son değiştirilme zamanı, RFC 3339'a göre biçimlendirilmiştir.

Yöntemler

sil
Zaman çizelgesi öğesini siler.
edin
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
Mevcut bir zaman çizelgesi öğesini günceller. Bu yöntem, yama semantiği destekler.
güncelle
Mevcut bir zaman çizelgesi öğesini günceller.