सुझावों पर काम करना

Google Docs की मदद से, मिलकर काम करने वाले लोगों को ऐसे सुझाव देने की सुविधा मिलती है जिन्हें मंज़ूरी मिलने के इंतज़ार में बदलाव करने पर रोक लगा दी जाती है.

दस्तावेज़ का कॉन्टेंट फ़ेच करने के लिए documents.get तरीके का इस्तेमाल करने पर, कॉन्टेंट में ऐसे सुझाव हो सकते हैं जिन्हें हल नहीं किया गया हो. documents.get, सुझावों को कैसे दिखाएगा, इसे कंट्रोल करने के लिए वैकल्पिक SuggestionsViewMode पैरामीटर का इस्तेमाल करें. इस पैरामीटर के साथ फ़िल्टर करने की ये शर्तें उपलब्ध हैं:

  • SUGGESTIONS_INLINE वाला कॉन्टेंट पाएं, ताकि दस्तावेज़ में वह टेक्स्ट दिखे जो मिटाया न गया हो या उसे शामिल किया गया हो.
  • सभी सुझावों को स्वीकार करने के बाद, कॉन्टेंट को झलक के तौर पर पाएं.
  • बिना किसी सुझाव के कॉन्टेंट को झलक के तौर पर देखें और उससे जुड़े सभी सुझाव अस्वीकार कर दिए गए हैं.

SuggestionsViewMode उपलब्ध न कराने पर Google Docs API, डिफ़ॉल्ट सेटिंग का इस्तेमाल करता है, जो मौजूदा उपयोगकर्ता के खास अधिकारों के मुताबिक हो.

सुझाव और इंडेक्स

SuggestionsViewMode के अहम होने की एक वजह यह है कि जवाब में इंडेक्स अलग-अलग हो सकते हैं. यह इस बात पर निर्भर करता है कि सुझाव मौजूद हैं या नहीं, जैसा कि नीचे दिखाया गया है.

सुझावों वाला कॉन्टेंट बिना सुझावों वाला कॉन्टेंट 
{
 "startIndex": 1,
 "endIndex": 31,
 "paragraph": {
  "elements": [
   {
    "startIndex": 1,
    "endIndex": 31,
    "textRun": {
     "content": "Text preceding the suggestion\n",
     "textStyle": {
     }
    }
   }
  ],
  "paragraphStyle": {
   "namedStyleType": "NORMAL_TEXT",
   "direction": "LEFT_TO_RIGHT"
  }
 }
},
{
 "startIndex": 31,
 "endIndex": 51,
 "paragraph": {
  "elements": [
   {
    "startIndex": 31,
    "endIndex": 50,
    "textRun": {
     "content": "Suggested insertion",
     "suggestedInsertionIds": [
      "suggest.vcti8ewm4mww"
     ],
     "textStyle": {
     }
    }
   },
   {
    "startIndex": 50,
    "endIndex": 51,
    "textRun": {
     "content": "\n",
     "textStyle": {
     }
    }
   }
  ],
  "paragraphStyle": {
   "namedStyleType": "NORMAL_TEXT",
   "direction": "LEFT_TO_RIGHT"
  }
 }
},
 {
 "startIndex": 51,
 "endIndex": 81,
 "paragraph": {
  "elements": [
   {
    "startIndex": 51,
    "endIndex": 81,
    "textRun": {
     "content": "Text following the suggestion\n",
     "textStyle": {
     }
    }
   }
  ],
  "paragraphStyle": {
   "namedStyleType": "NORMAL_TEXT",
   "direction": "LEFT_TO_RIGHT"
  }
 }
},


{
 "startIndex": 1,
 "endIndex": 31,
 "paragraph": {
  "elements": [
   {
    "startIndex": 1,
    "endIndex": 31,
    "textRun": {
     "content": "Text preceding the suggestion\n",
     "textStyle": {
     }
    }
   }
  ],
  "paragraphStyle": {
   "namedStyleType": "NORMAL_TEXT",
   "direction": "LEFT_TO_RIGHT"
  }
 }
},
{
 "startIndex": 31,
 "endIndex": 32,
 "paragraph": {
  "elements": [
   {
    "startIndex": 31,
    "endIndex": 32,
    "textRun": {
     "content": "\n",
     "textStyle": {
     }
    }
   }
  ],
  "paragraphStyle": {
   "namedStyleType": "NORMAL_TEXT",
   "direction": "LEFT_TO_RIGHT"
  }
 }
},
{
 "startIndex": 32,
 "endIndex": 62,
 "paragraph": {
  "elements": [
   {
    "startIndex": 32,
    "endIndex": 62,
    "textRun": {
     "content": "Text following the suggestion\n",
     "textStyle": {
     }
    }
   }
  ],
  "paragraphStyle": {
   "namedStyleType": "NORMAL_TEXT",
   "direction": "LEFT_TO_RIGHT"
  }
 }
},

ऊपर दिए गए जवाब में, "सुझाव के बाद का टेक्स्ट" लाइन वाले पैराग्राफ़ में, SuggestionsViewMode का इस्तेमाल करने के अंतर को दिखाया गया है. वैल्यू को SUGGESTIONS_INLINE पर सेट करने पर, ParagraphElement का startIndex, 51 से शुरू होता है और endIndex स्टॉप 81 पर शुरू होता है. सुझाव के बिना, startIndex और endIndex की रेंज 32 से 62 के बीच होती है.

सुझावों के बिना कॉन्टेंट पाएं

नीचे दिए गए आंशिक कोड का नमूना दिखाता है कि SuggestionsViewMode पैरामीटर को PREVIEW_WITHOUT_SUGGESTIONS पर सेट करके, सभी सुझावों को अस्वीकार किए जाने (अगर कोई है) के साथ किसी दस्तावेज़ को झलक के तौर पर कैसे देखा जा सकता है.

Java

फ़ाइनल स्ट्रिंग SUGGEST_MODE = "preview_WITHOUT_ वैसे"; दस्तावेज़ का दस्तावेज़ = service.documents().get(DOCUMENT_ID).setTipViewMode(SUGGEST_MODE).execut();

Python

SUGGEST_MODE=" “preview_WITHOUT_ नाम” का नतीजा = service.documents().get(documentId=DOCUMENT_ID, suggestionsViewMode=SUGGEST_MODE).exe इंटरनेट का नतीजा

SuggestionsViewMode पैरामीटर को छोड़ना, DEFAULT_FOR_CURRENT_ACCESS को पैरामीटर वैल्यू के तौर पर देने के बराबर है.

शैली के सुझाव

दस्तावेज़ों में स्टाइल के सुझाव भी हो सकते हैं. कॉन्टेंट में बदलाव के बजाय, फ़ॉर्मैटिंग और प्रज़ेंटेशन में किए जाने वाले बदलावों के सुझाव दिए जाते हैं.

टेक्स्ट डालने या मिटाने के उलट, ये इंडेक्स को ऑफ़सेट नहीं करते हैं. हालांकि, ये TextRun को छोटे-छोटे हिस्सों में तोड़ सकते हैं, लेकिन सिर्फ़ स्टाइल में सुझाए गए बदलाव के बारे में एनोटेशन जोड़ते हैं.

ऐसा ही एक एनोटेशन SuggestedTextStyle है, इसके दो हिस्से होते हैं:

  • textStyle में यह बताया गया है कि सुझाए गए बदलाव के बाद, टेक्स्ट की स्टाइल कैसे बनाई गई. हालांकि, यह नहीं बताया गया है कि क्या बदलाव किया गया है.

  • textStyleSuggestionState, जिससे पता चलता है कि सुझाव, textStyle के फ़ील्ड को कैसे बदलता है.

इसे दस्तावेज़ के नीचे दिए गए एक्सट्रैक्ट में देखा जा सकता है, जिसमें सुझाया गया स्टाइल से जुड़ा बदलाव शामिल है:

[01] "paragraph": {
[02]    "elements": [
[03]        {
[04]            "endIndex": 106,
[05]            "startIndex": 82,
[06]            "textRun": {
[07]                "content": "Some text that does not ",
[08]                "textStyle": {}
[09]            }
[10]        },
[11]        {
[12]            "endIndex": 115,
[13]            "startIndex": 106,
[14]            "textRun": {
[15]                "content": "initially",
[16]                "suggestedTextStyleChanges": {
[17]                    "suggest.xymysbs9zldp": {
[18]                        "textStyle": {
[19]                            "backgroundColor": {},
[20]                            "baselineOffset": "NONE",
[21]                            "bold": true,
[22]                            "fontSize": {
[23]                                "magnitude": 11,
[24]                                "unit": "PT"
[25]                            },
[26]                            "foregroundColor": {
[27]                                "color": {
[28]                                    "rgbColor": {}
[29]                                }
[30]                            },
[31]                            "italic": false,
[32]                            "smallCaps": false,
[33]                            "strikethrough": false,
[34]                            "underline": false
[35]                        },
[36]                        "textStyleSuggestionState": {
[37]                            "boldSuggested": true,
[38]                            "weightedFontFamilySuggested": true
[39]                        }
[40]                    }
[41]                },
[42]                "textStyle": {
[43]                    "italic": true
[44]                }
[45]            }
[46]        },
[47]        {
[48]            "endIndex": 143,
[49]            "startIndex": 115,
[50]            "textRun": {
[51]                "content": " contain any boldface text.\n",
[52]                "textStyle": {}
[53]            }
[54]        }
[55]    ],
[56]    "paragraphStyle": {
[57]        "direction": "LEFT_TO_RIGHT",
[58]        "namedStyleType": "NORMAL_TEXT"
[59]    }
[60] }

ऊपर दिए गए नमूने में, पैराग्राफ़ में तीन टेक्स्ट रन हैं. इसकी शुरुआत लाइन 6, 14, और 50 से होती है. बीच में दिए गए टेक्स्ट की जांच करें:

  • लाइन 16: एक suggestedTextStyleChanges ऑब्जेक्ट है.
  • लाइन 18: textStyle अलग-अलग फ़ॉर्मैट के बारे में बताता है.
  • लाइन 36: textStyleSuggestionState आपको बताता है कि इस स्पेसिफ़िकेशन का सिर्फ़ बोल्ड हिस्सा सुझाव था.
  • लाइन 42: इस टेक्स्ट को चलाने की इटैलिक स्टाइल, मौजूदा दस्तावेज़ का हिस्सा है (और सुझाव से इस पर कोई असर नहीं पड़ा है).

सिर्फ़ textStyleSuggestionState में true पर सेट की गई स्टाइल सुविधाएं ही सुझाव का हिस्सा हैं.