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:
|
|
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.
Elemen HTML yang diblokir: Elemen ini dan kontennya dihapus dari payload HTML.
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:
|
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 |
menuItems[] |
list |
Daftar item menu yang akan ditampilkan kepada pengguna saat item ini dipilih di linimasa. | dapat ditulis |
menuItems[].action |
string |
Mengontrol perilaku ketika pengguna memilih opsi menu. Nilai yang diizinkan adalah:
|
dapat ditulis |
menuItems[].id |
string |
ID untuk item menu ini. Ini dibuat oleh aplikasi dan diperlakukan sebagai token buram. | dapat ditulis |
menuItems[].payload |
string |
Payload umum yang artinya berubah bergantung pada tindakan Polyline ini.
|
dapat ditulis |
menuItems[].removeWhenSelected |
boolean |
Jika disetel ke benar pada item menu CUSTOM , item tersebut akan dihapus dari menu setelah dipilih. |
dapat ditulis |
menuItems[].values[] |
list |
Untuk item CUSTOM , daftar nilai yang mengontrol tampilan item menu di setiap statusnya. Nilai untuk status DEFAULT harus diberikan. Jika status PENDING atau CONFIRMED tidak ada, status tersebut tidak akan ditampilkan. |
dapat ditulis |
menuItems[].values[].displayName |
string |
Nama yang akan ditampilkan untuk item menu. Jika Anda menentukan properti ini untuk item menu bawaan, perintah suara kontekstual default untuk item menu tersebut tidak akan ditampilkan. | dapat ditulis |
menuItems[].values[].iconUrl |
string |
URL ikon yang akan ditampilkan dengan item menu. | dapat ditulis |
menuItems[].values[].state |
string |
Status tempat nilai ini diterapkan. Nilai yang diizinkan adalah:
|
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:
|
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 |
selfLink |
string |
URL yang dapat digunakan untuk mengambil item ini. | |
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.