ดูรายการเมธอดสําหรับทรัพยากรนี้ที่ท้ายหน้านี้
การนําเสนอแหล่งข้อมูล
แต่ละรายการในไทม์ไลน์ของผู้ใช้จะแสดงเป็นโครงสร้าง JSON TimelineItem
ตามที่อธิบายไว้ด้านล่าง
{ "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 } }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
attachments[] |
list |
รายการไฟล์แนบสื่อที่เชื่อมโยงกับรายการนี้ คุณสามารถอ้างอิงไฟล์แนบในเพย์โหลด HTML ด้วยไฟล์แนบหรือ CID Scheme ได้ เช่น
|
|
bundleId |
string |
รหัสชุดสําหรับสินค้านี้ บริการจะระบุ BundleId เพื่อจัดกลุ่มรายการเข้าด้วยกันได้ ซึ่งจะปรากฏใต้รายการระดับบนสุดรายการเดียวในอุปกรณ์ | เขียนได้ |
canonicalUrl |
string |
Canonical URL ที่ชี้ไปยังข้อมูล Canonical/เวอร์ชันคุณภาพสูงของข้อมูลที่แสดงโดยรายการไทม์ไลน์ | เขียนได้ |
created |
datetime |
เวลาที่สร้างรายการนี้ ซึ่งจัดรูปแบบตาม RFC 3339 | |
creator |
nested object |
ผู้ใช้หรือกลุ่มที่สร้างรายการนี้ | เขียนได้ |
displayTime |
datetime |
เวลาที่ควรแสดงเมื่อมีการดูรายการนี้ในไทม์ไลน์ ซึ่งอยู่ในรูปแบบ RFC 3339 ไทม์ไลน์ของผู้ใช้จะจัดเรียงตามลําดับเวลาในการแสดง ดังนั้น การตั้งค่านี้จึงเป็นตัวกําหนดตําแหน่งที่จะแสดงข้อมูลในไทม์ไลน์ หากไม่ได้กําหนดโดยบริการ เวลาที่แสดงจะเริ่มต้นที่เวลา updated |
เขียนได้ |
etag |
etag |
ETag สําหรับรายการนี้ | |
html |
string |
เนื้อหา HTML สําหรับรายการนี้ หากระบุทั้ง text และ html ไว้ รายการ html จะแสดงผลในไทม์ไลน์ องค์ประกอบ HTML ที่อนุญาต - คุณใช้องค์ประกอบเหล่านี้ในการ์ดไทม์ไลน์ได้
องค์ประกอบ HTML ที่ถูกบล็อก: องค์ประกอบเหล่านี้และเนื้อหาขององค์ประกอบจะถูกนําออกจากเพย์โหลด HTML
องค์ประกอบอื่นๆ: องค์ประกอบที่ไม่อยู่ในรายการจะถูกนําออก แต่ยังคงเก็บองค์ประกอบเหล่านั้นไว้ |
เขียนได้ |
id |
string |
รหัสของรายการไทม์ไลน์ ซึ่งจะไม่ซ้ํากันภายในไทม์ไลน์ของผู้ใช้ | |
inReplyTo |
string |
หากรายการนี้สร้างขึ้นเป็นการตอบกลับรายการอื่น ระบบจะตั้งค่าช่องนี้เป็นรหัสของรายการที่มีการตอบกลับ คุณสามารถใช้เพื่อแนบการตอบกลับไปยังการสนทนาหรือโพสต์ที่เหมาะสมได้ | |
isBundleCover |
boolean |
รายการนี้เป็นปกหรือไม่ หากทําเครื่องหมายรายการเป็นปกหน้าปกแล้ว รายการนั้นจะเป็นทางเข้ากลุ่มรายการซึ่งมี bundleId เหมือนกับรายการนั้น โดยจะแสดงในไทม์ไลน์หลักเท่านั้น ไม่ใช่ภายในแพ็กเกจที่เปิดในไทม์ไลน์หลัก รายการที่แสดงคือ
|
เขียนได้ |
isDeleted |
boolean |
เมื่อเป็นจริง แสดงว่ารายการนี้ถูกลบ และมีการตั้งค่าเฉพาะพร็อพเพอร์ตี้ ID เท่านั้น | |
isPinned |
boolean |
เมื่อเป็น "จริง" แสดงว่ารายการนี้ถูกปักหมุดไว้ ซึ่งหมายความว่าระบบจะจัดกลุ่มไว้ข้างรายการ "ใช้งานอยู่" เช่น การนําทางและ Hangouts ที่ฝั่งตรงข้ามของหน้าจอหลักจากรายการในไทม์ไลน์ที่ผ่านมา (ไม่ได้ปักหมุด) คุณสามารถอนุญาตให้ผู้ใช้สลับค่าของพร็อพเพอร์ตี้นี้ด้วยรายการในเมนูในตัวของ TOGGLE_PINNED |
|
kind |
string |
ประเภทของทรัพยากร นี่เป็น mirror#timelineItem เสมอ |
|
location |
nested object |
สถานที่ตั้งทางภูมิศาสตร์ที่เชื่อมโยงกับรายการนี้ | เขียนได้ |
menuItems[] |
list |
รายการในเมนูที่จะปรากฏแก่ผู้ใช้เมื่อเลือกรายการนี้ในไทม์ไลน์ | เขียนได้ |
menuItems[].action |
string |
ควบคุมการทํางานเมื่อผู้ใช้เลือกตัวเลือกเมนู ค่าที่อนุญาตคือ
|
เขียนได้ |
menuItems[].id |
string |
รหัสของรายการในเมนูนี้ ซึ่งแอปพลิเคชันสร้างขึ้นและถือว่าเป็นโทเค็นที่คลุมเครือ | เขียนได้ |
menuItems[].payload |
string |
เพย์โหลดทั่วไปที่เปลี่ยนความหมายของการกระทําของเมนูนี้
|
เขียนได้ |
menuItems[].removeWhenSelected |
boolean |
หากตั้งค่าเป็น "จริง" ในรายการเมนูของ CUSTOM ระบบจะนํารายการนั้นออกจากเมนูหลังจากที่เลือกแล้ว |
เขียนได้ |
menuItems[].values[] |
list |
สําหรับสินค้า CUSTOM รายการค่าที่ใช้ควบคุมลักษณะที่ปรากฏของรายการเมนูในแต่ละรัฐ ต้องระบุค่าสถานะ DEFAULT หากไม่มีรัฐ PENDING หรือ CONFIRMED รัฐจะไม่แสดง |
เขียนได้ |
menuItems[].values[].displayName |
string |
ชื่อที่จะแสดงสําหรับรายการในเมนู หากคุณระบุพร็อพเพอร์ตี้นี้สําหรับรายการในเมนูในตัว คําสั่งเสียงตามบริบทเริ่มต้นสําหรับรายการในเมนูนั้นจะไม่แสดง | เขียนได้ |
menuItems[].values[].iconUrl |
string |
URL ของไอคอนที่จะแสดงร่วมกับรายการในเมนู | เขียนได้ |
menuItems[].values[].state |
string |
สถานะที่ค่านี้มีผล ค่าที่อนุญาตคือ
|
เขียนได้ |
notification |
nested object |
ควบคุมวิธีแสดงการแจ้งเตือนสําหรับรายการนี้ในอุปกรณ์ หากไม่พบ ระบบจะสร้างการแจ้งเตือน | เขียนได้ |
notification.deliveryTime |
datetime |
เวลาในการส่งการแจ้งเตือน | เขียนได้ |
notification.level |
string |
อธิบายว่าการแจ้งเตือนสําคัญแค่ไหน ค่าที่อนุญาตคือ
|
เขียนได้ |
pinScore |
integer |
สําหรับรายการที่ปักหมุดไว้ การดําเนินการนี้จะกําหนดลําดับที่รายการจะแสดงในไทม์ไลน์ โดยคะแนนที่สูงขึ้นจะปรากฏใกล้กับนาฬิกามากขึ้น หมายเหตุ: ยังไม่รองรับการตั้งค่าช่องนี้ | |
recipients[] |
list |
รายชื่อผู้ใช้หรือกลุ่มที่มีการแชร์รายการนี้ด้วย | เขียนได้ |
selfLink |
string |
URL ที่ใช้เรียกรายการนี้ได้ | |
sourceItemId |
string |
สตริงทึบที่คุณใช้เพื่อจับคู่รายการไทม์ไลน์กับข้อมูลในบริการของคุณเอง | เขียนได้ |
speakableText |
string |
เนื้อหาที่พูดได้ในรายการนี้ ในรายการเมนูของ READ_ALOUD ให้ใช้ช่องนี้เพื่อระบุข้อความที่จะชัดเจนขึ้นเมื่ออ่านออกเสียง หรือเพื่อให้ข้อมูลเพิ่มเติมเกี่ยวกับสิ่งที่แสดงใน GlassGlassware ควรระบุช่อง SpeakableType ซึ่งจะพูดก่อนข้อความนี้ในกรณีที่บริบทเพิ่มเติมมีประโยชน์ เช่น เมื่อผู้ใช้ขอให้รายการนี้อ่านออกเสียงตามการแจ้งเตือน |
เขียนได้ |
speakableType |
string |
คําอธิบายที่พูดได้ของประเภทรายการนี้ ระบบจะแจ้งให้ผู้ใช้ทราบก่อนที่จะอ่านเนื้อหาของรายการในกรณีที่บริบทเพิ่มเติมมีประโยชน์ เช่น เมื่อผู้ใช้ขอให้รายการดังกล่าวอ่านออกเสียงหลังจากการแจ้งเตือน ควรเป็นวลีสั้นๆ ที่เรียบง่ายและเป็นคํานาม เช่น "อีเมล" "SMS" หรือ "การอัปเดตข่าวประจําวันของดาวเคราะห์" เราขอแนะนําให้ใช้ Glassware เพื่อเติมข้อมูลในช่องนี้สําหรับทุกรายการในไทม์ไลน์ แม้ว่ารายการดังกล่าวจะไม่มี SpeakableText หรือ SMS เพื่อให้ผู้ใช้ได้เรียนรู้ประเภทของรายการโดยไม่ต้องดูหน้าจอ |
เขียนได้ |
text |
string |
เนื้อหาข้อความของรายการนี้ | เขียนได้ |
title |
string |
ชื่อของรายการนี้ | เขียนได้ |
updated |
datetime |
เวลาที่แก้ไขรายการนี้ครั้งล่าสุด ซึ่งจัดรูปแบบตาม RFC 3339 |