Timeline

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

Representasi resource

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

{
  "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 dalam payload HTML dengan lampiran atau skema cid. Contoh:
  • attachment: <img src="attachment:attachment_index"> dengan attachment_index adalah indeks berbasis 0 dari array ini.
  • cid: <img src="cid:attachment_id"> dengan attachment_id adalah ID lampiran.
bundleId string ID paket untuk item ini. Layanan dapat menentukan bundleId untuk mengelompokkan banyak item bersama-sama. Iklan muncul pada satu item tingkat atas di perangkat. dapat ditulis
canonicalUrl string URL kanonis yang mengarah ke versi kanonis/berkualitas tinggi dari data yang direpresentasikan oleh item linimasa. dapat ditulis
created datetime Waktu pembuatan item ini, yang 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, yang diformat sesuai dengan RFC 3339. Linimasa pengguna ini diurutkan secara kronologis dalam waktu tampilan, sehingga hal ini 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 disediakan untuk suatu item, html akan dirender di 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
  • Bingkai: 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. Hal 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 ke 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. Item tersebut hanya akan ditampilkan di linimasa utama, bukan di dalam paket yang dibuka.

Di linimasa utama, item yang ditampilkan adalah:
  • Item dengan isBundleCover ditetapkan ke true
  • Item yang tidak memiliki bundleId
Dalam sub-linimasa paket, item yang ditampilkan adalah:
  • Item yang memiliki bundleId yang dimaksud DAN isBundleCover ditetapkan ke false
dapat ditulis
isDeleted boolean Jika true (benar), menunjukkan bahwa item ini dihapus, dan hanya properti ID yang ditetapkan.
isPinned boolean Jika true (benar), menunjukkan bahwa item ini disematkan, yang berarti item tersebut dikelompokkan bersama "aktif" item seperti navigasi dan hangout, di sisi berlawanan dari layar beranda dari item garis waktu historis (yang tidak disematkan). Anda dapat mengizinkan pengguna mengubah nilai properti ini dengan item menu bawaan TOGGLE_PINNED.
kind string Jenis resource. Ini selalu mirror#timelineItem.
location nested object Lokasi geografis yang terkait dengan item ini. dapat ditulis
notification nested object Mengontrol bagaimana notifikasi untuk item ini ditampilkan di perangkat. Jika informasi ini tidak ada, notifikasi tidak akan dibuat. dapat ditulis
notification.deliveryTime datetime Waktu saat notifikasi harus dikirimkan. dapat ditulis
notification.level string Menjelaskan seberapa penting notifikasi. Nilai yang diizinkan adalah:
  • DEFAULT - Notifikasi tingkat kepentingan default. Lonceng akan diputar untuk memberi tahu pengguna.
 dapat ditulis
pinScore integer Untuk item yang disematkan, urutan item ditampilkan di linimasa, dengan skor yang lebih tinggi yang muncul lebih dekat dengan 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 di layanan Anda sendiri. dapat ditulis
speakableText string Versi lisan dari konten item ini. Bersama dengan item menu READ_ALOUD, gunakan kolom ini untuk memberikan teks yang akan lebih jelas saat dibaca dengan keras, atau untuk memberikan informasi yang diperluas tentang apa yang ditampilkan secara visual di Glass.

Gelas juga harus menentukan kolom speechableType, yang akan diucapkan sebelum teks ini jika konteks tambahan berguna, misalnya saat pengguna meminta item dibacakan dengan lantang setelah notifikasi.
 dapat ditulis
speakableType string Deskripsi yang dapat diucapkan dari jenis item ini. Hal ini akan diumumkan kepada pengguna sebelum membaca konten item jika konteks tambahan dapat digunakan, misalnya saat pengguna meminta item tersebut dibacakan secara lisan setelah notifikasi.

Frasa ini harus berupa frasa kata benda yang singkat dan sederhana seperti "Email", "Pesan teks", atau "Pembaruan Berita Daily Planet".

Glassware dianjurkan untuk mengisi kolom ini untuk setiap item linimasa, meskipun item tersebut tidak berisi speechableText 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 item ini terakhir diubah, diformat sesuai dengan RFC 3339.

Metode

hapus
Menghapus item linimasa.
dapatkan
Mendapatkan satu item linimasa berdasarkan ID.
sisipkan
Menyisipkan item baru ke linimasa.
list
Mengambil daftar item linimasa untuk pengguna yang diautentikasi.
patch
Memperbarui item linimasa. Metode ini mendukung semantik patch.
info terbaru
Memperbarui item linimasa.