इस पेज पर, Google Docs API का इस्तेमाल करके टेक्स्ट को फ़ॉर्मैट करने का तरीका बताया गया है.
फ़ॉर्मैटिंग के बारे में जानकारी
अपने दस्तावेज़ के टेक्स्ट कॉन्टेंट पर दो तरह की फ़ॉर्मैटिंग लागू की जा सकती है:
- वर्णों की फ़ॉर्मैटिंग में बदलाव किया जा सकता है. जैसे, फ़ॉन्ट, रंग या अंडरलाइन करना.
- पैराग्राफ़ की फ़ॉर्मैटिंग में बदलाव किया जा सकता है. जैसे, इंडेंटेशन या लाइन स्पेसिंग.
वर्णों की फ़ॉर्मैटिंग में बदलाव करना
वर्णों की फ़ॉर्मैटिंग से तय होता है कि आपके दस्तावेज़ में टेक्स्ट के वर्ण कैसे दिखेंगे.
आपने जो भी फ़ॉर्मैटिंग लागू की है वह, पैराग्राफ़ की TextStyle से मिली डिफ़ॉल्ट फ़ॉर्मैटिंग को बदल देती है. इसके उलट, जिन वर्णों की फ़ॉर्मैटिंग आपने सेट नहीं की है वे पैराग्राफ़ की स्टाइल से मिली फ़ॉर्मैटिंग का इस्तेमाल करते रहेंगे.
टेक्स्ट की वर्ण फ़ॉर्मैटिंग बदलने के लिए, batchUpdate के साथ
UpdateTextStyleRequest का इस्तेमाल करें.
आपको Range
ऑब्जेक्ट देना होगा. इसमें यह जानकारी शामिल होनी चाहिए:
- एक
segmentIdजो यह पहचान करता है कि टेक्स्ट किस हेडर, फ़ुटर, फ़ुटनोट में है. अगर यह तय नहीं किया गया है, तो यह पहचान करता है कि टेक्स्ट मुख्य हिस्से में है. startIndexऔरendIndexजो फ़ॉर्मैट किए जाने वाले सेगमेंट में टेक्स्ट की रेंज तय करते हैं.- एक
tabIdजो यह पहचान करता है कि टेक्स्ट किस टैब में है.
यहां दिए गए उदाहरण में, हेडर में मौजूद टेक्स्ट पर कई टेक्स्ट स्टाइलिंग कार्रवाइयां की गई हैं:
- वर्ण 1-5 के फ़ॉन्ट को बोल्ड इटैलिक में सेट करता है.
- वर्ण 6-10 के रंग को
blueऔर फ़ॉन्ट को 14-पॉइंट Times New Roman में सेट करता है. - वर्ण 11-15 को
www.example.comसे हाइपरलिंक करता है.
इसे करने का आसान तरीका यह है कि अनुरोधों की सूची बनाएं. इसके बाद, batchUpdate को एक बार कॉल करें:
Java
Listrequests = new ArrayList<>(); requests.add(new Request().setUpdateTextStyle(new UpdateTextStyleRequest() .setTextStyle(new TextStyle() .setBold(true) .setItalic(true)) .setRange(new Range() .setStartIndex(1) .setEndIndex(5) .setTabId(TAB_ID)) .setFields("bold"))); requests.add(new Request() .setUpdateTextStyle(new UpdateTextStyleRequest() .setRange(new Range() .setStartIndex(6) .setEndIndex(10) .setTabId(TAB_ID)) .setTextStyle(new TextStyle() .setWeightedFontFamily(new WeightedFontFamily() .setFontFamily("Times New Roman")) .setFontSize(new Dimension() .setMagnitude(14.0) .setUnit("PT")) .setForegroundColor(new OptionalColor() .setColor(new Color().setRgbColor(new RgbColor() .setBlue(1.0F) .setGreen(0.0F) .setRed(0.0F))))) .setFields("foregroundColor,weightedFontFamily,fontSize"))); requests.add(new Request() .setUpdateTextStyle(new UpdateTextStyleRequest() .setRange(new Range() .setStartIndex(11) .setEndIndex(15) .setTabId(TAB_ID)) .setTextStyle(new TextStyle() .setLink(new Link() .setUrl("www.example.com"))) .setFields("link"))); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); BatchUpdateDocumentResponse response = docsService.documents() .batchUpdate("DOCUMENT_ID", body).execute();
Python
requests = [ { 'updateTextStyle': { 'range': { 'startIndex': 1, 'endIndex': 5, 'tabId': 'TAB_ID' }, 'textStyle': { 'bold': True, 'italic': True }, 'fields': 'bold,italic' } }, { 'updateTextStyle': { 'range': { 'startIndex': 6, 'endIndex': 10, 'tabId': 'TAB_ID' }, 'textStyle': { 'weightedFontFamily': { 'fontFamily': 'Times New Roman' }, 'fontSize': { 'magnitude': 14, 'unit': 'PT' }, 'foregroundColor': { 'color': { 'rgbColor': { 'blue': 1.0, 'green': 0.0, 'red': 0.0 } } } }, 'fields': 'foregroundColor,weightedFontFamily,fontSize' } }, { 'updateTextStyle': { 'range': { 'startIndex': 11, 'endIndex': 15, 'tabId': 'TAB_ID' }, 'textStyle': { 'link': { 'url': 'www.example.com' } }, 'fields': 'link' } } ] result = service.documents().batchUpdate( documentId='DOCUMENT_ID', body={'requests': requests}).execute()
पैराग्राफ़ की फ़ॉर्मैटिंग में बदलाव करना
Google Docs API की मदद से, पैराग्राफ़ की फ़ॉर्मैटिंग को अपडेट किया जा सकता है. इससे यह तय होता है कि आपके दस्तावेज़ में टेक्स्ट के ब्लॉक कैसे दिखेंगे. इसमें अलाइनमेंट और इंडेंटेशन जैसी सुविधाएं शामिल हैं.
आपने जो भी फ़ॉर्मैटिंग लागू की है वह, पैराग्राफ़ की स्टाइल से मिली डिफ़ॉल्ट फ़ॉर्मैटिंग को बदल देती है. इसके उलट, जिन फ़ॉर्मैटिंग सुविधाओं को आपने सेट नहीं किया है वे पैराग्राफ़ की स्टाइल से मिली फ़ॉर्मैटिंग का इस्तेमाल करती रहेंगी. पैराग्राफ़ की स्टाइल और इनहेरिटेंस के बारे में ज़्यादा जानने के लिए, देखें ParagraphStyle.
यहां दिए गए उदाहरण में, किसी पैराग्राफ़ के लिए यह फ़ॉर्मैटिंग तय की गई है:
- नाम वाली स्टाइल के तौर पर हेडिंग
- ऊपर की ओर पसंद के मुताबिक दूरी
- नीचे की ओर पसंद के मुताबिक दूरी
- बाएं ओर पसंद के मुताबिक बॉर्डर
पैराग्राफ़ की अन्य सभी फ़ॉर्मैटिंग सुविधाएं, नाम वाली स्टाइल से मिली फ़ॉर्मैटिंग का इस्तेमाल करती रहेंगी.
Java
Listrequests = new ArrayList<>(); requests.add(new Request().setUpdateParagraphStyle(new UpdateParagraphStyleRequest() .setRange(new Range() .setStartIndex(1) .setEndIndex(10) .setTabId(TAB_ID)) .setParagraphStyle(new ParagraphStyle() .setNamedStyleType("HEADING_1") .setSpaceAbove(new Dimension() .setMagnitude(10.0) .setUnit("PT")) .setSpaceBelow(new Dimension() .setMagnitude(10.0) .setUnit("PT"))) .setFields("namedStyleType,spaceAbove,spaceBelow") )); requests.add(new Request().setUpdateParagraphStyle(new UpdateParagraphStyleRequest() .setRange(new Range() .setStartIndex(10) .setEndIndex(20) .setTabId(TAB_ID)) .setParagraphStyle(new ParagraphStyle() .setBorderLeft(new ParagraphBorder() .setColor(new OptionalColor() .setColor(new Color() .setRgbColor(new RgbColor() .setBlue(1.0F) .setGreen(0.0F) .setRed(0.0F) ) ) ) .setDashStyle("DASH") .setPadding(new Dimension() .setMagnitude(20.0) .setUnit("PT")) .setWidth(new Dimension() .setMagnitude(15.0) .setUnit("PT") ) ) ) .setFields("borderLeft") )); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); BatchUpdateDocumentResponse response = docsService.documents() .batchUpdate(DOCUMENT_ID, body).execute();
Python
requests = [ { 'updateParagraphStyle': { 'range': { 'startIndex': 1, 'endIndex': 10, 'tabId': TAB_ID }, 'paragraphStyle': { 'namedStyleType': 'HEADING_1', 'spaceAbove': { 'magnitude': 10.0, 'unit': 'PT' }, 'spaceBelow': { 'magnitude': 10.0, 'unit': 'PT' } }, 'fields': 'namedStyleType,spaceAbove,spaceBelow' } }, { 'updateParagraphStyle': { 'range': { 'startIndex': 10, 'endIndex': 20, 'tabId': TAB_ID }, 'paragraphStyle': { 'borderLeft': { 'color': { 'color': { 'rgbColor': { 'blue': 1.0, 'green': 0.0, 'red': 0.0 } } }, 'dashStyle': 'DASH', 'padding': { 'magnitude': 20.0, 'unit': 'PT' }, 'width': { 'magnitude': 15.0, 'unit': 'PT' }, } }, 'fields': 'borderLeft' } } ] result = service.documents().batchUpdate( documentId=DOCUMENT_ID, body={'requests': requests}).execute()