टिप्पणियां और जवाब मैनेज करना

टिप्पणियां, किसी फ़ाइल पर उपयोगकर्ता की ओर से दी गई राय होती हैं. जैसे, वर्ड प्रोसेसिंग दस्तावेज़, जिसमें वाक्य को नए तरीके से लिखने का सुझाव दिया गया है. दो टिप्पणियों के टाइप: ऐंकर की गई टिप्पणियां और ऐंकर की गई टिप्पणियां. ऐंकर किया गया टिप्पणी किसी ख़ास जगह से जुड़ी हो, जैसे कि किसी दस्तावेज़ के खास वर्शन में वर्ड-प्रोसेसिंग दस्तावेज़. इसके उलट, बिना ऐंकर वाली टिप्पणी, सिर्फ़ दस्तावेज़ से जुड़ी होती है.

जवाब, टिप्पणियों के साथ अटैच होते हैं और टिप्पणी करें. Drive API से आपके उपयोगकर्ता, उन पर टिप्पणियां और जवाब जोड़ सकते हैं आपके ऐप्लिकेशन से बनाए गए दस्तावेज़. सामूहिक रूप से, जवाबों वाली टिप्पणी को चर्चा.

बिना ऐंकर वाली टिप्पणी जोड़ें

किसी दस्तावेज़ में ऐंकर वाली टिप्पणी जोड़ने के लिए, comments.create तरीके को fileId पैरामीटर और comments संसाधन जिसमें टिप्पणी शामिल है.

टिप्पणी को सामान्य टेक्स्ट के तौर पर डाला गया है, लेकिन जवाब के मुख्य हिस्से में htmlContent फ़ील्ड में डिसप्ले के लिए फ़ॉर्मैट किया गया कॉन्टेंट है.

किसी टिप्पणी का जवाब जोड़ना

किसी टिप्पणी का जवाब देने के लिए, replies.create तरीका, किसी टिप्पणी के साथ जोड़ा गया, fileId पैरामीटर और एक replies संसाधन जिसमें जवाब शामिल है.

जवाब को सादे टेक्स्ट के तौर पर डाला गया है, लेकिन जवाब के मुख्य हिस्से में htmlContent फ़ील्ड में डिसप्ले के लिए फ़ॉर्मैट किया गया कॉन्टेंट है.

किसी दस्तावेज़ के सबसे नए संशोधन पर ऐंकर की गई टिप्पणी जोड़ें

जब कोई टिप्पणी जोड़ी जाती है, तो हो सकता है कि आप उसे फ़ाइल में किसी जगह पर ऐंकर करना चाहें. अगर आप anchor किसी फ़ाइल में फ़ाइल संशोधन और क्षेत्र के बारे में बताता है जिसमें कोई टिप्पणी शामिल होती है. संदर्भ देता है. comments संसाधन JSON स्ट्रिंग के तौर पर anchor फ़ील्ड.

ऐंकर की गई टिप्पणी जोड़ने के लिए:

  1. (ज़रूरी नहीं). revisions.list पर कॉल करें विधि का इस्तेमाल करके सभी revisionID को सूचीबद्ध करें. इस चरण का पालन सिर्फ़ तब करें, जब आप नवीनतम संशोधन को छोड़कर किसी अन्य संशोधन पर टिप्पणी ऐंकर करना चाहते हैं. अगर आपको सबसे नए वर्शन का इस्तेमाल करना है, तो revisionID के लिए head का इस्तेमाल करें.

  2. comments.create तरीके को कॉल करें fileID पैरामीटर के साथ, comments रिसॉर्स जिसमें टिप्पणी शामिल है और JSON ऐंकर स्ट्रिंग जिसमें revisionID (r) और इलाका (a).

क्षेत्र तय करने का तरीका, इस बात पर निर्भर करता है कि आपके दस्तावेज़ का किस तरह का कॉन्टेंट बनाया जा रहा है के साथ. ज़्यादा जानकारी के लिए, क्षेत्र तय करना देखें.

क्षेत्र तय करें

जैसा कि पहले बताया गया है, JSON ऐंकर स्ट्रिंग में एक revisionID (r) और क्षेत्र (a). क्षेत्र (a) एक JSON कलेक्शन है, जिसमें क्षेत्र के हिसाब से डेटा की कैटगरी तय करने वाले टूल शामिल हैं वह फ़ॉर्मैट और जगह तय करता है जहां टिप्पणी ऐंकर की गई है. क्लासिफ़ायर यह किसी इमेज के लिए दो डाइमेंशन वाला रेक्टैंगल हो सकता है. यह दस्तावेज़ में टेक्स्ट की कोई लाइन हो सकती है. या वीडियो की कुल अवधि. किसी क्षेत्र के बारे में बताने के लिए, क्षेत्र चुनें क्लासिफ़ायर का इस्तेमाल करता है जो उस कॉन्टेंट से मेल खाता है जिस पर आप ऐंकर करने की कोशिश कर रहे हैं. इसके लिए उदाहरण के लिए, अगर आपकी सामग्री टेक्स्ट है, तो आप txt का इस्तेमाल कर सकते हैं या line क्षेत्र की कैटगरी तय करने वाला टूल.

Drive API में, क्षेत्र के हिसाब से डेटा की कैटगरी तय करने वाली सूची के लिए, क्षेत्र देखें क्लासिफ़ायर का इस्तेमाल करता है.

इस उदाहरण में, JSON में ऐंकर स्ट्रिंग दिखाई गई है. इसकी मदद से, लाइनों पर टिप्पणियों को ऐंकर किया जा सकता है दस्तावेज़ के दो अलग-अलग हिस्सों में:

  • पहला एरिया लाइन 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 तरीके का इस्तेमाल करें टिप्पणियां. अगर आपको नतीजों में मिटाई गई टिप्पणियों को शामिल करना है, तो true के लिए includedDeleted फ़ील्ड.