इस संसाधन के लिए तरीका जानने के लिए, इस पेज के आखिर में देखें.
संसाधन के बारे में जानकारी
उपयोगकर्ता की टाइमलाइन में मौजूद हर आइटम को, 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 |
इस आइटम से जुड़े मीडिया अटैचमेंट की सूची. सुविधा के तौर पर, आप अपने एचटीएमएल पेलोड में अटैचमेंट या सीआईडी स्कीम के साथ अटैचमेंट देख सकते हैं. उदाहरण के लिए:
|
|
bundleId |
string |
इस आइटम का बंडल आईडी. कई आइटम को एक साथ ग्रुप करने के लिए सेवाएं, एक बंडल आईडी बता सकती हैं. ये आइटम, डिवाइस में किसी टॉप लेवल आइटम के नीचे दिखते हैं. | लिखा जा सकता है |
canonicalUrl |
string |
टाइमलाइन आइटम के ज़रिए दिखाए गए डेटा के कैननिकल/अच्छी क्वालिटी वाले वर्शन पर ले जाने वाला कैननिकल यूआरएल. | लिखा जा सकता है |
created |
datetime |
आरएफ़सी 3339 के मुताबिक फ़ॉर्मैट करते समय, यह आइटम कब बनाया गया था. | |
creator |
nested object |
वह उपयोगकर्ता या ग्रुप जिसने यह आइटम बनाया है. | लिखा जा सकता है |
displayTime |
datetime |
इस आइटम को टाइमलाइन में देखने का समय, आरएफ़सी 3339 के मुताबिक फ़ॉर्मैट किया जाना चाहिए. इस उपयोगकर्ता की टाइमलाइन, समय के हिसाब से, डिसप्ले समय पर क्रम से लगाई जाती है. इससे यह भी तय होता है कि टाइमलाइन में आइटम कहां दिखाया जाएगा. अगर सेवा ने इसे सेट नहीं किया है, तो डिसप्ले टाइम डिफ़ॉल्ट रूप से updated समय होता है. |
लिखा जा सकता है |
etag |
etag |
इस आइटम के लिए ई-टैग. | |
html |
string |
इस आइटम का एचटीएमएल कॉन्टेंट. अगर किसी आइटम के लिए text और html , दोनों दिए गए हैं, तो html को टाइमलाइन में रेंडर किया जाएगा. मंज़ूर किए गए एचटीएमएल एलिमेंट - आप अपने टाइमलाइन कार्ड में इन एलिमेंट का इस्तेमाल कर सकते हैं.
ब्लॉक किए गए एचटीएमएल एलिमेंट: ये एलिमेंट और उनके कॉन्टेंट, एचटीएमएल पेलोड से हटा दिए जाते हैं.
अन्य एलिमेंट: जो एलिमेंट सूची में नहीं हैं उन्हें हटा दिया जाता है, लेकिन उनका कॉन्टेंट सुरक्षित रखा जाता है. |
लिखा जा सकता है |
id |
string |
टाइमलाइन आइटम का आईडी. यह एक उपयोगकर्ता की टाइमलाइन में यूनीक है. | |
inReplyTo |
string |
अगर यह आइटम किसी दूसरे आइटम के जवाब के रूप में जनरेट किया गया था, तो इस फ़ील्ड को उस आइटम के आईडी पर सेट किया जाएगा जिसका जवाब दिया जा रहा है. इसका इस्तेमाल, सही बातचीत या पोस्ट का जवाब देने के लिए किया जा सकता है. | |
isBundleCover |
boolean |
यह आइटम, बंडल कवर है या नहीं. अगर किसी आइटम को बंडल कवर के रूप में मार्क किया जाता है, तो वह उस आइटम के बंडल के लिए एंट्री पॉइंट होगा जो bundleId उस आइटम के समान है. यह सिर्फ़ मुख्य समयावधि पर दिखाया जाएगा — खुले बंडल में नहीं.मुख्य समयावधि के दौरान, ये आइटम दिखाए जाते हैं:
|
लिखा जा सकता है |
isDeleted |
boolean |
सही होने पर, यह पता चलता है कि यह आइटम मिटा दिया गया है और सिर्फ़ आईडी प्रॉपर्टी को सेट किया गया है. | |
isPinned |
boolean |
सही होने पर, यह बताता है कि इस आइटम को पिन किया गया है. इसका मतलब है कि इसे नेविगेशन और Hangouts जैसे "चालू" आइटम के साथ एक ग्रुप में रखा गया है. ये आइटम, पिन किए गए टाइमलाइन आइटम की होम स्क्रीन से उलट होते हैं. उपयोगकर्ता, TOGGLE_PINNED बिल्ट-इन मेन्यू आइटम की मदद से इस प्रॉपर्टी की वैल्यू को टॉगल कर सकता है. |
|
kind |
string |
संसाधन किस तरह का है. यह संख्या हमेशा mirror#timelineItem होती है. |
|
location |
nested object |
इस आइटम से जुड़ी भौगोलिक जगह. | लिखा जा सकता है |
menuItems[] |
list |
ऐसे मेन्यू आइटम की सूची जिन्हें टाइमलाइन में चुने जाने के बाद, लोगों को दिखाया जाएगा. | लिखा जा सकता है |
menuItems[].action |
string |
उस समय के व्यवहार को कंट्रोल करता है, जब उपयोगकर्ता मेन्यू का विकल्प चुनता है. ये वैल्यू इस्तेमाल की जा सकती हैं:
|
लिखा जा सकता है |
menuItems[].id |
string |
इस मेन्यू आइटम का आईडी. यह ऐप्लिकेशन से जनरेट होता है और इसे अपारदर्शी टोकन माना जाता है. | लिखा जा सकता है |
menuItems[].payload |
string |
एक सामान्य पेलोड, जिसका मतलब इस MenuItem की कार्रवाई के आधार पर बदलता है.
|
लिखा जा सकता है |
menuItems[].removeWhenSelected |
boolean |
अगर इसे CUSTOM मेन्यू आइटम पर 'सही है' पर सेट किया जाता है, तो उस आइटम को चुनने के बाद, उसे मेन्यू से हटा दिया जाएगा. |
लिखा जा सकता है |
menuItems[].values[] |
list |
CUSTOM आइटम के लिए, इसकी सूची के अलग-अलग राज्यों में मेन्यू आइटम के लुक को कंट्रोल किया जाता है. DEFAULT स्थिति के लिए एक वैल्यू दी जानी चाहिए. अगर PENDING या CONFIRMED राज्य मौजूद नहीं हैं, तो वे नहीं दिखाए जाएंगे. |
लिखा जा सकता है |
menuItems[].values[].displayName |
string |
मेन्यू आइटम के लिए दिखने वाला नाम. अगर आप पहले से मौजूद मेन्यू आइटम के लिए इस प्रॉपर्टी को तय करते हैं, तो उस आइटम के लिए, निर्देश के तौर पर डिफ़ॉल्ट वॉइस कमांड नहीं दिखाया जाएगा. | लिखा जा सकता है |
menuItems[].values[].iconUrl |
string |
मेन्यू आइटम के साथ दिखाने के लिए, आइकॉन का यूआरएल. | लिखा जा सकता है |
menuItems[].values[].state |
string |
वह राज्य जिस पर यह वैल्यू लागू होती है. ये वैल्यू इस्तेमाल की जा सकती हैं:
|
लिखा जा सकता है |
notification |
nested object |
इस नीति से यह कंट्रोल किया जाता है कि डिवाइस में इस आइटम की सूचनाएं किस तरह दिखाई जाएं. अगर यह जानकारी मौजूद नहीं है, तो कोई सूचना जनरेट नहीं की जाएगी. | लिखा जा सकता है |
notification.deliveryTime |
datetime |
सूचना डिलीवर होने का समय. | लिखा जा सकता है |
notification.level |
string |
यह बताता है कि सूचना कितनी ज़रूरी है. ये वैल्यू डाली जा सकती हैं:
|
लिखा जा सकता है |
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
- पुष्टि किए गए उपयोगकर्ता के लिए टाइमलाइन आइटम की सूची लाता है.
- पैच
- समयावधि के आइटम को अपडेट करता है. यह तरीका पैच सिमेंटिक के साथ काम करता है.
- अपडेट
- समयावधि के आइटम को अपडेट करता है.