Timeline

ดูรายการเมธอดสําหรับทรัพยากรนี้ที่ท้ายหน้านี้

การนําเสนอแหล่งข้อมูล

แต่ละรายการในไทม์ไลน์ของผู้ใช้จะแสดงเป็นโครงสร้าง 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 ได้ เช่น ไฟล์แนบ: <img src="attachment:attachment_index"> โดยที่ attachments_index คือดัชนี 0 ของอาร์เรย์นี้ cid: <img src="cid:attachment_id"> โดยที่ attachments_id คือรหัสของไฟล์แนบ
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 ที่อนุญาต - คุณใช้องค์ประกอบเหล่านี้ในการ์ดไทม์ไลน์ได้ ส่วนหัว: h1, h2, h3, h4, h5, h6 รูปภาพ: img รายการ: li, ol, ul ความหมาย HTML5: article, aside, details, figure, figcaption, footer, header, nav, section, summary, time โครงสร้าง: blockquote, br, div, hr, p, span รูปแบบ: b, big, center, em, i, u, s, small, strike, strong, style, sub, sup ตาราง: table, tbody, td, tfoot, th, thead, tr องค์ประกอบ HTML ที่ถูกบล็อก: องค์ประกอบเหล่านี้และเนื้อหาขององค์ประกอบจะถูกนําออกจากเพย์โหลด HTML ส่วนหัวของเอกสาร: head, title ฝัง: audio, embed, object, source, video เฟรม: frame, frameset กําลังเขียนสคริปต์: applet, script องค์ประกอบอื่นๆ: องค์ประกอบที่ไม่อยู่ในรายการจะถูกนําออก แต่ยังคงเก็บองค์ประกอบเหล่านั้นไว้	เขียนได้
id	string	รหัสของรายการไทม์ไลน์ ซึ่งจะไม่ซ้ํากันภายในไทม์ไลน์ของผู้ใช้
inReplyTo	string	หากรายการนี้สร้างขึ้นเป็นการตอบกลับรายการอื่น ระบบจะตั้งค่าช่องนี้เป็นรหัสของรายการที่มีการตอบกลับ คุณสามารถใช้เพื่อแนบการตอบกลับไปยังการสนทนาหรือโพสต์ที่เหมาะสมได้
isBundleCover	boolean	รายการนี้เป็นปกหรือไม่ หากทําเครื่องหมายรายการเป็นปกหน้าปกแล้ว รายการนั้นจะเป็นทางเข้ากลุ่มรายการซึ่งมี bundleId เหมือนกับรายการนั้น โดยจะแสดงในไทม์ไลน์หลักเท่านั้น ไม่ใช่ภายในแพ็กเกจที่เปิด ในไทม์ไลน์หลัก รายการที่แสดงคือ รายการที่ตั้งค่า isBundleCover เป็น true รายการที่ไม่มี bundleId ในไทม์ไลน์ย่อยของแพ็กเกจ สิ่งที่จะแสดงมีดังนี้ รายการที่ตั้งค่า bundleId ที่เป็นปัญหา และ isBundleCover เป็น false	เขียนได้
isDeleted	boolean	เมื่อเป็นจริง แสดงว่ารายการนี้ถูกลบ และมีการตั้งค่าเฉพาะพร็อพเพอร์ตี้ ID เท่านั้น
isPinned	boolean	เมื่อเป็น "จริง" แสดงว่ารายการนี้ถูกปักหมุดไว้ ซึ่งหมายความว่าระบบจะจัดกลุ่มไว้ข้างรายการ "ใช้งานอยู่" เช่น การนําทางและ Hangouts ที่ฝั่งตรงข้ามของหน้าจอหลักจากรายการในไทม์ไลน์ที่ผ่านมา (ไม่ได้ปักหมุด) คุณสามารถอนุญาตให้ผู้ใช้สลับค่าของพร็อพเพอร์ตี้นี้ด้วยรายการในเมนูในตัวของ TOGGLE_PINNED
kind	string	ประเภทของทรัพยากร นี่เป็น mirror#timelineItem เสมอ
location	nested object	สถานที่ตั้งทางภูมิศาสตร์ที่เชื่อมโยงกับรายการนี้	เขียนได้
menuItems[]	list	รายการในเมนูที่จะปรากฏแก่ผู้ใช้เมื่อเลือกรายการนี้ในไทม์ไลน์	เขียนได้
menuItems[].action	string	ควบคุมการทํางานเมื่อผู้ใช้เลือกตัวเลือกเมนู ค่าที่อนุญาตคือ CUSTOM - การกระทําที่กําหนดเองที่กําหนดโดยบริการ เมื่อผู้ใช้เลือก menuItem นี้ API จะทริกเกอร์การแจ้งเตือนไปยัง callbackUrl โดยตั้งค่า userActions.type เป็น CUSTOM และตั้ง userActions.payload เป็น ID ของรายการเมนูนี้ นี่คือค่าเริ่มต้น การดําเนินการในตัว: REPLY - เริ่มต้นการตอบกลับรายการไทม์ไลน์โดยใช้ UI การบันทึกเสียง แอตทริบิวต์ creator ต้องตั้งเป็นรายการไทม์ไลน์เพื่อให้เมนูนี้พร้อมใช้งาน REPLY_ALL - ทํางานเหมือนกับ REPLY ระบบจะเพิ่ม recipients ของไทม์ไลน์ต้นฉบับในรายการตอบกลับ DELETE - ลบรายการไทม์ไลน์ SHARE - แชร์รายการในไทม์ไลน์กับรายชื่อติดต่อที่มีอยู่ READ_ALOUD - อ่านออกเสียงรายการ speakableText ของไทม์ไลน์ หากไม่ได้ตั้งค่าช่องนี้ โปรดอ่านช่อง text หากไม่มีการตั้งค่าช่องเหล่านี้ ระบบจะไม่สนใจรายการเมนูนี้ GET_MEDIA_INPUT - อนุญาตให้ผู้ใช้ส่งเพย์โหลดสื่อไปยัง Glassware จากรายการในเมนู (ปัจจุบันรองรับเฉพาะข้อความที่ถอดเสียงจากการป้อนข้อมูลด้วยเสียงเท่านั้น) สมัครรับการแจ้งเตือนเมื่อผู้ใช้เรียกใช้เมนูนี้เพื่อรับรหัสสินค้าในไทม์ไลน์ เรียกดูสื่อจากรายการไทม์ไลน์ในพร็อพเพอร์ตี้ payload VOICE_CALL - เริ่มต้นการโทรโดยใช้แอตทริบิวต์ creator.phoneNumber ของรายการไทม์ไลน์เป็นผู้รับ NAVIGATE - ไปที่locationของรายการไทม์ไลน์ TOGGLE_PINNED - สลับสถานะisPinnedของรายการไทม์ไลน์ OPEN_URI - เปิด payload ของรายการในเมนูในเบราว์เซอร์ PLAY_VIDEO - เปิด payload ของรายการในเมนูในโปรแกรมเล่นวิดีโอ Glass SEND_MESSAGE - เริ่มต้นส่งข้อความไปยัง creator ของรายการไทม์ไลน์: หากตั้งค่า creator.phoneNumber และ Glass เชื่อมต่อกับโทรศัพท์ Android ข้อความจะเป็น SMS มิฉะนั้น หากตั้งค่า creator.email ไว้ ข้อความจะเป็นอีเมล	เขียนได้
menuItems[].id	string	รหัสของรายการในเมนูนี้ ซึ่งแอปพลิเคชันสร้างขึ้นและถือว่าเป็นโทเค็นที่คลุมเครือ	เขียนได้
menuItems[].payload	string	เพย์โหลดทั่วไปที่เปลี่ยนความหมายของการกระทําของเมนูนี้ การดําเนินการคือ OPEN_URI เพย์โหลดคือ URL ของเว็บไซต์ที่ต้องการดู การดําเนินการคือ PLAY_VIDEO เพย์โหลดคือ URL สตรีมมิงของวิดีโอ การดําเนินการคือ GET_MEDIA_INPUT เพย์โหลดคือการถอดเสียงข้อความที่ผู้ใช้ป้อนคําพูด	เขียนได้
menuItems[].removeWhenSelected	boolean	หากตั้งค่าเป็น "จริง" ในรายการเมนูของ CUSTOM ระบบจะนํารายการนั้นออกจากเมนูหลังจากที่เลือกแล้ว	เขียนได้
menuItems[].values[]	list	สําหรับสินค้า CUSTOM รายการค่าที่ใช้ควบคุมลักษณะที่ปรากฏของรายการเมนูในแต่ละรัฐ ต้องระบุค่าสถานะ DEFAULT หากไม่มีรัฐ PENDING หรือ CONFIRMED รัฐจะไม่แสดง	เขียนได้
menuItems[].values[].displayName	string	ชื่อที่จะแสดงสําหรับรายการในเมนู หากคุณระบุพร็อพเพอร์ตี้นี้สําหรับรายการในเมนูในตัว คําสั่งเสียงตามบริบทเริ่มต้นสําหรับรายการในเมนูนั้นจะไม่แสดง	เขียนได้
menuItems[].values[].iconUrl	string	URL ของไอคอนที่จะแสดงร่วมกับรายการในเมนู	เขียนได้
menuItems[].values[].state	string	สถานะที่ค่านี้มีผล ค่าที่อนุญาตคือ DEFAULT - ค่าเริ่มต้นที่จะแสดงเมื่อแสดงในรายการ menuItems PENDING - ค่าที่แสดงเมื่อผู้ใช้เลือก menuItem แล้ว แต่ยังคงยกเลิกได้อยู่ CONFIRMED - ค่าที่แสดงเมื่อผู้ใช้เลือกเมนูรายการแล้ว และจะยกเลิกไม่ได้	เขียนได้
notification	nested object	ควบคุมวิธีแสดงการแจ้งเตือนสําหรับรายการนี้ในอุปกรณ์ หากไม่พบ ระบบจะสร้างการแจ้งเตือน	เขียนได้
notification.deliveryTime	datetime	เวลาในการส่งการแจ้งเตือน	เขียนได้
notification.level	string	อธิบายว่าการแจ้งเตือนสําคัญแค่ไหน ค่าที่อนุญาตคือ DEFAULT - การแจ้งเตือนความสําคัญเริ่มต้น เสียงกริ่งจะเล่นเพื่อแจ้งเตือนผู้ใช้	เขียนได้
pinScore	integer	สําหรับรายการที่ปักหมุดไว้ การดําเนินการนี้จะกําหนดลําดับที่รายการจะแสดงในไทม์ไลน์ โดยคะแนนที่สูงขึ้นจะปรากฏใกล้กับนาฬิกามากขึ้น หมายเหตุ: ยังไม่รองรับการตั้งค่าช่องนี้
recipients[]	list	รายชื่อผู้ใช้หรือกลุ่มที่มีการแชร์รายการนี้ด้วย	เขียนได้
selfLink	string	URL ที่ใช้เรียกรายการนี้ได้
sourceItemId	string	สตริงทึบที่คุณใช้เพื่อจับคู่รายการไทม์ไลน์กับข้อมูลในบริการของคุณเอง	เขียนได้
speakableText	string	เนื้อหาที่พูดได้ในรายการนี้ ในรายการเมนูของ READ_ALOUD ให้ใช้ช่องนี้เพื่อระบุข้อความที่จะชัดเจนขึ้นเมื่ออ่านออกเสียง หรือเพื่อให้ข้อมูลเพิ่มเติมเกี่ยวกับสิ่งที่แสดงใน Glass Glassware ควรระบุช่อง SpeakableType ซึ่งจะพูดก่อนข้อความนี้ในกรณีที่บริบทเพิ่มเติมมีประโยชน์ เช่น เมื่อผู้ใช้ขอให้รายการนี้อ่านออกเสียงตามการแจ้งเตือน	เขียนได้
speakableType	string	คําอธิบายที่พูดได้ของประเภทรายการนี้ ระบบจะแจ้งให้ผู้ใช้ทราบก่อนที่จะอ่านเนื้อหาของรายการในกรณีที่บริบทเพิ่มเติมมีประโยชน์ เช่น เมื่อผู้ใช้ขอให้รายการดังกล่าวอ่านออกเสียงหลังจากการแจ้งเตือน ควรเป็นวลีสั้นๆ ที่เรียบง่ายและเป็นคํานาม เช่น "อีเมล" "SMS" หรือ "การอัปเดตข่าวประจําวันของดาวเคราะห์" เราขอแนะนําให้ใช้ Glassware เพื่อเติมข้อมูลในช่องนี้สําหรับทุกรายการในไทม์ไลน์ แม้ว่ารายการดังกล่าวจะไม่มี SpeakableText หรือ SMS เพื่อให้ผู้ใช้ได้เรียนรู้ประเภทของรายการโดยไม่ต้องดูหน้าจอ	เขียนได้
text	string	เนื้อหาข้อความของรายการนี้	เขียนได้
title	string	ชื่อของรายการนี้	เขียนได้
updated	datetime	เวลาที่แก้ไขรายการนี้ครั้งล่าสุด ซึ่งจัดรูปแบบตาม RFC 3339

วิธีการ

ลบ

ลบรายการไทม์ไลน์

รับ

รับสินค้าในไทม์ไลน์รายการเดียวตามรหัส

แทรก

แทรกรายการใหม่ในไทม์ไลน์

list

เรียกข้อมูลรายการไทม์ไลน์สําหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

แพตช์

อัปเดตรายการไทม์ไลน์ที่แสดงอยู่ วิธีการนี้รองรับความหมายแพตช์

อัปเดต

อัปเดตรายการไทม์ไลน์ที่แสดงอยู่