Timeline

Untuk daftar metode untuk resource ini, lihat bagian akhir halaman ini.

Representasi resource

Setiap item di linimasa pengguna direpresentasikan sebagai struktur JSON TimelineItem, yang dijelaskan di bawah.

{
  "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
  }
}
Nama properti Nilai Deskripsi Catatan
attachments[] list Daftar lampiran media yang terkait dengan item ini. Untuk memudahkan, Anda dapat merujuk ke lampiran di payload HTML dengan skema lampiran atau CID. Misalnya:
  • lampiran: <img src="attachment:attachment_index"> dengan lampiran_indeks adalah indeks berbasis 0 dari array ini.
  • cid: <img src="cid:attachment_id"> dengan lampiran_id adalah ID dari lampiran.
bundleId string ID paket untuk item ini. Layanan dapat menentukan bundleId untuk mengelompokkan banyak item sekaligus. Item-item tersebut muncul pada satu item tingkat atas di perangkat. dapat ditulis
canonicalUrl string URL kanonis yang mengarah ke versi kanonis/kualitas data data yang diwakili oleh item linimasa. dapat ditulis
created datetime Waktu saat item ini dibuat, diformat sesuai dengan RFC 3339.
creator nested object Pengguna atau grup yang membuat item ini. dapat ditulis
displayTime datetime Waktu yang akan ditampilkan saat item ini dilihat di linimasa, diformat sesuai dengan RFC 3339. Linimasa pengguna ini diurutkan secara kronologis pada waktu tampilan, sehingga juga akan menentukan tempat item ditampilkan di linimasa. Jika tidak disetel oleh layanan, waktu tampilan akan ditetapkan secara default ke waktu updated. dapat ditulis
etag etag ETag untuk item ini.
html string Konten HTML untuk item ini. Jika text dan html diberikan untuk satu item, html akan dirender dalam linimasa.

Elemen HTML yang diizinkan - Anda dapat menggunakan elemen ini di kartu linimasa.

  • Header: h1, h2, h3, h4, h5, h6
  • Gambar: img
  • Daftar: li, ol, ul
  • Semantik HTML5: article, aside, details, figure, figcaption, footer, header, nav, section, summary, time
  • Struktural: blockquote, br, div, hr, p, span
  • Gaya: b, big, center, em, i, u, s, small, strike, strong, style, sub, sup
  • Tabel: table, tbody, td, tfoot, th, thead, tr

Elemen HTML yang diblokir: Elemen ini dan kontennya dihapus dari payload HTML.

  • Header dokumen: head, title
  • Sematan: audio, embed, object, source, video
  • Frame: frame, frameset
  • Pembuatan skrip: applet, script

Elemen lainnya: Elemen apa pun yang tidak tercantum akan dihapus, tetapi kontennya dipertahankan.

 dapat ditulis
id string ID item linimasa. ID ini bersifat unik dalam linimasa pengguna.
inReplyTo string Jika item ini dibuat sebagai balasan untuk item lain, kolom ini akan ditetapkan ke ID item yang dibalas. Ini dapat digunakan untuk melampirkan balasan pada percakapan atau postingan yang sesuai.
isBundleCover boolean Apakah item ini merupakan sampul paket.

Jika item ditandai sebagai sampul paket, item tersebut akan menjadi titik entri ke paket item yang memiliki bundleId yang sama dengan item tersebut. Tugas hanya akan ditampilkan di linimasa utama — bukan dalam paket yang terbuka.

Pada linimasa utama, item yang ditampilkan adalah:
  • Item yang memiliki isBundleCover yang ditetapkan ke true
  • Item yang tidak memiliki bundleId
Dalam sub-jadwal paket, item yang ditampilkan adalah:
  • Item yang memiliki bundleId yang dimaksud AND isBundleCover ditetapkan ke false
dapat ditulis
isDeleted boolean Jika true, menunjukkan bahwa item ini dihapus, dan hanya properti ID yang ditetapkan.
isPinned boolean Jika true, menunjukkan bahwa item ini disematkan, yang berarti item tersebut akan dikelompokkan bersama item "aktif" seperti navigasi dan Hangouts, di sisi berlawanan dari layar utama dari item linimasa historis (yang tidak disematkan). Anda dapat mengizinkan pengguna untuk mengalihkan nilai properti ini dengan item menu bawaan TOGGLE_PINNED.
kind string Jenis resource. Nilai ini selalu mirror#timelineItem.
location nested object Lokasi geografis yang terkait dengan item ini. dapat ditulis
notification nested object Mengontrol cara notifikasi untuk item ini ditampilkan di perangkat. Jika informasi ini tidak ada, tidak ada notifikasi yang akan dibuat. dapat ditulis
notification.deliveryTime datetime Waktu pengiriman notifikasi. dapat ditulis
notification.level string Menjelaskan seberapa penting notifikasi tersebut. Nilai yang diizinkan adalah:
  • DEFAULT - Notifikasi dari tingkat kepentingan default. Bel akan diputar untuk memberi tahu pengguna.
 dapat ditulis
pinScore integer Untuk item yang disematkan, tindakan ini akan menentukan urutan item yang ditampilkan di linimasa, dengan skor yang lebih tinggi muncul di dekat jam. Catatan: setelan kolom ini saat ini tidak didukung.
recipients[] list Daftar pengguna atau grup yang diajak berbagi item ini. dapat ditulis
sourceItemId string String buram yang dapat Anda gunakan untuk memetakan item linimasa ke data dalam layanan Anda sendiri. dapat ditulis
speakableText string Versi konten yang dapat diucapkan dari item ini. Bersama dengan item menu READ_ALOUD, gunakan kolom ini untuk memberikan teks yang lebih jelas saat dibacakan secara lisan, atau untuk memberikan informasi yang diperluas tentang apa yang ditampilkan secara visual di Glass.

Glassware juga harus menentukan kolom speakableType, yang akan diucapkan sebelum teks ini jika konteks tambahan berguna, misalnya saat pengguna meminta item dibacakan dengan keras setelah notifikasi.
 dapat ditulis
speakableType string Deskripsi yang dapat diucapkan tentang jenis item ini. Ini akan diumumkan kepada pengguna sebelum membaca konten item jika konteks tambahan berguna, misalnya saat pengguna meminta agar item dibacakan secara lisan setelah notifikasi disampaikan.

Ini harus berupa frasa kata benda singkat dan sederhana seperti "Email", "SMS", atau "Info Terbaru Planet Harian".

Glassware sebaiknya mengisi kolom ini untuk setiap item linimasa, meskipun item tersebut tidak berisi speakableText atau teks sehingga pengguna dapat mempelajari jenis item tanpa melihat layar.		 dapat ditulis
text string Konten teks item ini. dapat ditulis
title string Judul item ini. dapat ditulis
updated datetime Waktu saat item ini terakhir diubah, diformat sesuai dengan RFC 3339.

Metode

hapus
Menghapus item linimasa.
dapatkan
Mendapatkan satu item linimasa menurut ID.
masukkan
Menyisipkan item baru ke linimasa.
list
Mengambil daftar item linimasa untuk pengguna terautentikasi.
patch [patch]
Memperbarui item linimasa di tempatnya. Metode ini mendukung semantik patch.
perbarui
Memperbarui item linimasa di tempatnya.