Timeline

इस संसाधन के लिए तरीका जानने के लिए, इस पेज के आखिर में देखें.

संसाधन के बारे में जानकारी

उपयोगकर्ता की टाइमलाइन में मौजूद हर आइटम को, TimelineItem JSON स्ट्रक्चर के तौर पर दिखाया जाता है, जिसके बारे में नीचे बताया गया है.

{
  "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	इस आइटम से जुड़े मीडिया अटैचमेंट की सूची. सुविधा के तौर पर, आप अपने एचटीएमएल पेलोड में अटैचमेंट या सीआईडी स्कीम के साथ अटैचमेंट देख सकते हैं. उदाहरण के लिए: अटैचमेंट: <img src="attachment:attachment_index"> जहां attachments_index इस श्रेणी का 0-आधारित इंडेक्स है. सीआईडी: जहां <img src="cid:attachment_id">, अटैचमेंट का आईडी है.
bundleId	string	इस आइटम का बंडल आईडी. कई आइटम को एक साथ ग्रुप करने के लिए सेवाएं, एक बंडल आईडी बता सकती हैं. ये आइटम, डिवाइस में किसी टॉप लेवल आइटम के नीचे दिखते हैं.	लिखा जा सकता है
canonicalUrl	string	टाइमलाइन आइटम के ज़रिए दिखाए गए डेटा के कैननिकल/अच्छी क्वालिटी वाले वर्शन पर ले जाने वाला कैननिकल यूआरएल.	लिखा जा सकता है
created	datetime	आरएफ़सी 3339 के मुताबिक फ़ॉर्मैट करते समय, यह आइटम कब बनाया गया था.
creator	nested object	वह उपयोगकर्ता या ग्रुप जिसने यह आइटम बनाया है.	लिखा जा सकता है
displayTime	datetime	इस आइटम को टाइमलाइन में देखने का समय, आरएफ़सी 3339 के मुताबिक फ़ॉर्मैट किया जाना चाहिए. इस उपयोगकर्ता की टाइमलाइन, समय के हिसाब से, डिसप्ले समय पर क्रम से लगाई जाती है. इससे यह भी तय होता है कि टाइमलाइन में आइटम कहां दिखाया जाएगा. अगर सेवा ने इसे सेट नहीं किया है, तो डिसप्ले टाइम डिफ़ॉल्ट रूप से updated समय होता है.	लिखा जा सकता है
etag	etag	इस आइटम के लिए ई-टैग.
html	string	इस आइटम का एचटीएमएल कॉन्टेंट. अगर किसी आइटम के लिए text और 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 ब्लॉक किए गए एचटीएमएल एलिमेंट: ये एलिमेंट और उनके कॉन्टेंट, एचटीएमएल पेलोड से हटा दिए जाते हैं. दस्तावेज़ के हेडर: 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	सही होने पर, यह पता चलता है कि यह आइटम मिटा दिया गया है और सिर्फ़ आईडी प्रॉपर्टी को सेट किया गया है.
isPinned	boolean	सही होने पर, यह बताता है कि इस आइटम को पिन किया गया है. इसका मतलब है कि इसे नेविगेशन और Hangouts जैसे "चालू" आइटम के साथ एक ग्रुप में रखा गया है. ये आइटम, पिन किए गए टाइमलाइन आइटम की होम स्क्रीन से उलट होते हैं. उपयोगकर्ता, TOGGLE_PINNED बिल्ट-इन मेन्यू आइटम की मदद से इस प्रॉपर्टी की वैल्यू को टॉगल कर सकता है.
kind	string	संसाधन किस तरह का है. यह संख्या हमेशा mirror#timelineItem होती है.
location	nested object	इस आइटम से जुड़ी भौगोलिक जगह.	लिखा जा सकता है
menuItems[]	list	ऐसे मेन्यू आइटम की सूची जिन्हें टाइमलाइन में चुने जाने के बाद, लोगों को दिखाया जाएगा.	लिखा जा सकता है
menuItems[].action	string	उस समय के व्यवहार को कंट्रोल करता है, जब उपयोगकर्ता मेन्यू का विकल्प चुनता है. ये वैल्यू इस्तेमाल की जा सकती हैं: CUSTOM - सेवा की ओर से सेट की गई कस्टम कार्रवाई. जब उपयोगकर्ता इस menuItem को चुनते हैं, तो एपीआई आपके callbackUrl के लिए, userActions.type के साथ CUSTOM पर सेट किए गए और userActions.payload, इस मेन्यू आइटम के ID पर सेट किए गए नोटिफ़िकेशन को ट्रिगर करता है. यह डिफ़ॉल्ट मान है. बिल्ट-इन कार्रवाइयां: REPLY - वॉइस रिकॉर्डिंग यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, टाइमलाइन आइटम का जवाब दें. 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 - Glass वीडियो प्लेयर में मेन्यू के payload को खोलें. SEND_MESSAGE - टाइमलाइन आइटम के creator पर संदेश भेजना शुरू करें: अगर creator.phoneNumber सेट है और Glass किसी Android फ़ोन से कनेक्ट है, तो संदेश एक SMS है. अगर creator.email सेट है, तो मैसेज एक ईमेल होता है.	लिखा जा सकता है
menuItems[].id	string	इस मेन्यू आइटम का आईडी. यह ऐप्लिकेशन से जनरेट होता है और इसे अपारदर्शी टोकन माना जाता है.	लिखा जा सकता है
menuItems[].payload	string	एक सामान्य पेलोड, जिसका मतलब इस MenuItem की कार्रवाई के आधार पर बदलता है. जब कार्रवाई OPEN_URI हो, तब पेलोड उस वेबसाइट का यूआरएल होता है जिसे देखा जाना है. PLAY_VIDEO वाले ऐक्शन वीडियो में, वीडियो का स्ट्रीमिंग यूआरएल होता है जब कार्रवाई GET_MEDIA_INPUT हो, तो पेलोड उपयोगकर्ता के बोली इनपुट का टेक्स्ट ट्रांसक्रिप्शन होता है	लिखा जा सकता है
menuItems[].removeWhenSelected	boolean	अगर इसे CUSTOM मेन्यू आइटम पर 'सही है' पर सेट किया जाता है, तो उस आइटम को चुनने के बाद, उसे मेन्यू से हटा दिया जाएगा.	लिखा जा सकता है
menuItems[].values[]	list	CUSTOM आइटम के लिए, इसकी सूची के अलग-अलग राज्यों में मेन्यू आइटम के लुक को कंट्रोल किया जाता है. DEFAULT स्थिति के लिए एक वैल्यू दी जानी चाहिए. अगर PENDING या CONFIRMED राज्य मौजूद नहीं हैं, तो वे नहीं दिखाए जाएंगे.	लिखा जा सकता है
menuItems[].values[].displayName	string	मेन्यू आइटम के लिए दिखने वाला नाम. अगर आप पहले से मौजूद मेन्यू आइटम के लिए इस प्रॉपर्टी को तय करते हैं, तो उस आइटम के लिए, निर्देश के तौर पर डिफ़ॉल्ट वॉइस कमांड नहीं दिखाया जाएगा.	लिखा जा सकता है
menuItems[].values[].iconUrl	string	मेन्यू आइटम के साथ दिखाने के लिए, आइकॉन का यूआरएल.	लिखा जा सकता है
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	इस आइटम को फिर से पाने के लिए इस्तेमाल किया जा सकने वाला यूआरएल.
sourceItemId	string	एक अपारदर्शिता स्ट्रिंग, जिसे आप अपनी सेवा में डेटा के लिए एक टाइमलाइन आइटम को मैप करने के लिए इस्तेमाल कर सकते हैं.	लिखा जा सकता है
speakableText	string	इस आइटम के कॉन्टेंट का बोलकर बताने वाला वर्शन. READ_ALOUD के मेन्यू आइटम के साथ, इस फ़ील्ड का इस्तेमाल, टेक्स्ट को इस तरह से करने के लिए करें कि उसे ज़ोर से पढ़कर सुनाया जा सके. इसके अलावा, उसका इस्तेमाल ग्लास पर दिखने वाले कॉन्टेंट के बारे में ज़्यादा जानकारी देने के लिए भी किया जा सकता है. Glassware को speakableटाइप फ़ील्ड भी बताना चाहिए, जो इस टेक्स्ट से पहले बोला जाएगा. ऐसा तब किया जाता है, जब ज़्यादा संदर्भ काम का होता है. उदाहरण के लिए, जब उपयोगकर्ता किसी सूचना के बाद आइटम को पढ़ने का अनुरोध करता है.	लिखा जा सकता है
speakableType	string	इस आइटम के प्रकार का विवरण देने वाला ब्यौरा. जिन मामलों में ज़्यादा जानकारी ज़रूरी हो उन मामलों में, आइटम की सामग्री पढ़ने से पहले उपयोगकर्ता को इसकी सूचना दी जाएगी. उदाहरण के लिए, जब उपयोगकर्ता सूचना पाने के बाद उसे पढ़ने का अनुरोध करता है. में "ईमेल", "मैसेज" या "रोज़ के ग्रह की खबरों का अपडेट" जैसे छोटे, आसान संज्ञा वाले वाक्यांश होने चाहिए. Glassware को यह टाइमलाइन आइटम के लिए इस फ़ील्ड को पॉप्युलेट करने के लिए प्रोत्साहित किया जाता है. भले ही, आइटम में speakable टेक्स्ट या टेक्स्ट न हो, ताकि उपयोगकर्ता स्क्रीन को देखे बिना ही आइटम का टाइप जान सके.	लिखा जा सकता है
text	string	इस आइटम का टेक्स्ट कॉन्टेंट.	लिखा जा सकता है
title	string	इस आइटम का शीर्षक.	लिखा जा सकता है
updated	datetime	आरएफ़सी 3339 के मुताबिक, इस आइटम में पिछली बार बदलाव किए जाने का समय.

तरीके

मिटाएं

एक टाइमलाइन आइटम मिटाता है.

get

आईडी से एक टाइमलाइन आइटम पाता है.

शामिल करें

टाइमलाइन में एक नया आइटम डालता है.

list

पुष्टि किए गए उपयोगकर्ता के लिए टाइमलाइन आइटम की सूची लाता है.

पैच

समयावधि के आइटम को अपडेट करता है. यह तरीका पैच सिमेंटिक के साथ काम करता है.

अपडेट

समयावधि के आइटम को अपडेट करता है.