टिप्पणियां: टिप्पणियां दो तरह की होती हैं: एंकर की गई टिप्पणियां और ऐंकर की नहीं की गई टिप्पणियां. ऐंकर की गई टिप्पणी किसी खास जगह से जुड़ी होती है. जैसे, वर्ड प्रोसेसिंग दस्तावेज़ में मौजूद वाक्य, दस्तावेज़ के किसी खास वर्शन में. इसके उलट, बिना ऐंकर की गई टिप्पणी सिर्फ़ दस्तावेज़ से जुड़ी होती है.
जवाब टिप्पणियों के साथ जुड़े होते हैं और टिप्पणी पर उपयोगकर्ता का जवाब दिखाते हैं. Google Drive API से आपके उपयोगकर्ता, आपके ऐप्लिकेशन के बनाए गए दस्तावेज़ों पर टिप्पणी कर सकते हैं और उन पर जवाब दे सकते हैं. सभी टिप्पणियों पर जवाबों को चर्चा कहते हैं.
ऐंकर न की गई टिप्पणी जोड़ें
किसी दस्तावेज़ में बिना ऐंकर वाली टिप्पणी जोड़ने के लिए, comments.create तरीके को कॉल करें. इसके लिए, fileId पैरामीटर और उस comments संसाधन का इस्तेमाल करें जिसमें टिप्पणी मौजूद हो.
टिप्पणी को सादे टेक्स्ट के तौर पर डाला गया है. हालांकि, रिस्पॉन्स का मुख्य हिस्सा htmlContent वाला फ़ील्ड देता है, जिसमें डिसप्ले के लिए फ़ॉर्मैट किया गया कॉन्टेंट होता है.
टिप्पणी का जवाब दें
किसी टिप्पणी का जवाब देने के लिए, टिप्पणी के साथ replies.create तरीके को कॉल करें,
fileId पैरामीटर और एक reply संसाधन
का इस्तेमाल करें जिसमें जवाब शामिल हो.
जवाब को सादे टेक्स्ट के तौर पर डाला गया है, लेकिन जवाब का मुख्य हिस्सा htmlContent फ़ील्ड में कॉन्टेंट दिखाता है, जिसे दिखाने के लिए फ़ॉर्मैट किया गया है.
दस्तावेज़ के नए वर्शन में ऐंकर की गई टिप्पणी जोड़ें
जब कोई टिप्पणी जोड़ी जाती है, तो हो सकता है कि आप उसे फ़ाइल में किसी जगह पर ऐंकर करना चाहें. एंकर फ़ाइल में किसी फ़ाइल में बदलाव और उस जगह के बारे में बताता है जहां कोई टिप्पणी आती है. comments संसाधन, anchor फ़ील्ड को JSON स्ट्रिंग के तौर पर बताता है.
ऐंकर की गई टिप्पणी जोड़ने के लिए:
(ज़रूरी नहीं). किसी दस्तावेज़ के हर
revisionIDको शामिल करने के लिए,revisions.listतरीके को कॉल करें. यह चरण सिर्फ़ तब अपनाएं, जब आपको नए वर्शन के अलावा किसी और बदलाव के लिए टिप्पणी को ऐंकर करना हो. अगर आपको नया वर्शन इस्तेमाल करना है, तोrevisionIDके लिएheadका इस्तेमाल करें.comments.createतरीके को कॉल करने के लिए,fileIDपैरामीटर का इस्तेमाल करें. साथ ही,commentsके लिए टिप्पणी वाला रिसॉर्स, और JSON (r) और क्षेत्र (a) वाली JSON ऐंकर स्ट्रिंग भी शामिल करें.revisionID
क्षेत्र तय करने का तरीका इस बात पर निर्भर करता है कि आपके दस्तावेज़ में किस तरह का कॉन्टेंट है. ज़्यादा जानकारी के लिए, नीचे इलाका तय करें देखें.
क्षेत्र तय करें
जैसा कि पहले बताया गया है, JSON ऐंकर स्ट्रिंग में revisionID (r) और क्षेत्र (a) शामिल है. क्षेत्र (a), एक JSON कलेक्शन है. इसमें क्षेत्र की कैटगरी तय करने वाले टूल मौजूद हैं. यह उस फ़ॉर्मैट और जगह के बारे में बताता है जहां टिप्पणी को ऐंकर किया गया है. क्लासिफ़ायर
किसी इमेज के लिए दो-डाइमेंशन वाला रेक्टैंगल हो सकता है, दस्तावेज़ में टेक्स्ट की एक लाइन हो सकती है, वीडियो में समयावधि तय हो सकती है वगैरह. क्षेत्र तय करने के लिए, क्षेत्र
क्लासिफ़ायर चुनें. यह उस कॉन्टेंट के टाइप से मेल खाता है जिस पर आपको ऐंकर करने की कोशिश की जा रही है. उदाहरण के लिए, अगर आपका कॉन्टेंट टेक्स्ट है, तो txt या line रीजन क्लासीफ़ायर इस्तेमाल किया जा सकता है.
Drive API में रीजन क्लासिफ़ायर की सूची के लिए, क्षेत्र क्लासिफ़ायर देखें.
यहां दिया गया उदाहरण एक JSON ऐंकर स्ट्रिंग दिखाता है, जो दस्तावेज़ के दो अलग-अलग हिस्सों में लाइनों पर टिप्पणियों को ऐंकर करता है:
- पहला एरिया, लाइन 12 से शुरू होता है. यह लाइन 12 (
'n':12) से शुरू होता है और तीन लाइन ('l':3) तक फैलता है. - दूसरी जगह सिर्फ़ लाइन 18 (
'n':18, 'l':1`) को कवर करती है.
{
'r': 'REVISION_ID',
'a': [
{
'line':
{
'n': 12,
'l': 3,
}
},
{
'line':
{
'n': 18,
'l': 1,
}
}]
}
REVISION_ID की जगह head या किसी खास बदलाव के आईडी का इस्तेमाल करें.
टिप्पणी को बंद करें
comment.update तरीके का इस्तेमाल करके, comments संसाधन में resolved प्रॉपर्टी को true पर सेट करें. ऐसा तब करें, जब किसी टिप्पणी का जवाब दिया गया हो.
जब आपका ऐप्लिकेशन resolved प्रॉपर्टी को true पर सेट करता है, तो आपके यूज़र इंटरफ़ेस (यूआई) से यह पता चलना चाहिए कि टिप्पणी पर ध्यान दिया गया है. उदाहरण के लिए, आपका ऐप्लिकेशन ये काम कर सकता है:
- आगे से कोई जवाब न दें. साथ ही, पिछले सभी जवाबों के साथ-साथ मूल टिप्पणी की रोशनी को कम करें.
- बंद की गई टिप्पणियां छिपाएं.
टिप्पणी मिटाना
टिप्पणियां मिटाने के लिए, comments.delete तरीके
का इस्तेमाल करें. जब किसी टिप्पणी को मिटाया जाता है, तो Drive टिप्पणी संसाधन को "deleted": "true" के तौर पर मार्क करता है.
टिप्पणियों की सूची बनाएं
टिप्पणियों की सूची बनाने के लिए, comments.list तरीके का इस्तेमाल करें. अगर आपको मिटाई गई टिप्पणियों को नतीजों में शामिल करना है, तो includedDeleted फ़ील्ड को true पर सेट करें.