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:
|
|
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.
Engellenen HTML öğeleri: Bu öğeler ve içerikleri, HTML yüklerinden kaldırılır.
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:
|
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 |
menuItems[] |
list |
Bu öğe, zaman çizelgesinde seçildiğinde kullanıcıya sunulacak menü öğelerinin listesidir. | yazılabilir |
menuItems[].action |
string |
Kullanıcı menü seçeneğini belirlediğinde davranışı denetler. İzin verilen değerler şunlardır:
|
yazılabilir |
menuItems[].id |
string |
Bu menü öğesinin kimliği. Bu uygulama tarafından oluşturulur ve opak jeton olarak kabul edilir. | yazılabilir |
menuItems[].payload |
string |
Bu Menü Öğesinin işlemine bağlı olarak anlamı değişen genel bir yük.
|
yazılabilir |
menuItems[].removeWhenSelected |
boolean |
CUSTOM menü öğesinde true (doğru) değerine ayarlanırsa, öğe seçildikten sonra menüden kaldırılır. |
yazılabilir |
menuItems[].values[] |
list |
CUSTOM öğeleri için menü öğesinin her bir durumundaki görünümünü kontrol eden bir değer listesi. DEFAULT durumu için bir değer sağlanmalıdır. Eksik PENDING veya CONFIRMED durumları gösterilmez. |
yazılabilir |
menuItems[].values[].displayName |
string |
Menü öğesi için görüntülenecek ad. Yerleşik bir menü öğesi için bu özelliği belirtirseniz söz konusu menü öğesi için varsayılan içeriğe dayalı sesli komut gösterilmez. | yazılabilir |
menuItems[].values[].iconUrl |
string |
Menü öğesiyle birlikte görüntülenecek bir simgenin URL'si. | yazılabilir |
menuItems[].values[].state |
string |
Bu değerin geçerli olduğu durum. İzin verilen değerler şunlardır:
|
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:
|
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 |
selfLink |
string |
Bu öğeyi almak için kullanılabilecek URL. | |
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.