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"> โดยที่ไฟล์แนบ_ดัชนี คือดัชนีฐาน 0 ของอาร์เรย์นี้ cid: <img src="cid:attachment_id"> โดยที่ไฟล์แนบ_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 เหมือนกับสินค้าดังกล่าว ข้อมูลจะแสดงในไทม์ไลน์หลักเท่านั้น โดยไม่แสดงใน Bundle ที่เปิดไว้ ในไทม์ไลน์หลัก รายการที่แสดงคือ รายการที่ตั้งค่า isBundleCover เป็น true รายการที่ไม่มี bundleId ในไทม์ไลน์ย่อยแพ็กเกจ รายการที่แสดงคือ รายการที่ตั้งค่า bundleId ที่เป็นปัญหา และ isBundleCover เป็น false	เขียนได้
isDeleted	boolean	เมื่อเป็น "จริง" หมายความว่ารายการนี้ถูกลบ และตั้งค่าเฉพาะพร็อพเพอร์ตี้รหัสเท่านั้น
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 (ปัจจุบันรองรับเฉพาะข้อความที่ถอดเสียงจากการป้อนข้อมูลด้วยเสียงเท่านั้น) สมัครรับการแจ้งเตือนเมื่อผู้ใช้เรียกใช้รายการในเมนูนี้เพื่อรับรหัสรายการในไทม์ไลน์ เรียกข้อมูลสื่อจากรายการไทม์ไลน์ในพร็อพเพอร์ตี้เพย์โหลด 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	เพย์โหลดทั่วไปที่ความหมายเปลี่ยนไปตามการดำเนินการของ MenuItem นี้ เมื่อการดำเนินการคือ 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 กลาสแวร์ควรระบุช่อง SpeakableType ซึ่งจะพูดก่อนข้อความนี้ในกรณีที่บริบทเพิ่มเติมมีประโยชน์ เช่น เมื่อผู้ใช้ขอให้อ่านออกเสียงรายการหลังจากการแจ้งเตือน	เขียนได้
speakableType	string	คำอธิบายประเภทของรายการนี้ที่พูดได้ โดยจะประกาศให้ผู้ใช้ทราบก่อนอ่านเนื้อหาของรายการในกรณีที่บริบทเพิ่มเติมมีประโยชน์ เช่น เมื่อผู้ใช้ขอให้อ่านออกเสียงรายการนั้นหลังจากการแจ้งเตือน ข้อมูลนี้ควรเป็นวลีคำนามสั้นๆ ง่ายๆ เช่น "อีเมล" "ข้อความ" หรือ "อัปเดตข่าวดาวเคราะห์รายวัน" เราขอแนะนำให้กลาสแวร์กรอกข้อมูลในช่องนี้สำหรับทุกรายการในไทม์ไลน์ แม้ว่ารายการนั้นจะไม่มีข้อความหรือข้อความที่พูดได้ เพื่อให้ผู้ใช้เรียนรู้ประเภทของรายการได้โดยไม่ต้องมองหน้าจอ	เขียนได้
text	string	เนื้อหาข้อความของรายการนี้	เขียนได้
title	string	ชื่อของรายการนี้	เขียนได้
updated	datetime	เวลาที่แก้ไขรายการนี้ครั้งล่าสุด ซึ่งอยู่ในรูปแบบตาม RFC 3339

เมธอด

ลบ

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

รับ

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

แทรก

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

list

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

แพตช์

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

อัปเดต

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