स्प्रेडशीट की रेंज ऐक्सेस करें और उनमें बदलाव करें. रेंज, किसी शीट का एक सेल या शीट में मौजूद आस-पास के सेल का ग्रुप हो सकती है.
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
activate() | Range | तय की गई रेंज को active range के तौर पर सेट करता है. साथ ही, रेंज में सबसे ऊपर बाईं ओर मौजूद सेल को current cell के तौर पर सेट करता है. |
activateAsCurrentCell() | Range | बताए गए सेल को current cell के तौर पर सेट करता है. |
addDeveloperMetadata(key) | Range | तय की गई कुंजी के साथ डेवलपर मेटाडेटा को रेंज में जोड़ता है. |
addDeveloperMetadata(key, visibility) | Range | तय की गई कुंजी और 'किसको दिखे' की रेंज के साथ, डेवलपर मेटाडेटा जोड़ता है. |
addDeveloperMetadata(key, value) | Range | तय की गई कुंजी और वैल्यू के साथ, डेवलपर मेटाडेटा को रेंज में जोड़ता है. |
addDeveloperMetadata(key, value, visibility) | Range | खास कुंजी, वैल्यू, और रेंज में किसे दिखाने के बारे में जानकारी के साथ डेवलपर मेटाडेटा जोड़ता है. |
applyColumnBanding() | Banding | रेंज पर डिफ़ॉल्ट कॉलम बैंडिंग थीम लागू करता है. |
applyColumnBanding(bandingTheme) | Banding | रेंज पर किसी खास कॉलम बैंडिंग थीम को लागू करता है. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | तय हेडर और फ़ुटर सेटिंग वाली रेंज में किसी खास कॉलम बैंडिंग थीम लागू करता है. |
applyRowBanding() | Banding | रेंज पर डिफ़ॉल्ट पंक्ति बैंडिंग थीम लागू करता है. |
applyRowBanding(bandingTheme) | Banding | रेंज पर किसी खास रो बैंडिंग थीम को लागू करता है. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | तय हेडर और फ़ुटर सेटिंग के साथ रेंज पर किसी तय पंक्ति बैंडिंग थीम लागू करता है. |
autoFill(destination, series) | void | destinationRange में इस रेंज के डेटा के आधार पर डेटा भरता है. |
autoFillToNeighbor(series) | void | आस-पास के सेल के आधार पर नया डेटा भरने के लिए किसी रेंज की गणना करता है और इस रेंज में मौजूद डेटा के आधार पर उस रेंज में अपने-आप नई वैल्यू भरता है. |
breakApart() | Range | रेंज में मौजूद एक से ज़्यादा कॉलम वाली सेल को फिर से अलग-अलग सेल में बांटें. |
canEdit() | Boolean | यह तय करता है कि उपयोगकर्ता के पास रेंज के हर सेल में बदलाव करने की अनुमति है या नहीं. |
check() | Range | रेंज में चेकबॉक्स की स्थिति को “चुनी गई” में बदलता है. |
clear() | Range | कॉन्टेंट और फ़ॉर्मैट की रेंज हटाता है. |
clear(options) | Range | दिए गए बेहतर विकल्पों में बताए गए कॉन्टेंट की रेंज, फ़ॉर्मैट, डेटा की पुष्टि करने के नियम, और/या टिप्पणियों को मिटाता है. |
clearContent() | Range | फ़ॉर्मैटिंग को बनाए रखते हुए, रेंज के कॉन्टेंट को हटा देता है. |
clearDataValidations() | Range | रेंज के लिए, डेटा की पुष्टि करने के नियमों को हटा देता है. |
clearFormat() | Range | इस श्रेणी की फ़ॉर्मैटिंग को साफ़ करता है. |
clearNote() | Range | दिए गए सेल या सेल में नोट को हटाता है. |
collapseGroups() | Range | रेंज में पूरी तरह से शामिल सभी ग्रुप को छोटा करता है. |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | रेंज की फ़ॉर्मैटिंग को दी गई जगह पर कॉपी करें. |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | रेंज की फ़ॉर्मैटिंग को दी गई जगह पर कॉपी करें. |
copyTo(destination) | void | डेटा को सेल की रेंज से सेल की किसी दूसरी रेंज में कॉपी करता है. |
copyTo(destination, copyPasteType, transposed) | void | डेटा को सेल की रेंज से सेल की किसी दूसरी रेंज में कॉपी करता है. |
copyTo(destination, options) | void | डेटा को सेल की रेंज से सेल की किसी दूसरी रेंज में कॉपी करता है. |
copyValuesToRange(gridId, column, columnEnd, row, rowEnd) | void | रेंज का कॉन्टेंट, दी गई जगह पर कॉपी करें. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | रेंज का कॉन्टेंट, दी गई जगह पर कॉपी करें. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | डेटा सोर्स से एक खाली डेटा सोर्स पिवट टेबल बनाता है, जिसे इस रेंज की पहली सेल पर ऐंकर किया जाता है. |
createDataSourceTable(dataSource) | DataSourceTable | डेटा सोर्स से एक खाली डेटा सोर्स टेबल बनाता है, जिसे इस रेंज की पहली सेल पर ऐंकर किया जाता है. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | इस रेंज के दायरे में डेवलपर मेटाडेटा को खोजने के लिए, DeveloperMetadataFinderApi दिखता है. |
createFilter() | Filter | फ़िल्टर बनाता है और उसे शीट में बताई गई रेंज पर लागू करता है. |
createPivotTable(sourceData) | PivotTable | इस रेंज की पहली सेल में ऐंकर किए गए sourceData से, एक खाली पिवट टेबल बनाता है. |
createTextFinder(findText) | TextFinder | इस रेंज के लिए टेक्स्ट फ़ाइंडर बनाता है, जो इस रेंज में मौजूद टेक्स्ट को खोजकर उसे बदल सकता है. |
deleteCells(shiftDimension) | void | सेल की इस रेंज को मिटाता है. |
expandGroups() | Range | छोटे किए गए उन ग्रुप को बड़ा करता है जिनकी रेंज या कंट्रोल टॉगल, इस रेंज को इंटरसेक्ट करता है. |
getA1Notation() | String | A1 नोटेशन में रेंज की स्ट्रिंग की जानकारी देता है. |
getBackground() | String | रेंज में सबसे ऊपर बाईं ओर मौजूद सेल के बैकग्राउंड का रंग दिखाता है (जैसे, '#ffffff' ). |
getBackgroundObject() | Color | रेंज में सबसे ऊपर बाईं ओर मौजूद सेल के बैकग्राउंड का रंग दिखाता है. |
getBackgroundObjects() | Color[][] | रेंज में सेल के बैकग्राउंड के रंग दिखाता है. |
getBackgrounds() | String[][] | रेंज में सेल के बैकग्राउंड के रंग दिखाता है (जैसे, '#ffffff' ). |
getBandings() | Banding[] | इस श्रेणी में किसी भी सेल पर लागू किए गए सभी बैंडिंग देता है. |
getCell(row, column) | Range | किसी रेंज में कोई सेल दिखाता है. |
getColumn() | Integer | इस रेंज के लिए शुरुआती कॉलम की जगह दिखाता है. |
getDataRegion() | Range | चार कार्डनल Direction में बढ़ाई गई रेंज की कॉपी लौटाता है, ताकि
आस-पास मौजूद सभी सेल में डेटा वाले सेल को कवर किया जाए. |
getDataRegion(dimension) | Range | अगर तय किया गया डाइमेंशन Dimension.ROWS है, तो बड़ी की गई रेंज Direction.UP और Direction.DOWN की कॉपी दिखाता है. अगर डाइमेंशन Dimension.COLUMNS है, तो Direction.NEXT और Direction.PREVIOUS की कॉपी दिखाता है. |
getDataSourceFormula() | DataSourceFormula | रेंज में पहली सेल के लिए DataSourceFormula दिखाता है. अगर सेल में डेटा सोर्स का फ़ॉर्मूला नहीं है, तो null दिखाता है. |
getDataSourceFormulas() | DataSourceFormula[] | रेंज में मौजूद सेल के लिए DataSourceFormula दिखाता है. |
getDataSourcePivotTables() | DataSourcePivotTable[] | रेंज को इंटरसेक्ट करने वाली सभी डेटा सोर्स की पिवट टेबल दिखाता है. |
getDataSourceTables() | DataSourceTable[] | रेंज को इंटरसेक्ट करने वाली सभी डेटा सोर्स टेबल दिखाता है. |
getDataSourceUrl() | String | इस रेंज के डेटा के लिए यूआरएल दिखाता है, जिसका इस्तेमाल चार्ट और क्वेरी बनाने के लिए किया जा सकता है. |
getDataTable() | DataTable | इस ऑब्जेक्ट के अंदर का डेटा, DataTable के तौर पर दिखाएं. |
getDataTable(firstRowIsHeader) | DataTable | इस रेंज के अंदर के डेटा को Data Tables के तौर पर दिखाएं. |
getDataValidation() | DataValidation | रेंज में सबसे ऊपर बाईं ओर मौजूद सेल के लिए, डेटा की पुष्टि करने का नियम दिखाता है. |
getDataValidations() | DataValidation[][] | इस रेंज में मौजूद सभी सेल के लिए, डेटा की पुष्टि करने के नियम दिखाता है. |
getDeveloperMetadata() | DeveloperMetadata[] | इस रेंज से जुड़े डेवलपर मेटाडेटा की जानकारी मिलती है. |
getDisplayValue() | String | रेंज में सबसे ऊपर बाईं ओर मौजूद सेल की दिखाई गई वैल्यू दिखाता है. |
getDisplayValues() | String[][] | इस रेंज के लिए वैल्यू की रेक्टैंगल ग्रिड दिखाता है. |
getFilter() | Filter | उस शीट पर फ़िल्टर लौटाता है जिससे यह श्रेणी संबंधित है या अगर शीट में कोई फ़िल्टर नहीं है, तो null दिखाता है. |
getFontColorObject() | Color | रेंज के सबसे ऊपर बाएं कोने में, सेल के फ़ॉन्ट का रंग दिखाता है. |
getFontColorObjects() | Color[][] | रेंज में मौजूद सेल के फ़ॉन्ट के रंग दिखाता है. |
getFontFamilies() | String[][] | रेंज में मौजूद सेल की फ़ॉन्ट फ़ैमिली दिखाता है. |
getFontFamily() | String | रेंज के सबसे ऊपर बाएं कोने में, सेल की फ़ॉन्ट फ़ैमिली दिखाता है. |
getFontLine() | String | रेंज के सबसे ऊपर बाएं कोने में, सेल का लाइन स्टाइल दिखाता है ('underline' , 'line-through' या 'none' ). |
getFontLines() | String[][] | रेंज ('underline' , 'line-through' या
'none' ) में मौजूद सेल की लाइन स्टाइल लेता है. |
getFontSize() | Integer | रेंज के सबसे ऊपर बाएं कोने में, सेल के पॉइंट साइज़ में फ़ॉन्ट का साइज़ दिखाता है. |
getFontSizes() | Integer[][] | रेंज में मौजूद सेल के फ़ॉन्ट साइज़ दिखाता है. |
getFontStyle() | String | रेंज के सबसे ऊपर बाएं कोने में सेल की फ़ॉन्ट स्टाइल ('italic' या 'normal' ) दिखाता है. |
getFontStyles() | String[][] | रेंज में मौजूद सेल की फ़ॉन्ट स्टाइल दिखाता है. |
getFontWeight() | String | रेंज के सबसे ऊपर बाएं कोने में, सेल की फ़ॉन्ट की मोटाई (सामान्य/बोल्ड) दिखाता है. |
getFontWeights() | String[][] | रेंज में मौजूद सेल के फ़ॉन्ट की मोटाई दिखाता है. |
getFormula() | String | रेंज में सबसे ऊपर बाईं ओर मौजूद सेल के लिए फ़ॉर्मूला (A1 नोटेशन) दिखाता है. अगर सेल खाली है या उसमें कोई फ़ॉर्मूला नहीं है, तो खाली स्ट्रिंग दिखाता है. |
getFormulaR1C1() | String | किसी सेल के लिए फ़ॉर्मूला (R1C1 नोटेशन) दिखाता है और अगर कोई नहीं है, तो null दिखाता है. |
getFormulas() | String[][] | रेंज में मौजूद सेल के लिए फ़ॉर्मूला (A1 नोटेशन) दिखाता है. |
getFormulasR1C1() | String[][] | रेंज में मौजूद सेल के लिए फ़ॉर्मूला (R1C1 नोटेशन) दिखाता है. |
getGridId() | Integer | रेंज की पैरंट शीट का ग्रिड आईडी दिखाता है. |
getHeight() | Integer | रेंज की ऊंचाई दिखाता है. |
getHorizontalAlignment() | String | रेंज के ऊपर बाएं कोने में सेल के टेक्स्ट (बाएं/सेंटर/दाएं) का हॉरिज़ॉन्टल अलाइनमेंट देता है. |
getHorizontalAlignments() | String[][] | रेंज में सेल के हॉरिज़ॉन्टल अलाइनमेंट दिखाता है. |
getLastColumn() | Integer | कॉलम की आखिरी जगह दिखाता है. |
getLastRow() | Integer | आखिरी पंक्ति की जगह दिखाता है. |
getMergedRanges() | Range[] | मर्ज किए गए उन सेल को दिखाने वाले Range ऑब्जेक्ट का अरे दिखाता है जो या तो मौजूदा रेंज में पूरी तरह से हैं या जिनमें मौजूदा रेंज में कम से कम एक सेल है. |
getNextDataCell(direction) | Range | रेंज के पहले कॉलम और पंक्ति के सेल से शुरू करने पर, दी गई दिशा में अगला सेल वापस भेजता है. यह दी गई दिशा में, सेल की उस रेंज का कोना होता है जिसमें डेटा मौजूद होता है या फिर स्प्रेडशीट के किनारे वाले सेल का किनारा. |
getNote() | String | दी गई रेंज से जुड़ा नोट दिखाता है. |
getNotes() | String[][] | रेंज में मौजूद सेल से जुड़े नोट दिखाता है. |
getNumColumns() | Integer | इस रेंज में कॉलम की संख्या दिखाता है. |
getNumRows() | Integer | इस रेंज में पंक्तियों की संख्या दिखाता है. |
getNumberFormat() | String | दी गई रेंज में सबसे ऊपर बाईं ओर मौजूद सेल की संख्या या तारीख का फ़ॉर्मैट पाएं. |
getNumberFormats() | String[][] | रेंज में मौजूद सेल के लिए संख्या या तारीख के फ़ॉर्मैट दिखाता है. |
getRichTextValue() | RichTextValue | रेंज के सबसे ऊपर बाईं ओर मौजूद सेल के लिए रिच टेक्स्ट दिखाता है. अगर सेल की वैल्यू टेक्स्ट नहीं है, तो null दिखाता है. |
getRichTextValues() | RichTextValue[][] | रेंज में मौजूद सेल के लिए रिच टेक्स्ट की वैल्यू दिखाता है. |
getRow() | Integer | इस रेंज के लिए पंक्ति की जगह दिखाता है. |
getRowIndex() | Integer | इस रेंज के लिए पंक्ति की जगह दिखाता है. |
getSheet() | Sheet | वह शीट दिखाता है जिससे यह रेंज जुड़ी होती है. |
getTextDirection() | TextDirection | रेंज के सबसे ऊपर बाएं सेल के लिए, टेक्स्ट की दिशा दिखाता है. |
getTextDirections() | TextDirection[][] | रेंज में मौजूद सेल के लिए टेक्स्ट के निर्देश दिखाता है. |
getTextRotation() | TextRotation | रेंज के सबसे ऊपर बाईं ओर मौजूद सेल के लिए, टेक्स्ट घुमाने की सेटिंग दिखाता है. |
getTextRotations() | TextRotation[][] | इस रेंज में मौजूद सेल के लिए टेक्स्ट रोटेशन सेटिंग दिखाता है. |
getTextStyle() | TextStyle | रेंज के सबसे ऊपर बाएं सेल के लिए, टेक्स्ट की स्टाइल दिखाता है. |
getTextStyles() | TextStyle[][] | रेंज में मौजूद सेल की टेक्स्ट स्टाइल दिखाता है. |
getValue() | Object | रेंज में सबसे ऊपर बाईं ओर मौजूद सेल की वैल्यू दिखाता है. |
getValues() | Object[][] | इस रेंज के लिए वैल्यू की रेक्टैंगल ग्रिड दिखाता है. |
getVerticalAlignment() | String | रेंज के सबसे ऊपर बाएं कोने में सेल का वर्टिकल अलाइनमेंट (ऊपर/बीच/नीचे) दिखाता है. |
getVerticalAlignments() | String[][] | रेंज में सेल के वर्टिकल अलाइनमेंट दिखाता है. |
getWidth() | Integer | कॉलम में रेंज की चौड़ाई दिखाता है. |
getWrap() | Boolean | यह फ़ंक्शन दिखाता है कि सेल का टेक्स्ट रैप होता है या नहीं. |
getWrapStrategies() | WrapStrategy[][] | रेंज में मौजूद सेल के लिए, टेक्स्ट रैपिंग की रणनीतियां दिखाता है. |
getWrapStrategy() | WrapStrategy | रेंज के सबसे ऊपर बाएं सेल के लिए, टेक्स्ट रैपिंग की रणनीति दिखाता है. |
getWraps() | Boolean[][] | यह फ़ंक्शन दिखाता है कि सेल का टेक्स्ट रैप किया गया है या नहीं. |
insertCells(shiftDimension) | Range | इस रेंज में खाली सेल शामिल करता है. |
insertCheckboxes() | Range | रेंज की हर सेल में चेकबॉक्स डालता है. चेकबॉक्स पर सही का निशान लगाने के लिए true के साथ और सही का निशान हटाने के लिए false को कॉन्फ़िगर किया जाता है. |
insertCheckboxes(checkedValue) | Range | चुनी गई कस्टम वैल्यू के साथ कॉन्फ़िगर किए गए रेंज की हर सेल में चेकबॉक्स डालता है और सही का निशान हटाने के लिए खाली स्ट्रिंग देता है. |
insertCheckboxes(checkedValue, uncheckedValue) | Range | चुनी गई और नहीं चुनी गई स्थितियों के लिए कस्टम मानों के साथ कॉन्फ़िगर किए गए, श्रेणी की हर सेल में चेकबॉक्स डालता है. |
isBlank() | Boolean | रेंज पूरी तरह खाली होने पर true दिखाता है. |
isChecked() | Boolean | यह दिखाता है कि रेंज में मौजूद सभी सेल की चेकबॉक्स स्थिति 'चुनी गई' के तौर पर है या नहीं. |
isEndColumnBounded() | Boolean | यह तय करता है कि रेंज का अंत किसी खास कॉलम से जुड़ा है या नहीं. |
isEndRowBounded() | Boolean | यह तय करता है कि रेंज का अंत किसी खास पंक्ति से जुड़ा है या नहीं. |
isPartOfMerge() | Boolean | अगर मौजूदा रेंज में मौजूद सेल, मर्ज की गई किसी सेल को ओवरलैप करते हैं, तो यह नतीजा true दिखाता है. |
isStartColumnBounded() | Boolean | यह तय करता है कि रेंज की शुरुआत किसी खास कॉलम से जुड़ी है या नहीं. |
isStartRowBounded() | Boolean | यह तय करता है कि रेंज की शुरुआत किसी खास पंक्ति से जुड़ी है या नहीं. |
merge() | Range | रेंज में मौजूद सेल को एक साथ एक ब्लॉक में मर्ज करता है. |
mergeAcross() | Range | रेंज के सभी कॉलम की रेंज में मौजूद सेल मर्ज करें. |
mergeVertically() | Range | रेंज में मौजूद सेल को मर्ज करता है. |
moveTo(target) | void | इस रेंज से टारगेट रेंज में काटें और चिपकाएं (फ़ॉर्मैट और वैल्यू दोनों). |
offset(rowOffset, columnOffset) | Range | ऐसी नई रेंज लौटाता है जो इस रेंज से पंक्तियों और कॉलम की दी गई संख्या से ऑफ़सेट होती है (जो नेगेटिव हो सकती है). |
offset(rowOffset, columnOffset, numRows) | Range | मौजूदा रेंज से मिलती-जुलती नई रेंज दिखाता है. इस रेंज का ऊपरी बायां बिंदु, दी गई पंक्तियों और कॉलम के हिसाब से मौजूदा रेंज से ऑफ़सेट होता है. साथ ही, सेल में दी गई ऊंचाई भी दिखाता है. |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | मौजूदा रेंज से मिलती-जुलती नई रेंज दिखाता है. इस रेंज का ऊपरी बायां बिंदु, दी गई पंक्तियों और कॉलम के हिसाब से मौजूदा रेंज से ऑफ़सेट होता है. साथ ही, सेल में दी गई ऊंचाई और चौड़ाई से ऑफ़सेट होता है. |
protect() | Protection | एक ऐसा ऑब्जेक्ट बनाता है जो रेंज में बदलाव किए जाने से बचा सकता है. हालांकि, इसमें अनुमति वाले उपयोगकर्ताओं को शामिल नहीं किया जाता. |
randomize() | Range | दी गई रेंज में पंक्तियों का ऑर्डर किसी भी क्रम में लगाता है. |
removeCheckboxes() | Range | श्रेणी से सभी चेकबॉक्स निकालता है. |
removeDuplicates() | Range | इस रेंज में मौजूद उन पंक्तियों को हटाता है जिनमें पिछली किसी भी पंक्ति की वैल्यू की डुप्लीकेट वैल्यू मौजूद हैं. |
removeDuplicates(columnsToCompare) | Range | इस रेंज में से वे पंक्तियां हटाता है जिनके तय कॉलम में, पिछली किसी भी पंक्ति की वैल्यू की डुप्लीकेट वैल्यू मौजूद हैं. |
setBackground(color) | Range | सीएसएस नोटेशन (जैसे '#ffffff'
या 'white' ) की रेंज में सभी सेल के बैकग्राउंड का रंग सेट करता है. |
setBackgroundObject(color) | Range | रेंज में सभी सेल के लिए बैकग्राउंड का रंग सेट करता है. |
setBackgroundObjects(color) | Range | बैकग्राउंड के रंगों का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setBackgroundRGB(red, green, blue) | Range | आरजीबी वैल्यू (0 और 255 के बीच के पूर्णांक) का इस्तेमाल करके, दिए गए रंग के लिए बैकग्राउंड सेट करता है. |
setBackgrounds(color) | Range | बैकग्राउंड के रंगों का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setBorder(top, left, bottom, right, vertical, horizontal) | Range | बॉर्डर प्रॉपर्टी सेट करता है. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | Range | बॉर्डर प्रॉपर्टी को रंग और/या स्टाइल के साथ सेट करता है. |
setDataValidation(rule) | Range | रेंज में मौजूद सभी सेल के लिए, डेटा की पुष्टि करने का एक नियम सेट करता है. |
setDataValidations(rules) | Range | रेंज में मौजूद सभी सेल के लिए, डेटा की पुष्टि करने के नियम सेट करता है. |
setFontColor(color) | Range | सीएसएस नोटेशन (जैसे '#ffffff' या 'white' ) में फ़ॉन्ट का रंग सेट करता है. |
setFontColorObject(color) | Range | दी गई रेंज के लिए फ़ॉन्ट का कलर सेट करता है. |
setFontColorObjects(colors) | Range | फ़ॉन्ट के रंगों का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setFontColors(colors) | Range | फ़ॉन्ट के रंगों का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setFontFamilies(fontFamilies) | Range | फ़ॉन्ट फ़ैमिली की आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setFontFamily(fontFamily) | Range | फ़ॉन्ट फ़ैमिली सेट करता है, जैसे कि "">ऐरियल" या ""हेल्थ". |
setFontLine(fontLine) | Range | दी गई रेंज ('underline' , 'line-through' , या
'none' ) की फ़ॉन्ट लाइन का स्टाइल सेट करता है. |
setFontLines(fontLines) | Range | लाइन स्टाइल का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setFontSize(size) | Range | फ़ॉन्ट का साइज़ सेट करता है. इसमें इस्तेमाल के लिए पॉइंट साइज़ शामिल होता है. |
setFontSizes(sizes) | Range | फ़ॉन्ट साइज़ का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setFontStyle(fontStyle) | Range | दी गई रेंज ('italic' या 'normal' ) के लिए फ़ॉन्ट स्टाइल सेट करें. |
setFontStyles(fontStyles) | Range | फ़ॉन्ट स्टाइल का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setFontWeight(fontWeight) | Range | दी गई रेंज के लिए फ़ॉन्ट की मोटाई सेट करें (नॉर्मल/बोल्ड). |
setFontWeights(fontWeights) | Range | फ़ॉन्ट की मोटाई का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setFormula(formula) | Range | इस रेंज के लिए फ़ॉर्मूला अपडेट करता है. |
setFormulaR1C1(formula) | Range | इस रेंज के लिए फ़ॉर्मूला अपडेट करता है. |
setFormulas(formulas) | Range | फ़ॉर्मूला की आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setFormulasR1C1(formulas) | Range | फ़ॉर्मूला की आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setHorizontalAlignment(alignment) | Range | दी गई रेंज के लिए, हॉरिज़ॉन्टल (बाएं से दाएं) अलाइनमेंट सेट करें (बाएं/सेंटर/दाएं). |
setHorizontalAlignments(alignments) | Range | हॉरिज़ॉन्टल अलाइनमेंट का रेक्टैंगल ग्रिड सेट करता है. |
setNote(note) | Range | नोट को दिए गए मान पर सेट करता है. |
setNotes(notes) | Range | नोट का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setNumberFormat(numberFormat) | Range | दी गई फ़ॉर्मैटिंग स्ट्रिंग पर संख्या या तारीख के फ़ॉर्मैट को सेट करता है. |
setNumberFormats(numberFormats) | Range | संख्या या तारीख फ़ॉर्मैट का आयताकार ग्रिड सेट करता है (इस सीमा के डाइमेंशन से मेल खाना चाहिए). |
setRichTextValue(value) | Range | रेंज में मौजूद सेल के लिए रिच टेक्स्ट की वैल्यू सेट करता है. |
setRichTextValues(values) | Range | रिच टेक्स्ट वैल्यू का रेक्टैंगल ग्रिड सेट करता है. |
setShowHyperlink(showHyperlink) | Range | सेट करता है कि रेंज को हाइपरलिंक दिखाना चाहिए या नहीं. |
setTextDirection(direction) | Range | रेंज में सेल के लिए टेक्स्ट की दिशा सेट करता है. |
setTextDirections(directions) | Range | टेक्स्ट के लिए निर्देशों का एक आयताकार ग्रिड सेट करता है. |
setTextRotation(degrees) | Range | रेंज में मौजूद सेल के लिए टेक्स्ट रोटेशन सेटिंग सेट करता है. |
setTextRotation(rotation) | Range | रेंज में मौजूद सेल के लिए टेक्स्ट रोटेशन सेटिंग सेट करता है. |
setTextRotations(rotations) | Range | टेक्स्ट के घुमाव का आयताकार ग्रिड सेट करता है. |
setTextStyle(style) | Range | रेंज में मौजूद सेल के लिए टेक्स्ट की स्टाइल सेट करता है. |
setTextStyles(styles) | Range | टेक्स्ट स्टाइल का आयताकार ग्रिड सेट करता है. |
setValue(value) | Range | रेंज की वैल्यू सेट करता है. |
setValues(values) | Range | वैल्यू की आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setVerticalAlignment(alignment) | Range | दी गई रेंज (ऊपर/मध्य/नीचे) के लिए वर्टिकल (ऊपर से नीचे) अलाइनमेंट सेट करें. |
setVerticalAlignments(alignments) | Range | वर्टिकल अलाइनमेंट का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
setVerticalText(isVertical) | Range | सेट करता है कि रेंज में सेल के टेक्स्ट को स्टैक करना है या नहीं. |
setWrap(isWrapEnabled) | Range | दी गई रेंज का सेल रैप सेट करें. |
setWrapStrategies(strategies) | Range | रैप रणनीतियों का आयताकार ग्रिड सेट करता है. |
setWrapStrategy(strategy) | Range | रेंज में मौजूद सेल के लिए, टेक्स्ट रैपिंग की रणनीति सेट करता है. |
setWraps(isWrapEnabled) | Range | वर्ड रैप नीतियों का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). |
shiftColumnGroupDepth(delta) | Range | तय की गई रकम से श्रेणी के कॉलम के ग्रुप की गहराई बदलता है. |
shiftRowGroupDepth(delta) | Range | तय की गई रकम से रेंज की पंक्ति की ग्रुप गहराई को बदलता है. |
sort(sortSpecObj) | Range | दी गई रेंज में, बताए गए कॉलम और क्रम के मुताबिक सेल को क्रम से लगाता है. |
splitTextToColumns() | void | अपने-आप पता लगाए गए डीलिमिटर के आधार पर, टेक्स्ट के कॉलम को एक से ज़्यादा कॉलम में बांट देता है. |
splitTextToColumns(delimiter) | void | कस्टम डीलिमिटर के तौर पर बताई गई स्ट्रिंग का इस्तेमाल करके, टेक्स्ट के कॉलम को एक से ज़्यादा कॉलम में बांट देता है. |
splitTextToColumns(delimiter) | void | तय किए गए डीलिमिटर के आधार पर, टेक्स्ट के कॉलम को एक से ज़्यादा कॉलम में बांट देता है. |
trimWhitespace() | Range | इस रेंज की हर सेल में खाली सफ़ेद जगह (जैसे कि खाली जगह, टैब या नई लाइन) में काट-छांट करता है. |
uncheck() | Range | रेंज में चेकबॉक्स की स्थिति को “सही का निशान हटाया गया” में बदलता है. |
ज़्यादा जानकारी के साथ दस्तावेज़
activate()
तय की गई रेंज को active range
के तौर पर सेट करता है. साथ ही, रेंज में सबसे ऊपर बाईं ओर मौजूद सेल को current cell
के तौर पर सेट करता है.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:D10'); range.activate(); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D10 var activeRange = selection.getActiveRange();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
activateAsCurrentCell()
बताए गए सेल को current cell
के तौर पर सेट करता है.
अगर कोई सेल किसी मौजूदा रेंज में मौजूद है, तो वह रेंज, मौजूदा सेल के तौर पर सेल वाली ऐक्टिव रेंज बन जाती है.
अगर तय की गई सेल किसी मौजूदा रेंज में मौजूद नहीं है, तो चुने गए मौजूदा सेल को हटा दिया जाता है और सेल, मौजूदा सेल और सक्रिय रेंज बन जाती है.
ध्यान दें: दिए गए Range
में सिर्फ़ एक सेल होनी चाहिए. ऐसा न होने पर, अपवाद के तौर पर एक सेल ही दिखेगी.
// Gets the first sheet of the spreadsheet. var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Gets the cell B5 and sets it as the active cell. var range = sheet.getRange('B5'); var currentCell = range.activateAsCurrentCell(); // Logs the activated cell. console.log(currentCell.getA1Notation());
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key)
तय की गई कुंजी के साथ डेवलपर मेटाडेटा को रेंज में जोड़ता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Adds the key 'NAME' to the developer metadata for row 2. range.addDeveloperMetadata('NAME'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
key | String | नए डेवलपर मेटाडेटा के लिए कुंजी. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
तय की गई कुंजी और 'किसको दिखे' की रेंज के साथ, डेवलपर मेटाडेटा जोड़ता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT' // for row 2 on Sheet1. range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the updated metadata info and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
key | String | नए डेवलपर मेटाडेटा के लिए कुंजी. |
visibility | DeveloperMetadataVisibility | नए डेवलपर मेटाडेटा का 'किसको दिखे' सेटिंग. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
तय की गई कुंजी और वैल्यू के साथ, डेवलपर मेटाडेटा को रेंज में जोड़ता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 of Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
key | String | नए डेवलपर मेटाडेटा के लिए कुंजी. |
value | String | नए डेवलपर मेटाडेटा की वैल्यू. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
खास कुंजी, वैल्यू, और रेंज में किसे दिखाने के बारे में जानकारी के साथ डेवलपर मेटाडेटा जोड़ता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to PROJECT for row 2 on the sheet. range.addDeveloperMetadata( 'NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the updated metadata info and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
key | String | नए डेवलपर मेटाडेटा के लिए कुंजी. |
value | String | नए डेवलपर मेटाडेटा की वैल्यू. |
visibility | DeveloperMetadataVisibility | नए डेवलपर मेटाडेटा का 'किसको दिखे' सेटिंग. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding()
रेंज पर डिफ़ॉल्ट कॉलम बैंडिंग थीम लागू करता है. डिफ़ॉल्ट रूप से, बैंडिंग में हेडर होता है और फ़ुटर का रंग नहीं होता.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies column banding to row 2. const colBanding = range.applyColumnBanding(); // Gets the first banding on the sheet and logs the color of the header column. console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString()); // Gets the first banding on the sheet and logs the color of the second column. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());
रिटर्न
Banding
— नई बैंडिंग.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme)
रेंज पर किसी खास कॉलम बैंडिंग थीम को लागू करता है. डिफ़ॉल्ट रूप से, बैंडिंग में हेडर होता है और फ़ुटर का रंग नहीं होता.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies the INDIGO color banding theme to the columns in row 2. const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the first banding on the sheet and logs the color of the second column. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
bandingTheme | BandingTheme | रेंज के कॉलम पर लागू करने के लिए कलर थीम. |
रिटर्न
Banding
— नई बैंडिंग.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme, showHeader, showFooter)
तय हेडर और फ़ुटर सेटिंग वाली रेंज में किसी खास कॉलम बैंडिंग थीम लागू करता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 12-22 on the sheet. const range = sheet.getRange('12:22'); // Applies the BLUE color banding theme to rows 12-22. // Sets the header visibility to false and the footer visibility to true. const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true); // Gets the banding color and logs it to the console. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString()); // Gets the header color object and logs it to the console. Returns null because the header // visibility is set to false. console.log(sheet.getBandings()[0].getHeaderColumnColorObject()); // Gets the footer color and logs it to the console. console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
bandingTheme | BandingTheme | रेंज के कॉलम पर लागू करने के लिए कलर थीम. |
showHeader | Boolean | अगर true होता है, तो बैंडिंग थीम के हेडर का रंग पहले कॉलम पर लागू होता है. |
showFooter | Boolean | अगर true हो, तो बैंडिंग थीम फ़ुटर का रंग, आखिरी
कॉलम पर लागू होता है. |
रिटर्न
Banding
— नई बैंडिंग.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding()
रेंज पर डिफ़ॉल्ट पंक्ति बैंडिंग थीम लागू करता है. डिफ़ॉल्ट रूप से, बैंडिंग में हेडर होता है और फ़ुटर का रंग नहीं होता.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies row banding to rows 1-30. range.applyRowBanding(); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0] .getSecondRowColorObject() .asRgbColor() .asHexString(); // Logs the hex color to console. console.log(secondRowColor);
रिटर्न
Banding
— बैंडिंग.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme)
रेंज पर किसी खास रो बैंडिंग थीम को लागू करता है. डिफ़ॉल्ट रूप से, बैंडिंग में हेडर होता है और फ़ुटर का रंग नहीं होता.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding theme to rows 1-30. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0] .getSecondRowColorObject() .asRgbColor() .asHexString(); // Logs the hex color to console. console.log(secondRowColor);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
bandingTheme | BandingTheme | रेंज की पंक्तियों पर लागू करने के लिए कलर थीम. |
रिटर्न
Banding
— नई बैंडिंग.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme, showHeader, showFooter)
तय हेडर और फ़ुटर सेटिंग के साथ रेंज पर किसी तय पंक्ति बैंडिंग थीम लागू करता है.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding to rows 1-30 and // specifies to hide the header and show the footer. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
bandingTheme | BandingTheme | रेंज की पंक्तियों पर लागू करने के लिए कलर थीम. |
showHeader | Boolean | अगर true है, तो बैंडिंग थीम के हेडर का रंग पहली पंक्ति पर लागू किया जाता है. |
showFooter | Boolean | अगर true है, तो बैंडिंग थीम फ़ुटर का रंग आखिरी पंक्ति पर लागू किया जाता है. |
रिटर्न
Banding
— नई बैंडिंग.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFill(destination, series)
destinationRange
में इस रेंज के डेटा के आधार पर डेटा भरता है. नई वैल्यू, बताए गए series
टाइप से भी तय की जाती हैं. डेस्टिनेशन रेंज में यह रेंज शामिल होनी चाहिए और इसे सिर्फ़ एक दिशा में बढ़ाना चाहिए. उदाहरण के लिए, यह A1:A20
को A1:A4
में मौजूदा वैल्यू के आधार पर बढ़ती हुई संख्याओं की सीरीज़ से भर देता है:
var sheet = SpreadsheetApp.getActiveSheet(); // Has values [1, 2, 3, 4]. var sourceRange = sheet.getRange("A1:A4"); // The range to fill with values. var destination = sheet.getRange("A1:A20"); // Inserts new values in A5:A20, continuing the pattern expressed in A1:A4 sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
destination | Range | वह रेंज जिसमें वैल्यू अपने-आप भरनी हैं. मंज़िल की रेंज में यह रेंज होनी चाहिए और इसे सिर्फ़ एक दिशा में बढ़ाना चाहिए (ऊपर, नीचे, बाएं या दाएं). |
series | AutoFillSeries | अपने-आप भरने वाली सीरीज़ का टाइप, जिसका इस्तेमाल नई वैल्यू को कैलकुलेट करने के लिए किया जाना चाहिए. इस सीरीज़ का असर, सोर्स डेटा के टाइप और मात्रा के आधार पर अलग-अलग होता है. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFillToNeighbor(series)
आस-पास के सेल के आधार पर नया डेटा भरने के लिए किसी रेंज की गणना करता है और इस रेंज में मौजूद डेटा के आधार पर उस रेंज में अपने-आप नई वैल्यू भरता है. ये नई वैल्यू, बताए गए series
टाइप से भी तय की जाती हैं.
कैलकुलेटेड डेस्टिनेशन रेंज में आस-पास के डेटा को शामिल करके यह तय किया जाता है कि नए वैल्यू कहां डाली जानी चाहिए: अगर अपने-आप भरे जा रहे कॉलम के ठीक बाईं या दाईं ओर डेटा है, तो नई वैल्यू सिर्फ़ पास के डेटा तक ही बढ़ाई जाती हैं.
उदाहरण के लिए, अगर A1:A20
में बढ़ती हुई संख्याओं की सीरीज़ डाली गई है और इस तरीके को B1:B4
रेंज में कॉल किया जाता है, जिसमें तारीखों की सीरीज़ शामिल होती है, तो नई वैल्यू सिर्फ़ B5:B20
में डाली जाती हैं. इस तरह ये नई वैल्यू उन सेल में "जुड़ जाती हैं" जिनमें कॉलम A में वैल्यू हैं.
var sheet = SpreadsheetApp.getActiveSheet(); // A1:A20 has values [1, 2, 3, ... 20]. // B1:B4 has values [1/1/2017, 1/2/2017, ...] var sourceRange = sheet.getRange("B1:B4"); // Results in B5:B20 having values [1/5/2017, ... 1/20/2017] sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
series | AutoFillSeries | अपने-आप भरने वाली सीरीज़ का टाइप, जिसका इस्तेमाल नई वैल्यू को कैलकुलेट करने के लिए किया जाना चाहिए. इस सीरीज़ का असर, सोर्स डेटा के टाइप और मात्रा के आधार पर अलग-अलग होता है. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
रेंज में मौजूद एक से ज़्यादा कॉलम वाली सेल को फिर से अलग-अलग सेल में बांटें.
किसी रेंज पर इस फ़ंक्शन को कॉल करना, किसी रेंज को चुनने और फ़ॉर्मैट करें > सेल मर्ज करें > अनमर्ज करें पर क्लिक करने के बराबर है.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Unmerges the range A1:C6 into individual cells. range.breakApart();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
canEdit()
यह तय करता है कि उपयोगकर्ता के पास रेंज के हर सेल में बदलाव करने की अनुमति है या नहीं. स्प्रेडशीट का मालिक कभी भी सुरक्षित रेंज और शीट में बदलाव कर सकता है.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Logs whether the user has permission to edit every cell in the range. console.log(range.canEdit());
रिटर्न
Boolean
— true
, अगर उपयोगकर्ता के पास रेंज की हर सेल में बदलाव करने की अनुमति है, नहीं तो false
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
रेंज में चेकबॉक्स की स्थिति को "चुनी गई" में बदलता है. उस रेंज में मौजूद सेल को अनदेखा करता है जिसमें फ़िलहाल, कॉन्फ़िगर किया गया या सही का निशान हटाया गया मान नहीं है.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the range A1:B10 to 'checked'. var range = SpreadsheetApp.getActive().getRange('A1:B10'); range.check();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
कॉन्टेंट और फ़ॉर्मैट की रेंज हटाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clear();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
दिए गए बेहतर विकल्पों में बताए गए कॉन्टेंट की रेंज, फ़ॉर्मैट, डेटा की पुष्टि करने के नियम, और/या टिप्पणियों को मिटाता है. डिफ़ॉल्ट रूप से, सारा डेटा मिटा दिया जाता है.
// The code below clears range C2:G7 in the active sheet, but preserves the format, // data validation rules, and comments. SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
options | Object | बेहतर पैरामीटर के बारे में बताने वाला JavaScript ऑब्जेक्ट, जैसा कि नीचे दिया गया है. |
उन्नत पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
commentsOnly | Boolean | सिर्फ़ टिप्पणियों को मिटाना है या नहीं. |
contentsOnly | Boolean | क्या सिर्फ़ कॉन्टेंट मिटाना है. |
formatOnly | Boolean | क्या सिर्फ़ फ़ॉर्मैट को मिटाना है; ध्यान दें कि डेटा मिटाने के फ़ॉर्मैट से, डेटा की पुष्टि करने के नियम भी मिट जाते हैं. |
validationsOnly | Boolean | सिर्फ़ डेटा की पुष्टि करने के नियमों को मिटाना है या नहीं. |
skipFilteredRows | Boolean | फ़िल्टर की गई पंक्तियों को मिटाने से बचना है या नहीं. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
फ़ॉर्मैटिंग को बनाए रखते हुए, रेंज के कॉन्टेंट को हटा देता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearContent();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
रेंज के लिए, डेटा की पुष्टि करने के नियमों को हटा देता है.
// Clear the data validation rules for cells A1:B5. var range = SpreadsheetApp.getActive().getRange('A1:B5'); range.clearDataValidations();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
इस श्रेणी की फ़ॉर्मैटिंग को साफ़ करता है.
इससे रेंज में सेल या सेल के लिए टेक्स्ट की फ़ॉर्मैटिंग हट जाती है, लेकिन नंबर फ़ॉर्मैटिंग का कोई भी नियम रीसेट नहीं होता.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearFormat();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
दिए गए सेल या सेल में नोट को हटाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearNote();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseGroups()
रेंज में पूरी तरह से शामिल सभी ग्रुप को छोटा करता है. अगर कोई भी ग्रुप पूरी तरह से रेंज में नहीं है, तो जो ग्रुप सबसे ज़्यादा गहरा है उसे छोटा कर दिया जाता है.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are collapsed. range.collapseGroups();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
रेंज की फ़ॉर्मैटिंग को दी गई जगह पर कॉपी करें. अगर डेस्टिनेशन, सोर्स रेंज से बड़ा या छोटा है, तो सोर्स को दोहराया जाता है या उसके हिसाब से काट-छांट की जाती है. ध्यान दें कि यह तरीका सिर्फ़ फ़ॉर्मैटिंग को कॉपी करता है.
ग्रिड आईडी पैरामीटर की ज़्यादा जानकारी के लिए, getGridId()
देखें.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var range = source.getRange("B2:D4"); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId // of a sheet by calling sheet.getSheetId() or range.getGridId(). range.copyFormatToRange(1555299895, 4, 6, 4, 6);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
gridId | Integer | स्प्रेडशीट में शीट का यूनीक आईडी, उसकी पोज़िशन पर ध्यान दिए बिना. |
column | Integer | टारगेट की रेंज का पहला कॉलम. |
columnEnd | Integer | लक्ष्य की सीमा का आखिरी कॉलम. |
row | Integer | टारगेट की रेंज की शुरुआती लाइन. |
rowEnd | Integer | टारगेट की रेंज की आखिरी पंक्ति. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
इन्हें भी देखें
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)
रेंज की फ़ॉर्मैटिंग को दी गई जगह पर कॉपी करें. अगर डेस्टिनेशन, सोर्स रेंज से बड़ा या छोटा है, तो सोर्स को दोहराया जाता है या उसके हिसाब से काट-छांट की जाती है. ध्यान दें कि यह तरीका सिर्फ़ फ़ॉर्मैटिंग को कॉपी करता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var destination = ss.getSheets()[1]; var range = source.getRange("B2:D4"); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyFormatToRange(destination, 4, 6, 4, 6);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
sheet | Sheet | टारगेट शीट. |
column | Integer | टारगेट की रेंज का पहला कॉलम. |
columnEnd | Integer | लक्ष्य की सीमा का आखिरी कॉलम. |
row | Integer | टारगेट की रेंज की शुरुआती लाइन. |
rowEnd | Integer | टारगेट की रेंज की आखिरी पंक्ति. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination)
डेटा को सेल की रेंज से सेल की किसी दूसरी रेंज में कॉपी करता है. वैल्यू और फ़ॉर्मैटिंग, दोनों को कॉपी किया जाता है.
// The code below copies the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5); rangeToCopy.copyTo(sheet.getRange(1, 6));
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
destination | Range | वह डेस्टिनेशन रेंज जिसमें कॉपी किया जाना है; सिर्फ़ सबसे ऊपर बाईं ओर मौजूद सेल की स्थिति काम की होती है. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, copyPasteType, transposed)
डेटा को सेल की रेंज से सेल की किसी दूसरी रेंज में कॉपी करता है.
// The code below copies only the values of the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES, false);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
destination | Range | वह डेस्टिनेशन रेंज जिसमें कॉपी किया जाना है; सिर्फ़ सबसे ऊपर बाईं ओर मौजूद सेल की स्थिति काम की होती है. |
copyPasteType | CopyPasteType | ऐसा टाइप जो तय करता है कि रेंज के कॉन्टेंट को डेस्टिनेशन पर कैसे चिपकाया जाता है. |
transposed | Boolean | रेंज को इसके ट्रांसपोज़ किए गए ओरिएंटेशन में चिपकाया जाना चाहिए या नहीं. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, options)
डेटा को सेल की रेंज से सेल की किसी दूसरी रेंज में कॉपी करता है. डिफ़ॉल्ट रूप से, वैल्यू और फ़ॉर्मैट, दोनों को कॉपी किया जाता है. हालांकि, बेहतर तर्कों का इस्तेमाल करके इसे बदला जा सकता है.
// The code below copies only the values of the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
destination | Range | वह डेस्टिनेशन रेंज जिसमें कॉपी किया जाना है; सिर्फ़ सबसे ऊपर बाईं ओर मौजूद सेल की स्थिति काम की होती है. |
options | Object | बेहतर पैरामीटर के बारे में बताने वाला JavaScript ऑब्जेक्ट, जैसा कि नीचे दिया गया है. |
उन्नत पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
formatOnly | Boolean | यह बताता है कि सिर्फ़ फ़ॉर्मैट कॉपी किया जाना चाहिए |
contentsOnly | Boolean | इससे यह तय होता है कि सिर्फ़ कॉन्टेंट को कॉपी किया जाना चाहिए |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)
रेंज का कॉन्टेंट, दी गई जगह पर कॉपी करें. अगर डेस्टिनेशन, सोर्स रेंज से बड़ा या छोटा है, तो सोर्स को दोहराया जाता है या उसके हिसाब से काट-छांट की जाती है.
ग्रिड आईडी पैरामीटर की ज़्यादा जानकारी के लिए, getGridId()
देखें.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var range = source.getRange("B2:D4"); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 0 range.copyValuesToRange(0, 4, 6, 4, 6);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
gridId | Integer | स्प्रेडशीट में शीट का यूनीक आईडी, उसकी पोज़िशन पर ध्यान दिए बिना. |
column | Integer | टारगेट की रेंज का पहला कॉलम. |
columnEnd | Integer | लक्ष्य की सीमा का आखिरी कॉलम. |
row | Integer | टारगेट की रेंज की शुरुआती लाइन. |
rowEnd | Integer | टारगेट की रेंज की आखिरी पंक्ति. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
इन्हें भी देखें
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)
रेंज का कॉन्टेंट, दी गई जगह पर कॉपी करें. अगर डेस्टिनेशन, सोर्स रेंज से बड़ा या छोटा है, तो सोर्स को दोहराया जाता है या उसके हिसाब से काट-छांट की जाती है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var destination = ss.getSheets()[1]; var range = source.getRange("B2:D4"); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyValuesToRange(destination, 4, 6, 4, 6);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
sheet | Sheet | टारगेट शीट. |
column | Integer | टारगेट की रेंज का पहला कॉलम. |
columnEnd | Integer | लक्ष्य की सीमा का आखिरी कॉलम. |
row | Integer | टारगेट की रेंज की शुरुआती लाइन. |
rowEnd | Integer | टारगेट की रेंज की आखिरी पंक्ति. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTable(dataSource)
डेटा सोर्स से एक खाली डेटा सोर्स पिवट टेबल बनाता है, जिसे इस रेंज की पहली सेल पर ऐंकर किया जाता है.
इस उदाहरण में, एक नया डेटा सोर्स पिवट टेबल बनाने और उसे कॉन्फ़िगर करने का तरीका बताया गया है.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var anchorCell = spreadsheet.getSheets()[0].getRange('A1'); var dataSource = spreadsheet.getDataSources()[0]; var pivotTable = anchorCell.createDataSourcePivotTable(dataSource); pivotTable.addRowGroup('dataColumnA'); pivotTable.addColumnGroup('dataColumnB'); pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM); pivotTable.addFilter('dataColumnA', SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
dataSource | DataSource | वह डेटा सोर्स जिससे पिवट टेबल बनानी है. |
रिटर्न
DataSourcePivotTable
— बनाए गए नए डेटा सोर्स की पिवट टेबल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourceTable(dataSource)
डेटा सोर्स से एक खाली डेटा सोर्स टेबल बनाता है, जिसे इस रेंज की पहली सेल पर ऐंकर किया जाता है.
इस उदाहरण में, एक नया डेटा सोर्स टेबल बनाने और उसे कॉन्फ़िगर करने का तरीका बताया गया है.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var anchorCell = spreadsheet.getSheets()[0].getRange('A1'); var dataSource = spreadsheet.getDataSources()[0]; var dataSourceTable = anchorCell.createDataSourceTable(dataSource); .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC') .addSortSpec('dataColumnA', /* ascending= *\/ true) .addSortSpec('dataColumnB', /* ascending= *\/ false);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
dataSource | DataSource | वह डेटा सोर्स जिससे पिवट टेबल बनानी है. |
रिटर्न
DataSourceTable
— बनाई गई नई डेटा सोर्स टेबल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
इस रेंज के दायरे में डेवलपर मेटाडेटा को खोजने के लिए, DeveloperMetadataFinderApi दिखता है. मेटाडेटा, रेंज के दायरे में सिर्फ़ तब आता है, जब वह उस रेंज में पूरी तरह से शामिल हो. उदाहरण के लिए, लाइन ‘3:3’ से जुड़ा मेटाडेटा, ‘A1:D5’ रेंज में नहीं है, लेकिन ‘1:5’ की रेंज में है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6. const range = sheet.getRange('A1:C6'); // Creates a developer metadata finder to search for metadata in the scope of this range. const developerMetaDataFinder = range.createDeveloperMetadataFinder(); // Logs information about the developer metadata finder to the console. const developerMetaData = developerMetaDataFinder.find()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
रिटर्न
DeveloperMetadataFinder
— इस रेंज में आने वाले मेटाडेटा की खोज करने के लिए, डेवलपर मेटाडेटा ढूंढने की सुविधा.
createFilter()
फ़िल्टर बनाता है और उसे शीट में बताई गई रेंज पर लागू करता है. आप किसी शीट पर एक से ज़्यादा
फ़िल्टर नहीं बना सकते. फ़िल्टर बनाने के बाद, उसे ऐक्सेस करने और उसमें बदलाव करने के लिए, getFilter()
या Sheet.getFilter()
का इस्तेमाल करें.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Creates a new filter and applies it to the range A1:C20 on the active sheet. function createFilter() { range.createFilter(); } // Gets the filter and applies criteria that only shows cells that aren't empty. function getFilterAddCriteria() { let filter = range.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); filter.setColumnFilterCriteria(2, criteria); }इस तरीके का इस्तेमाल करके
Grid
शीट के लिए फ़िल्टर बनाएं. यह शीट का डिफ़ॉल्ट टाइप है.
ग्रिड शीट ऐसी शीट होती हैं जो किसी डेटाबेस से कनेक्ट नहीं होती हैं. दूसरी तरह के फ़िल्टर बनाने के लिए,
देखें कि:
PivotTable.addFilter(sourceDataColumn, filterCriteria)
की मदद से पिवट टेबल फ़िल्टर बनाएंDataSourceSheet.addFilter(columnName, filterCriteria)
की मदद से डेटाबेस से कनेक्ट की गई शीट के लिए, फ़िल्टर बनाएंDataSourcePivotTable.addFilter(columnName, filterCriteria)
की मदद से डेटाबेस से कनेक्ट की गई पिवट टेबल के लिए फ़िल्टर बनाएं
रिटर्न
Filter
— नया फ़िल्टर.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createPivotTable(sourceData)
इस रेंज की पहली सेल में ऐंकर किए गए sourceData
से, एक खाली पिवट टेबल बनाता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A1 as a range in order to place the pivot table. const range = sheet.getRange('A1'); // Gets the range of the source data for the pivot table. const dataRange = sheet.getRange('E12:G20'); // Creates an empty pivot table from the specified source data. const pivotTable = range.createPivotTable(dataRange); // Logs the values from the pivot table's source data to the console. console.log(pivotTable.getSourceDataRange().getValues());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
sourceData | Range | वह डेटा जिससे पिवट टेबल बनानी है. |
रिटर्न
PivotTable
— नया बनाया गया PivotTable
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createTextFinder(findText)
इस रेंज के लिए टेक्स्ट फ़ाइंडर बनाता है, जो इस रेंज में मौजूद टेक्स्ट को खोजकर उसे बदल सकता है.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // Creates a text finder for the range. var textFinder = range.createTextFinder('dog'); // Returns the first occurrence of 'dog'. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = textFinder.replaceWith('cat');
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
findText | String | खोजा जाने वाला टेक्स्ट. |
रिटर्न
TextFinder
— रेंज के लिए TextFinder
deleteCells(shiftDimension)
सेल की इस रेंज को मिटाता है. दिए गए डाइमेंशन के साथ शीट में मौजूद डेटा को मिटाई गई रेंज में ट्रांसफ़र कर दिया जाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
shiftDimension | Dimension | वह डाइमेंशन जिसके साथ मौजूदा डेटा को शिफ़्ट करना है. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandGroups()
छोटे किए गए उन ग्रुप को बड़ा करता है जिनकी रेंज या कंट्रोल टॉगल, इस रेंज को इंटरसेक्ट करता है. कंट्रोल टॉगल की जगह, वह इंडेक्स होता है जिस पर सेटिंग के आधार पर ग्रुप के ठीक पहले या बाद में कंट्रोल टॉगल दिखाया जाता है. अगर एक ही जगह पर एक से ज़्यादा ग्रुप हैं, तो उथले ग्रुप को बड़ा कर दिया जाता है.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getA1Notation()
A1 नोटेशन में रेंज की स्ट्रिंग की जानकारी देता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 2, 5); // Logs "A1:E2" Logger.log(range.getA1Notation());
रिटर्न
String
— A1 नोटेशन में रेंज का स्ट्रिंग का ब्यौरा.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackground()
रेंज में सबसे ऊपर बाईं ओर मौजूद सेल के बैकग्राउंड का रंग दिखाता है (जैसे, '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackground());
रिटर्न
String
— बैकग्राउंड का कलर कोड.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObject()
रेंज में सबसे ऊपर बाईं ओर मौजूद सेल के बैकग्राउंड का रंग दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());
रिटर्न
Color
— रेंज में सबसे ऊपर बाईं ओर मौजूद सेल का बैकग्राउंड कलर.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObjects()
रेंज में सेल के बैकग्राउंड के रंग दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgroundObjects(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j].asRgbColor().asHexString()); } }
रिटर्न
Color[][]
— बैकग्राउंड के रंगों का दो डाइमेंशन वाला कलेक्शन.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgrounds()
रेंज में सेल के बैकग्राउंड के रंग दिखाता है (जैसे, '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgrounds(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j]); } }
रिटर्न
String[][]
— बैकग्राउंड के कलर कोड का दो डाइमेंशन वाला अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBandings()
इस श्रेणी में किसी भी सेल पर लागू किए गए सभी बैंडिंग देता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets a range. const range = sheet.getRange('A1:K50'); // Gets the banding info for the range. const bandings = range.getBandings(); // Logs the second row color for each banding to the console. for (let banding of bandings) { console.log(banding.getSecondRowColor()); }
रिटर्न
Banding[]
— इस रेंज में मौजूद किसी भी सेल पर लागू होने वाली सभी बैंडिंग.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCell(row, column)
किसी रेंज में कोई सेल दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // The row and column here are relative to the range // getCell(1,1) in this code returns the cell at B2 var cell = range.getCell(1, 1); Logger.log(cell.getValue());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
row | Integer | रेंज के सापेक्ष सेल की पंक्ति. |
column | Integer | रेंज के सापेक्ष सेल का कॉलम. |
रिटर्न
Range
— तय किए गए निर्देशांकों पर, एक सेल वाली रेंज.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumn()
इस रेंज के लिए शुरुआती कॉलम की जगह दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "2.0" Logger.log(range.getColumn());
रिटर्न
Integer
— स्प्रेडशीट में रेंज के शुरुआती कॉलम की जगह.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion()
चार कार्डनल Direction
में बढ़ाई गई रेंज की कॉपी लौटाता है, ताकि
आस-पास मौजूद सभी सेल में डेटा वाले सेल को कवर किया जाए. अगर रेंज खाली सेल से घिरा है, जिसमें विकर्णों के साथ वाले सेल शामिल नहीं हैं, तो रेंज अपने-आप वापस मिल जाती है. यह ऐसा ही है जैसे कि एडिटर में रेंज
चुनना और Ctrl+A
टाइप करना होता है.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange("C2").setValue(100); sheet.getRange("B3").setValue(100); sheet.getRange("D3").setValue(100); sheet.getRange("C4").setValue(100); // Logs "B2:D4" Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());
रिटर्न
Range
— रेंज का डेटा क्षेत्र या पूरी स्प्रेडशीट के लिए कोई रेंज.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion(dimension)
अगर तय किया गया डाइमेंशन Dimension.ROWS
है, तो बड़ी की गई रेंज Direction.UP
और Direction.DOWN
की कॉपी दिखाता है. अगर डाइमेंशन Dimension.COLUMNS
है, तो Direction.NEXT
और Direction.PREVIOUS
की कॉपी दिखाता है. रेंज का विस्तार, टेबल की तरह व्यवस्थित की गई रेंज के बगल में मौजूद डेटा का पता लगाने पर आधारित होता है. बढ़ाई गई रेंज,
सभी पास-पास के सेल को कवर करती है. इसमें, टेबल की सीमाओं के साथ-साथ, तय किए गए डाइमेंशन का डेटा भी होता है. अगर ओरिजनल रेंज, तय किए गए डाइमेंशन में खाली सेल से घिरी हुई है,
तो रेंज अपने-आप वापस मिल जाती है. यह तरीका, एडिटर में कॉलम के लिए
Ctrl+Space
या कॉलम के लिए Shift+Space
टाइप करने जैसा है.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange("C2").setValue(100); sheet.getRange("B3").setValue(100); sheet.getRange("D3").setValue(100); sheet.getRange("C4").setValue(100); // Logs "C2:C4" Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation()); // Logs "B3:D3" Logger.log( sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
dimension | Dimension | वह डाइमेंशन जिसके साथ रेंज को बढ़ाना है. |
रिटर्न
Range
— यह रेंज का डेटा क्षेत्र या हर कॉलम या हर पंक्ति को कवर करने वाली
ओरिजनल रेंज तक की रेंज का डेटा होता है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormula()
रेंज में पहली सेल के लिए DataSourceFormula
दिखाता है. अगर सेल में डेटा सोर्स का फ़ॉर्मूला नहीं है, तो null
दिखाता है.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1 on Sheet1. const range = sheet.getRange('A1'); // Gets the data source formula from cell A1. const dataSourceFormula = range.getDataSourceFormula(); // Gets the formula. const formula = dataSourceFormula.getFormula(); // Logs the formula. console.log(formula);
रिटर्न
DataSourceFormula
— सेल का DataSourceFormula
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
रेंज में मौजूद सेल के लिए DataSourceFormula
दिखाता है.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B5 on Sheet1. const range = sheet.getRange('A1:B5'); // Gets an array of the data source formulas in the range A1:B5. const dataSourceFormulas = range.getDataSourceFormulas(); // Logs the first formula in the array. console.log(dataSourceFormulas[0].getFormula());
रिटर्न
DataSourceFormula[]
— DataSourceFormula
की कैटगरी.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
रेंज को इंटरसेक्ट करने वाली सभी डेटा सोर्स की पिवट टेबल दिखाता है.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets an array of the data source pivot tables in the range A1:G50. const dataSourcePivotTables = range.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
रिटर्न
DataSourcePivotTable[]
— डेटा सोर्स में मौजूद पिवट टेबल की सूची.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
रेंज को इंटरसेक्ट करने वाली सभी डेटा सोर्स टेबल दिखाता है.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets the first data source table in the range A1:G50. const dataSourceTable = range.getDataSourceTables()[0]; // Logs the time of the last completed data execution on the data source table. console.log(dataSourceTable.getStatus().getLastExecutionTime());
रिटर्न
DataSourceTable[]
— डेटा सोर्स टेबल की सूची.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceUrl()
इस रेंज के डेटा के लिए यूआरएल दिखाता है, जिसका इस्तेमाल चार्ट और क्वेरी बनाने के लिए किया जा सकता है.
Code.gs
function doGet() { var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c'); var sheet = ss.getSheetByName('ContinentData'); var range = sheet.getRange('A1:B8'); var template = HtmlService.createTemplateFromFile('piechart'); template.dataSourceUrl = range.getDataSourceUrl(); return template.evaluate(); }
piechart.html
<!DOCTYPE html> <html> <head> <!--Load the AJAX API--> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> // Load the Visualization API and the corechart package. google.charts.load('current', {'packages': ['corechart']}); // Set a callback to run when the Google Visualization API is loaded. google.charts.setOnLoadCallback(queryData); function queryData() { var query = new google.visualization.Query('<?= dataSourceUrl ?>'); query.send(drawChart); } // Callback that creates and populates a data table, // instantiates the pie chart, passes in the data and // draws it. function drawChart(response) { if (response.isError()) { alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage()); return; } var data = response.getDataTable(); // Set chart options. var options = { title: 'Population by Continent', width: 400, height: 300 }; // Instantiate and draw the chart, passing in some options. var chart = new google.visualization.PieChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <!-- Div that holds the pie chart. --> <div id="chart_div"></div> </body> </html>
रिटर्न
String
— इस रेंज के लिए डेटा सोर्स के तौर पर यूआरएल, जिसे चार्ट जैसे अन्य एपीआई को भेजा जा सकता है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataTable()
इस ऑब्जेक्ट के अंदर का डेटा, DataTable के तौर पर दिखाएं.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B7 on Sheet1. const range = sheet.getRange('A1:B7'); // Gets the range A1:B7 as a data table. The values in each column must be of the same type. const datatable = range.getDataTable(); // Uses the Charts service to build a bar chart from the data table. // This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead. const chart = Charts.newBarChart() .setDataTable(datatable) .setOption('title', 'Your Chart Title Here') .build();
रिटर्न
DataTable
— डेटा टेबल के तौर पर.
getDataTable(firstRowIsHeader)
इस रेंज के अंदर के डेटा को Data Tables के तौर पर दिखाएं.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B7"); // Calling this method with "true" sets the first line to be the title of the axes var datatable = range.getDataTable(true); // Note that this doesn't build an EmbeddedChart, so you can't just use // Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead. var chart = Charts.newBarChart() .setDataTable(datatable) .setOption("title", "Your Title Here") .build();
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
firstRowIsHeader | Boolean | पहली लाइन को हेडर के तौर पर इस्तेमाल करें या नहीं. |
रिटर्न
DataTable
— डेटा टेबल के तौर पर.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidation()
रेंज में सबसे ऊपर बाईं ओर मौजूद सेल के लिए, डेटा की पुष्टि करने का नियम दिखाता है. अगर सेल पर डेटा की पुष्टि
सेट नहीं की गई है, तो यह तरीका null
दिखाता है.
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
रिटर्न
DataValidation
— रेंज में सबसे ऊपर बाईं ओर मौजूद सेल के लिए, डेटा की पुष्टि करने का नियम.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidations()
इस रेंज में मौजूद सभी सेल के लिए, डेटा की पुष्टि करने के नियम दिखाता है. अगर किसी सेल पर डेटा की पुष्टि नहीं की गई है, तो यह तरीका अरे में उस सेल की स्थिति के लिए null
दिखाता है.
// Change existing data validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
रिटर्न
DataValidation[][]
— डेटा की पुष्टि करने के नियमों का दो-डाइमेंशन वाला अरे, जो रेंज में मौजूद सेल से जुड़ा होता है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
इस रेंज से जुड़े डेवलपर मेटाडेटा की जानकारी मिलती है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds metadata to row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Logs the metadata to console. for (const metadata of range.getDeveloperMetadata()) { console.log(`${metadata.getKey()}: ${metadata.getValue()}`); }
रिटर्न
DeveloperMetadata[]
— इस रेंज से जुड़ा डेवलपर मेटाडेटा.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
रेंज में सबसे ऊपर बाईं ओर मौजूद सेल की दिखाई गई वैल्यू दिखाता है. वैल्यू एक String
है.
दिखाई गई वैल्यू में तारीख, समय, और मुद्रा के फ़ॉर्मैट को ध्यान में रखा जाता है. इसमें स्प्रेडशीट की स्थान-भाषा की सेटिंग से अपने-आप लागू होने वाले फ़ॉर्मैट भी शामिल हैं. खाली सेल खाली स्ट्रिंग दिखाते हैं.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its value to 'Test code.' const cell = sheet.getRange('A30'); cell.setValue('Test code'); // Gets the value and logs it to the console. console.log(cell.getDisplayValue());
रिटर्न
String
— इस सेल में दिखाई गई वैल्यू.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValues()
इस रेंज के लिए वैल्यू की रेक्टैंगल ग्रिड दिखाता है.
दिखाई गई वैल्यू की दो-डाइमेंशन वाला अरे दिखाता है. इसे पहले पंक्ति और फिर कॉलम के हिसाब से इंडेक्स किया जाता है. वैल्यू String
ऑब्जेक्ट हैं. दिखाई गई वैल्यू में तारीख, समय, और मुद्रा के फ़ॉर्मैट का ध्यान रखा जाता है. इसमें स्प्रेडशीट की स्थान-भाषा की सेटिंग से अपने-आप लागू होने वाले फ़ॉर्मैट भी शामिल हैं. खाली सेल को अरे में खाली स्ट्रिंग से दिखाया जाता है. याद रखें कि जब रेंज इंडेक्स 1, 1
से शुरू होता है, तो JavaScript के कलेक्शन को [0][0]
से इंडेक्स किया जाता है.
// The code below gets the displayed values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues(); Logger.log(values[0][0]);
रिटर्न
String[][]
— वैल्यू की दो डाइमेंशन वाली अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
उस शीट पर फ़िल्टर लौटाता है जिससे यह श्रेणी संबंधित है या अगर शीट में कोई फ़िल्टर नहीं है, तो null
दिखाता है.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Gets the existing filter on the sheet that the given range belongs to. let filter = range.getFilter();
रिटर्न
Filter
— फ़िल्टर.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObject()
रेंज के सबसे ऊपर बाएं कोने में, सेल के फ़ॉन्ट का रंग दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontColorObject().asRgbColor().asHexString());
रिटर्न
Color
— रेंज में सबसे ऊपर बाईं ओर मौजूद सेल के फ़ॉन्ट का कलर.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObjects()
रेंज में मौजूद सेल के फ़ॉन्ट के रंग दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontColorObjects(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j].asRgbColor().asHexString()); } }
रिटर्न
Color[][]
— फ़ॉन्ट के कलर की दो डाइमेंशन वाला अरे, जो रेंज में मौजूद सेल से जुड़ा होता है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamilies()
रेंज में मौजूद सेल की फ़ॉन्ट फ़ैमिली दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontFamilies(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
रिटर्न
String[][]
— फ़ॉन्ट फ़ैमिली की दो डाइमेंशन वाली अरे, जो रेंज में मौजूद सेल से जुड़ी होती है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamily()
रेंज के सबसे ऊपर बाएं कोने में, सेल की फ़ॉन्ट फ़ैमिली दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontFamily());
रिटर्न
String
— सेल की फ़ॉन्ट फ़ैमिली.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLine()
रेंज के सबसे ऊपर बाएं कोने में, सेल का लाइन स्टाइल दिखाता है ('underline'
, 'line-through'
या 'none'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontLine());
रिटर्न
String
— फ़ॉन्ट लाइन.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLines()
रेंज ('underline'
, 'line-through'
या
'none'
) में मौजूद सेल की लाइन स्टाइल लेता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontLines(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
रिटर्न
String[][]
— फ़ॉन्ट लाइनों की दो डाइमेंशन वाला अरे, जो रेंज में मौजूद सेल से जुड़ा होता है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSize()
रेंज के सबसे ऊपर बाएं कोने में, सेल के पॉइंट साइज़ में फ़ॉन्ट का साइज़ दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontSize());
रिटर्न
Integer
— पॉइंट साइज़ में फ़ॉन्ट का साइज़.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSizes()
रेंज में मौजूद सेल के फ़ॉन्ट साइज़ दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontSizes(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
रिटर्न
Integer[][]
— रेंज में मौजूद सेल से जुड़े टेक्स्ट के फ़ॉन्ट साइज़ का दो-डाइमेंशन वाला अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyle()
रेंज के सबसे ऊपर बाएं कोने में सेल की फ़ॉन्ट स्टाइल ('italic'
या 'normal'
) दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontStyle());
रिटर्न
String
— सेल में मौजूद टेक्स्ट की फ़ॉन्ट स्टाइल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyles()
रेंज में मौजूद सेल की फ़ॉन्ट स्टाइल दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontStyles(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
रिटर्न
String[][]
— रेंज में मौजूद सेल से जुड़े टेक्स्ट की दो डाइमेंशन वाला अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeight()
रेंज के सबसे ऊपर बाएं कोने में, सेल की फ़ॉन्ट की मोटाई (सामान्य/बोल्ड) दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontWeight());
रिटर्न
String
— सेल में मौजूद टेक्स्ट के फ़ॉन्ट की मोटाई.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeights()
रेंज में मौजूद सेल के फ़ॉन्ट की मोटाई दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontWeights(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
रिटर्न
String[][]
— रेंज में मौजूद सेल से जुड़े टेक्स्ट के फ़ॉन्ट के महत्व का दो-डाइमेंशन वाला अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
रेंज में सबसे ऊपर बाईं ओर मौजूद सेल के लिए फ़ॉर्मूला (A1 नोटेशन) दिखाता है. अगर सेल खाली है या उसमें कोई फ़ॉर्मूला नहीं है, तो खाली स्ट्रिंग दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This assumes you have a function in B5 that sums up // B2:B4 var range = sheet.getRange("B5"); // Logs the calculated value and the formula Logger.log("Calculated value: %s Formula: %s", range.getValue(), range.getFormula());
रिटर्न
String
— सेल के लिए फ़ॉर्मूला.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulaR1C1()
किसी सेल के लिए फ़ॉर्मूला (R1C1 नोटेशन) दिखाता है और अगर कोई नहीं है, तो null
दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5"); var formula = range.getFormulaR1C1(); Logger.log(formula);
रिटर्न
String
— R1C1 संकेतन में फ़ॉर्मूला.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulas()
रेंज में मौजूद सेल के लिए फ़ॉर्मूला (A1 नोटेशन) दिखाता है. 2D अरे में एंट्री बिना फ़ॉर्मूला वाली सेल के लिए खाली स्ट्रिंग होती हैं.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formulas = range.getFormulas(); for (var i in formulas) { for (var j in formulas[i]) { Logger.log(formulas[i][j]); } }
रिटर्न
String[][]
— स्ट्रिंग फ़ॉर्मैट में फ़ॉर्मूले की दो डाइमेंशन वाली अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulasR1C1()
रेंज में मौजूद सेल के लिए फ़ॉर्मूला (R1C1 नोटेशन) दिखाता है. 2D अरे में, बिना फ़ॉर्मूला वाली सेल के लिए
null
एंट्री हैं.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formulas = range.getFormulasR1C1(); for (var i in formulas) { for (var j in formulas[i]) { Logger.log(formulas[i][j]); } }
रिटर्न
String[][]
— R1C1 संकेतन में फ़ॉर्मूला की दो डाइमेंशन वाली अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getGridId()
रेंज की पैरंट शीट का ग्रिड आईडी दिखाता है. आईडी रैंडम गैर-ऋणात्मक पूर्णांक मान होते हैं.
// Log the grid ID of the first sheet (by tab position) in the spreadsheet. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getGridId());
रिटर्न
Integer
— पैरंट शीट का ग्रिड आईडी.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
रेंज की ऊंचाई दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // logs 3.0 Logger.log(range.getHeight());
रिटर्न
Integer
— रेंज की ऊंचाई.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignment()
रेंज के ऊपर बाएं कोने में सेल के टेक्स्ट (बाएं/सेंटर/दाएं) का हॉरिज़ॉन्टल अलाइनमेंट देता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getHorizontalAlignment());
रिटर्न
String
— सेल में टेक्स्ट का हॉरिज़ॉन्टल अलाइनमेंट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignments()
रेंज में सेल के हॉरिज़ॉन्टल अलाइनमेंट दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getHorizontalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
रिटर्न
String[][]
— रेंज में मौजूद सेल से जुड़े टेक्स्ट के हॉरिज़ॉन्टल अलाइनमेंट का दो डाइमेंशन वाला अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
कॉलम की आखिरी जगह दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastColumn());
रिटर्न
Integer
— स्प्रेडशीट में, रेंज के आखिरी कॉलम की जगह.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
आखिरी पंक्ति की जगह दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastRow());
रिटर्न
Integer
— स्प्रेडशीट में रेंज की आखिरी पंक्ति की जगह.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMergedRanges()
मर्ज किए गए उन सेल को दिखाने वाले Range
ऑब्जेक्ट का अरे दिखाता है जो या तो मौजूदा रेंज में पूरी तरह से हैं या जिनमें मौजूदा रेंज में कम से कम एक सेल है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B3"); var mergedRanges = range.getMergedRanges(); for (var i = 0; i < mergedRanges.length; i++) { Logger.log(mergedRanges[i].getA1Notation()); Logger.log(mergedRanges[i].getDisplayValue()); }
रिटर्न
Range[]
— Range
ऑब्जेक्ट की कैटगरी, जो रेंज को ओवरलैप करने वाली मर्ज की गई सेल दिखाती है.
getNextDataCell(direction)
रेंज के पहले कॉलम और पंक्ति के सेल से शुरू करने पर, दी गई दिशा में अगला सेल वापस भेजता है. यह दी गई दिशा में, सेल की उस रेंज का कोना होता है जिसमें डेटा मौजूद होता है या फिर स्प्रेडशीट के किनारे वाले सेल का किनारा. यह एडिटर में
Ctrl+[arrow key]
टाइप करने के बराबर है.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("C3:E5"); // Logs "C1" Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
direction | Direction | वह दिशा जिसमें अगले डेटा क्षेत्र के किनारे वाले सेल को खोजना है. |
रिटर्न
Range
— डेटा क्षेत्र की किनारे वाली सेल या स्प्रेडशीट के किनारे पर मौजूद सेल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNote()
दी गई रेंज से जुड़ा नोट दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getNote());
रिटर्न
String
— किसी सेल से जुड़ा नोट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNotes()
रेंज में मौजूद सेल से जुड़े नोट दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getNotes(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
रिटर्न
String[][]
— रेंज में मौजूद सेल से जुड़े नोट की दो डाइमेंशन वाली अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumColumns()
इस रेंज में कॉलम की संख्या दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumColumns());
रिटर्न
Integer
— इस रेंज में कॉलम की संख्या.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumRows()
इस रेंज में पंक्तियों की संख्या दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumRows());
रिटर्न
Integer
— इस रेंज में पंक्तियों की संख्या.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormat()
दी गई रेंज में सबसे ऊपर बाईं ओर मौजूद सेल की संख्या या तारीख का फ़ॉर्मैट पाएं. दिखाए गए फ़ॉर्मैट के पैटर्न के बारे में Sheets API दस्तावेज़ में बताया गया है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("C4"); Logger.log(cell.getNumberFormat());
रिटर्न
String
— रेंज के सबसे ऊपर बाईं ओर मौजूद संख्या का फ़ॉर्मैट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormats()
रेंज में मौजूद सेल के लिए संख्या या तारीख के फ़ॉर्मैट दिखाता है. दिखाए गए फ़ॉर्मैट पैटर्न के बारे में Sheets API दस्तावेज़ में बताया गया है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formats = range.getNumberFormats(); for (var i in formats) { for (var j in formats[i]) { Logger.log(formats[i][j]); } }
रिटर्न
String[][]
— संख्या के फ़ॉर्मैट की दो डाइमेंशन वाली अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValue()
रेंज के सबसे ऊपर बाईं ओर मौजूद सेल के लिए रिच टेक्स्ट दिखाता है. अगर सेल की वैल्यू टेक्स्ट नहीं है, तो null
दिखाता है.
// Gets the Rich Text value of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var richText = range.getRichTextValue(); console.log(richText.getText());
रिटर्न
RichTextValue
— रेंज में सबसे ऊपर बाईं ओर मौजूद सेल का रिच टेक्स्ट मान या अगर सेल की वैल्यू
टेक्स्ट नहीं है, तो null
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValues()
रेंज में मौजूद सेल के लिए रिच टेक्स्ट की वैल्यू दिखाता है.
// Gets the Rich Text values for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var values = range.getRichTextValues(); for (var i = 0; i < values.length; i++) { for (var j = 0; j < values[i].length; j++) { console.log(values[i][j].getText()); } }
रिटर्न
RichTextValue[][]
— रिच टेक्स्ट वैल्यू की दो डाइमेंशन वाली अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRow()
इस रेंज के लिए पंक्ति की जगह दिखाता है. getRowIndex() के जैसा एक जैसा है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRow());
रिटर्न
Integer
— रेंज की पंक्ति की जगह.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowIndex()
इस रेंज के लिए पंक्ति की जगह दिखाता है. getRow() के जैसे ही हैं.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRowIndex());
रिटर्न
Integer
— रेंज की पंक्ति की जगह.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
इन्हें भी देखें
getSheet()
वह शीट दिखाता है जिससे यह रेंज जुड़ी होती है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the sheet that the range belongs to. const rangeSheet = range.getSheet(); // Gets the sheet name and logs it to the console. console.log(rangeSheet.getName());
रिटर्न
Sheet
— वह शीट जिससे यह रेंज जुड़ी है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirection()
रेंज के सबसे ऊपर बाएं सेल के लिए, टेक्स्ट की दिशा दिखाता है. अगर अपने-आप पहचान की सुविधा से सेल के टेक्स्ट की दिशा तय की जाती है, तो null
दिखाता है.
// Get the text direction of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getTextDirection());
रिटर्न
TextDirection
— रेंज में सबसे ऊपर बाईं ओर मौजूद सेल की टेक्स्ट की दिशा.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirections()
रेंज में मौजूद सेल के लिए टेक्स्ट के निर्देश दिखाता है. अपने-आप पहचान करने वाली सुविधा का इस्तेमाल करने वाली सेल के लिए, 2D कलेक्शन में null
एंट्री मौजूद हैं.
// Get the text directions for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var directions = range.getTextDirections(); for (var i = 0; i < directions.length; i++) { for (var j = 0; j < directions[i].length; j++) { Logger.log(directions[i][j]); } }
रिटर्न
TextDirection[][]
— टेक्स्ट के निर्देशों का दो-डाइमेंशन वाला अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotation()
रेंज के सबसे ऊपर बाईं ओर मौजूद सेल के लिए, टेक्स्ट घुमाने की सेटिंग दिखाता है.
// Log the text rotation settings for a cell. var sheet = SpreadsheetApp.getActiveSheet(); var cell = sheet.getRange("A1"); Logger.log(cell.getTextRotation());
रिटर्न
TextRotation
— टेक्स्ट रोटेशन सेटिंग.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotations()
इस रेंज में मौजूद सेल के लिए टेक्स्ट रोटेशन सेटिंग दिखाता है.
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); var results = range.getTextRotations(); for (var i in results) { for (var j in results[i]) { var rotation = results[i][j]; Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation); } }
रिटर्न
TextRotation[][]
— टेक्स्ट रोटेशन का दो-डाइमेंशन वाला अरे, जो रेंज में मौजूद सेल से जुड़ा होता है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyle()
रेंज के सबसे ऊपर बाएं सेल के लिए, टेक्स्ट की स्टाइल दिखाता है.
// Get the text style of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var style = range.getTextStyle(); Logger.log(style);
रिटर्न
TextStyle
— रेंज में सबसे ऊपर बाईं ओर मौजूद सेल का टेक्स्ट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyles()
रेंज में मौजूद सेल की टेक्स्ट स्टाइल दिखाता है.
// Get the text styles for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var styles = range.getTextStyles(); for (var i = 0; i < styles.length; i++) { for (var j = 0; j < styles[i].length; j++) { Logger.log(styles[i][j]); } }
रिटर्न
TextStyle[][]
— टेक्स्ट स्टाइल का दो डाइमेंशन वाला कलेक्शन.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValue()
रेंज में सबसे ऊपर बाईं ओर मौजूद सेल की वैल्यू दिखाता है. सेल की वैल्यू के आधार पर वैल्यू का टाइप Number
, Boolean
, Date
या String
हो सकता है. खाली सेल
एक खाली स्ट्रिंग दिखाते हैं.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the value of the top-left cell in the range and logs it to the console. console.log(range.getValue());
रिटर्न
Object
— इस सेल में मौजूद वैल्यू.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValues()
इस रेंज के लिए वैल्यू की रेक्टैंगल ग्रिड दिखाता है.
वैल्यू की दो-डाइमेंशन वाला अरे दिखाता है. इसे पहले पंक्ति और फिर कॉलम के हिसाब से इंडेक्स किया जाता है. सेल की वैल्यू के मुताबिक वैल्यू, Number
, Boolean
, Date
या String
के हो सकती हैं. खाली सेल को अरे में खाली स्ट्रिंग से दिखाया जाता है. याद रखें कि
रेंज इंडेक्स 1, 1
से शुरू होता है, लेकिन JavaScript के कलेक्शन को [0][0]
से इंडेक्स किया जाता है.
// The code below gets the values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues(); Logger.log(values[0][0]);वेब ऐप्लिकेशन में,
Date
की वैल्यू एक कानूनी पैरामीटर नहीं होता है. अगर रेंज में Date
वैल्यू वाला सेल है, तो getValues()
, वेब ऐप्लिकेशन को डेटा नहीं दिखाता है. इसके बजाय, शीट से वापस मिली सभी वैल्यू को Number
, Boolean
या String
जैसे काम करने वाले JavaScript प्रीमिटिव में बदलें.रिटर्न
Object[][]
— वैल्यू की दो डाइमेंशन वाली अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignment()
रेंज के सबसे ऊपर बाएं कोने में सेल का वर्टिकल अलाइनमेंट (ऊपर/बीच/नीचे) दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getVerticalAlignment());
रिटर्न
String
— सेल में टेक्स्ट का वर्टिकल अलाइनमेंट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignments()
रेंज में सेल के वर्टिकल अलाइनमेंट दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
रिटर्न
String[][]
— रेंज में मौजूद सेल से जुड़े टेक्स्ट के वर्टिकल अलाइनमेंट का दो डाइमेंशन वाला अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
कॉलम में रेंज की चौड़ाई दिखाता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the width of the range in number of columns and logs it to the console. console.log(range.getWidth());
रिटर्न
Integer
— रेंज में कॉलम की संख्या.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrap()
यह फ़ंक्शन दिखाता है कि सेल का टेक्स्ट रैप होता है या नहीं. रैप करने की बेहतर रणनीति पाने के लिए, getWrapStrategy()
का इस्तेमाल करें.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getWrap());
रिटर्न
Boolean
— इस सेल में टेक्स्ट रैप होता है या नहीं.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategies()
रेंज में मौजूद सेल के लिए, टेक्स्ट रैपिंग की रणनीतियां दिखाता है.
// Get the text wrapping strategies for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var strategies = range.getWrapStrategies(); for (var i = 0; i < strategies.length; i++) { for (var j = 0; j < strategies[i].length; j++) { Logger.log(strategies[i][j]); } }
रिटर्न
WrapStrategy[][]
— टेक्स्ट रैपिंग की रणनीतियों का दो डाइमेंशन वाला कलेक्शन.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategy()
रेंज के सबसे ऊपर बाएं सेल के लिए, टेक्स्ट रैपिंग की रणनीति दिखाता है.
// Get the text wrapping strategy of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getWrapStrategy());
रिटर्न
WrapStrategy
— रेंज में सबसे ऊपर बाईं ओर मौजूद सेल की टेक्स्ट रैपिंग की रणनीति.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWraps()
यह फ़ंक्शन दिखाता है कि सेल का टेक्स्ट रैप किया गया है या नहीं. रैप करने की बेहतर रणनीति पाने के लिए, getWrapStrategies()
का इस्तेमाल करें.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { var isWrapped = results[i][j]; if (isWrapped) { Logger.log("Cell [%s, %s] has wrapped text", i, j); } } }
रिटर्न
Boolean[][]
— रेंज में मौजूद सेल से जुड़े टेक्स्ट के वर्टिकल अलाइनमेंट का दो डाइमेंशन वाला अरे.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCells(shiftDimension)
इस रेंज में खाली सेल शामिल करता है. नए सेल, उन सेल में मौजूद सभी फ़ॉर्मैटिंग को बनाए रखते हैं जो पहले इस रेंज में शामिल थीं. दिए गए डाइमेंशन के साथ शीट में मौजूद डेटा को, शामिल की गई रेंज से दूर शिफ़्ट कर दिया जाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.insertCells(SpreadsheetApp.Dimension.COLUMNS);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
shiftDimension | Dimension | वह डाइमेंशन जिसके साथ मौजूदा डेटा को शिफ़्ट करना है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes()
रेंज की हर सेल में चेकबॉक्स डालता है. चेकबॉक्स पर सही का निशान लगाने के लिए true
के साथ और सही का निशान हटाने के लिए false
को कॉन्फ़िगर किया जाता है. रेंज में सभी सेल की वैल्यू को false
पर सेट करता है.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked // and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'. range.insertCheckboxes();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue)
चुनी गई कस्टम वैल्यू के साथ कॉन्फ़िगर किए गए रेंज की हर सेल में चेकबॉक्स डालता है और सही का निशान हटाने के लिए खाली स्ट्रिंग देता है. रेंज में हर सेल की वैल्यू को खाली स्ट्रिंग पर सेट करता है.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked // and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to // the empty string. range.insertCheckboxes('yes');
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
checkedValue | Object | चेकबॉक्स डेटा की पुष्टि के लिए चुना गया मान. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue, uncheckedValue)
चुनी गई और नहीं चुनी गई स्थितियों के लिए कस्टम मानों के साथ कॉन्फ़िगर किए गए, श्रेणी की हर सेल में चेकबॉक्स डालता है. यह फ़ंक्शन, रेंज में हर सेल की वैल्यू को पसंद के मुताबिक नहीं चुनी गई वैल्यू पर सेट करता है.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked // and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'. range.insertCheckboxes('yes', 'no');
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
checkedValue | Object | चेकबॉक्स डेटा की पुष्टि के लिए चुना गया मान. |
uncheckedValue | Object | चेकबॉक्स डेटा की पुष्टि के लिए सही का निशान हटाया गया मान. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isBlank()
रेंज पूरी तरह खाली होने पर true
दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.isBlank());
रिटर्न
अगर रेंज खाली है, तो Boolean
— true
. अगर ऐसा नहीं है, तो false
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isChecked()
यह दिखाता है कि रेंज में मौजूद सभी सेल की चेकबॉक्स स्थिति 'चुनी गई' के तौर पर है या नहीं. अगर कुछ सेल पर सही का निशान लगाया गया है और बाकी सेल से सही का निशान हटाया गया है, तो null
दिखाता है. ऐसा तब भी होता है, जब कुछ सेल में चेकबॉक्स वाले डेटा की पुष्टि नहीं की जाती.
var range = SpreadsheetApp.getActive().getRange('A1:A3'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:A3. range.insertCheckboxes('yes', 'no'); var range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Sets the value of isRange1Checked as true as it contains the checked value. var isRange1Checked = range1.isChecked(); var range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('no'); // Sets the value of isRange2Checked as false as it contains the unchecked value. var isRange2Checked = range2.isChecked(); var range3 = SpreadsheetApp.getActive().getRange('A3'); range3.setValue('random'); // Sets the value of isRange3Checked as null, as it contains an invalid checkbox value. var isRange3Checked = range3.isChecked();
रिटर्न
Boolean
— true
, अगर रेंज में मौजूद सभी सेल पर सही का निशान लगाया गया है, तो false
अगर रेंज में मौजूद सभी सेल से सही का निशान हटाया गया है. इसके अलावा, अगर किसी सेल से सही का निशान हटाया गया है या उसमें चेकबॉक्स वाले डेटा की पुष्टि नहीं की गई है, तो null
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndColumnBounded()
यह तय करता है कि रेंज का अंत किसी खास कॉलम से जुड़ा है या नहीं. उदाहरण के लिए, अगर A1:B10
या B:B
रेंज, रेंज के आखिर में मौजूद कॉलम से जुड़ी हैं, तो यह तरीका true
दिखाता है. हालांकि, 3:7
या A1:5
रेंज के लिए, जो रेंज के आखिर में सिर्फ़ कुछ खास लाइनों से जुड़ी होती हैं, यह तरीका false
के नतीजे देता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular column and logs it to the // console. console.log(range.isEndColumnBounded());
रिटर्न
Boolean
— true
, अगर रेंज के खत्म होने का समय किसी खास कॉलम से जुड़ा हो; ऐसा नहीं होने पर, false
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndRowBounded()
यह तय करता है कि रेंज का अंत किसी खास पंक्ति से जुड़ा है या नहीं. उदाहरण के लिए, रेंज A1:B10
या 3:7
के लिए, जो रेंज के आखिर में पंक्तियों से जुड़ी होती हैं, यह तरीका true
दिखाता है. हालांकि, B:B
या A1:C
रेंज के लिए, जो रेंज के आखिर में सिर्फ़ कुछ खास कॉलम से जुड़ी होती हैं, यह तरीका false
के नतीजे देता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular row and logs it to the console. console.log(range.isEndRowBounded());
रिटर्न
Boolean
— true
, अगर रेंज के खत्म होने का समय किसी खास पंक्ति से जुड़ा हो; नहीं तो false
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isPartOfMerge()
अगर मौजूदा रेंज में मौजूद सेल, मर्ज की गई किसी सेल को ओवरलैप करते हैं, तो यह नतीजा true
दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B3"); // True if any of the cells in A1:B3 is included in a merge. var isPartOfMerge = range.isPartOfMerge();
रिटर्न
Boolean
— true
अगर रेंज किसी मर्ज की गई सेल को ओवरलैप करती है, नहीं तो false
दिखाता है.
isStartColumnBounded()
यह तय करता है कि रेंज की शुरुआत किसी खास कॉलम से जुड़ी है या नहीं. उदाहरण के लिए, रेंज A1:B10
या B:B
के लिए, जो रेंज की शुरुआत में कॉलम से जुड़ी हैं, यह तरीका true
दिखाता है. 3:7
रेंज के लिए, जो रेंज की शुरुआत से सिर्फ़ एक पंक्ति तक ही सीमित है, यह तरीका false
के बारे में बताता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular column and logs it to the // console. console.log(range.isStartColumnBounded());
रिटर्न
Boolean
— true
, अगर रेंज की शुरुआत किसी खास कॉलम से जुड़ी हो; नहीं तो false
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isStartRowBounded()
यह तय करता है कि रेंज की शुरुआत किसी खास पंक्ति से जुड़ी है या नहीं. उदाहरण के लिए, रेंज A1:B10
या 3:7
के लिए, जो रेंज की शुरुआत में पंक्तियों से जुड़ी होती हैं, यह तरीका true
दिखाता है. हालांकि, रेंज B:B
के लिए, जो रेंज की शुरुआत में सिर्फ़ किसी खास कॉलम से जुड़ी होती है, यह तरीका false
के बारे में बताता है.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular row and logs it to the // console. console.log(range.isStartRowBounded());
रिटर्न
Boolean
— true
, अगर रेंज की शुरुआत किसी खास पंक्ति से जुड़ी हो. ऐसा नहीं होने पर, false
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
merge()
रेंज में मौजूद सेल को एक साथ एक ब्लॉक में मर्ज करता है.
var sheet = SpreadsheetApp.getActiveSheet(); // The code below 2-dimensionally merges the cells in A1 to B3 sheet.getRange('A1:B3').merge();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeAcross()
रेंज के सभी कॉलम की रेंज में मौजूद सेल मर्ज करें.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The code below merges cells C5:E5 into one cell var range1 = sheet.getRange("C5:E5"); range1.mergeAcross(); // The code below creates 2 horizontal cells, F5:H5 and F6:H6 var range2 = sheet.getRange("F5:H6"); range2.mergeAcross();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeVertically()
रेंज में मौजूद सेल को मर्ज करता है.
var sheet = SpreadsheetApp.getActiveSheet(); // The code below vertically merges the cells in A1 to A10 sheet.getRange('A1:A10').mergeVertically(); // The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10 sheet.getRange('B1:D10').mergeVertically();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveTo(target)
इस रेंज से टारगेट रेंज में काटें और चिपकाएं (फ़ॉर्मैट और वैल्यू दोनों).
// The code below moves the first 5 columns over to the 6th column var sheet = SpreadsheetApp.getActiveSheet() sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
target | Range | वह टारगेट रेंज जिसमें इस रेंज को कॉपी करना है. इसके लिए, सिर्फ़ सबसे ऊपर बाईं ओर मौजूद सेल की जगह काम की होती है. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
offset(rowOffset, columnOffset)
ऐसी नई रेंज लौटाता है जो इस रेंज से पंक्तियों और कॉलम की दी गई संख्या से ऑफ़सेट होती है (जो नेगेटिव हो सकती है). नई रेंज का साइज़, ओरिजनल रेंज के साइज़ के जैसा ही है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2 var newCell = cell.offset(1, 1);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
rowOffset | Integer | रेंज के सबसे ऊपर बाएं सेल से नीचे की पंक्तियों की संख्या; नेगेटिव वैल्यू, रेंज के सबसे ऊपर बाएं सेल से ऊपर की पंक्तियां दिखाती हैं. |
columnOffset | Integer | नेगेटिव वैल्यू, रेंज के सबसे ऊपर बाईं सेल से दाईं ओर मौजूद कॉलम की संख्या. नेगेटिव वैल्यू, रेंज के सबसे ऊपर बाईं ओर मौजूद सेल से, बाईं ओर मौजूद कॉलम दिखाती हैं. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
offset(rowOffset, columnOffset, numRows)
मौजूदा रेंज से मिलती-जुलती नई रेंज दिखाता है. इस रेंज का ऊपरी बायां बिंदु, दी गई पंक्तियों और कॉलम के हिसाब से मौजूदा रेंज से ऑफ़सेट होता है. साथ ही, सेल में दी गई ऊंचाई भी दिखाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2:B3 var newRange = cell.offset(1, 1, 2);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
rowOffset | Integer | रेंज के सबसे ऊपर बाएं सेल से नीचे की पंक्तियों की संख्या; नेगेटिव वैल्यू, रेंज के सबसे ऊपर बाएं सेल से ऊपर की पंक्तियां दिखाती हैं. |
columnOffset | Integer | नेगेटिव वैल्यू, रेंज के सबसे ऊपर बाईं सेल से दाईं ओर मौजूद कॉलम की संख्या. नेगेटिव वैल्यू, रेंज के सबसे ऊपर बाईं ओर मौजूद सेल से, बाईं ओर मौजूद कॉलम दिखाती हैं. |
numRows | Integer | नई रेंज की पंक्तियों में ऊंचाई. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
offset(rowOffset, columnOffset, numRows, numColumns)
मौजूदा रेंज से मिलती-जुलती नई रेंज दिखाता है. इस रेंज का ऊपरी बायां बिंदु, दी गई पंक्तियों और कॉलम के हिसाब से मौजूदा रेंज से ऑफ़सेट होता है. साथ ही, सेल में दी गई ऊंचाई और चौड़ाई से ऑफ़सेट होता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2:C3 var newRange = cell.offset(1, 1, 2, 2);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
rowOffset | Integer | रेंज के सबसे ऊपर बाएं सेल से नीचे की पंक्तियों की संख्या; नेगेटिव वैल्यू, रेंज के सबसे ऊपर बाएं सेल से ऊपर की पंक्तियां दिखाती हैं. |
columnOffset | Integer | नेगेटिव वैल्यू, रेंज के सबसे ऊपर बाईं सेल से दाईं ओर मौजूद कॉलम की संख्या. नेगेटिव वैल्यू, रेंज के सबसे ऊपर बाईं ओर मौजूद सेल से, बाईं ओर मौजूद कॉलम दिखाती हैं. |
numRows | Integer | नई रेंज की पंक्तियों में ऊंचाई. |
numColumns | Integer | नई रेंज के कॉलम में मौजूद चौड़ाई. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
protect()
एक ऐसा ऑब्जेक्ट बनाता है जो रेंज में बदलाव किए जाने से बचा सकता है. हालांकि, इसमें अनुमति वाले उपयोगकर्ताओं को शामिल नहीं किया जाता. जब तक स्क्रिप्ट, रेंज के लिए एडिटर की सूची नहीं बदलती, तब तक (Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
को कॉल करके या Protection.setDomainEdit(editable)
के लिए कोई नई वैल्यू सेट करके), अनुमतियां स्प्रेडशीट की ही कॉपी होती हैं. इसका मतलब है कि रेंज असुरक्षित बनी रहती है. अगर रेंज पहले से सुरक्षित है, तो यह तरीका एक नई सुरक्षित रेंज बनाता है जो मौजूदा रेंज को ओवरलैप करती है. अगर किसी सेल को एक से ज़्यादा सुरक्षित रेंज से सुरक्षित किया गया है और उनमें से कोई भी एक खास उपयोगकर्ता को सेल में बदलाव करने से रोकता है, तो उस उपयोगकर्ता को सेल में बदलाव करने की अनुमति नहीं है.
// Protect range A1:B10, then remove all other users from the list of editors. var ss = SpreadsheetApp.getActive(); var range = ss.getRange('A1:B10'); var protection = range.protect().setDescription('Sample protected range'); // Ensure the current user is an editor before removing others. Otherwise, if the user's edit // permission comes from a group, the script throws an exception upon removing the group. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
रिटर्न
Protection
— यह सुरक्षा सेटिंग को दिखाने वाला ऑब्जेक्ट है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
randomize()
दी गई रेंज में पंक्तियों का ऑर्डर किसी भी क्रम में लगाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:C7"); // Randomizes the range range.randomize();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeCheckboxes()
श्रेणी से सभी चेकबॉक्स निकालता है. हर सेल के डेटा की पुष्टि करता है. साथ ही, अगर सेल में सही का निशान लगाया गया है या नहीं, तो इसका मान भी हटाता है.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); var range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Removes the checkbox data validation in cell A1 and clears its value. range1.removeCheckboxes(); var range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('random'); // Removes the checkbox data validation in cell A2 but does not clear its value. range2.removeCheckboxes();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates()
इस रेंज में मौजूद उन पंक्तियों को हटाता है जिनमें पिछली किसी भी पंक्ति की वैल्यू की डुप्लीकेट वैल्यू मौजूद हैं. एक जैसी वैल्यू वाली ऐसी लाइनें डुप्लीकेट मानी जाती हैं जिनमें अलग-अलग केस, फ़ॉर्मैटिंग या फ़ॉर्मूला होते हैं. यह तरीका, व्यू से छिपी हुई डुप्लीकेट पंक्तियां भी हटा देता है (उदाहरण के लिए, किसी फ़िल्टर की वजह से). इस रेंज से बाहर का कॉन्टेंट नहीं हटाया जाता.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B1:D7"); // Remove duplicate rows in the range. range.removeDuplicates();
रिटर्न
Range
— डुप्लीकेट हटाने के बाद मिलने वाली रेंज. हटाई गई हर पंक्ति के लिए, रेंज का साइज़ एक पंक्ति से कम कर दिया जाता है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates(columnsToCompare)
इस रेंज में से वे पंक्तियां हटाता है जिनके तय कॉलम में, पिछली किसी भी पंक्ति की वैल्यू की डुप्लीकेट वैल्यू मौजूद हैं. एक जैसी वैल्यू वाली ऐसी लाइनें डुप्लीकेट मानी जाती हैं जिनमें अलग-अलग केस, फ़ॉर्मैटिंग या फ़ॉर्मूला होते हैं. यह तरीका, व्यू से छिपी हुई डुप्लीकेट पंक्तियों को भी हटा देता है. उदाहरण के लिए, किसी फ़िल्टर की वजह से. इस रेंज से बाहर का कॉन्टेंट नहीं हटाया जाता.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B1:D7"); // Remove rows which have duplicate values in column B. range.removeDuplicates([2]); // Remove rows which have duplicate values in both columns B and D. range.removeDuplicates([2,4]);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
columnsToCompare | Integer[] | डुप्लीकेट वैल्यू का विश्लेषण करने के लिए कॉलम. अगर कोई कॉलम नहीं दिया जाता है, तो डुप्लीकेट के लिए सभी कॉलम का विश्लेषण किया जाता है. |
रिटर्न
Range
— डुप्लीकेट हटाने के बाद मिलने वाली रेंज. हटाई गई हर पंक्ति के लिए, रेंज का साइज़ एक पंक्ति से कम कर दिया जाता है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackground(color)
सीएसएस नोटेशन (जैसे '#ffffff'
या 'white'
) की रेंज में सभी सेल के बैकग्राउंड का रंग सेट करता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); range.setBackground("red");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
color | String | सीएसएस नोटेशन में कोई कलर कोड (जैसे कि '#ffffff' या 'white' ); null वैल्यू से रंग रीसेट होता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundObject(color)
रेंज में सभी सेल के लिए बैकग्राउंड का रंग सेट करता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var bgColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var range = sheet.getRange("B2:D5"); range.setBackgroundObject(bgColor);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
color | Color | सेट किया जाने वाला बैकग्राउंड का रंग; null वैल्यू से बैकग्राउंड का रंग रीसेट होता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundObjects(color)
बैकग्राउंड के रंगों का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); var colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4] ]; var cell = sheet.getRange("B5:C6"); cell.setBackgroundObjects(colors);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
color | Color[][] | रंगों की दो डाइमेंशन वाला कलेक्शन; null वैल्यू से रंग रीसेट होता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundRGB(red, green, blue)
आरजीबी वैल्यू (0 और 255 के बीच के पूर्णांक) का इस्तेमाल करके, दिए गए रंग के लिए बैकग्राउंड सेट करता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets the background to white cell.setBackgroundRGB(255, 255, 255); // Sets the background to red cell.setBackgroundRGB(255, 0, 0);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
red | Integer | आरजीबी नोटेशन में लाल रंग की वैल्यू. |
green | Integer | आरजीबी नोटेशन में हरे रंग की वैल्यू. |
blue | Integer | आरजीबी नोटेशन में नीले रंग की वैल्यू. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgrounds(color)
बैकग्राउंड के रंगों का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). रंग,
सीएसएस नोटेशन (जैसे कि '#ffffff'
या 'white'
) में हों.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colors = [ ["red", "white", "blue"], ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents ]; var cell = sheet.getRange("B5:D6"); cell.setBackgrounds(colors);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
color | String[][] | सीएसएस नोटेशन में रंगों का दो-डाइमेंशन वाला कलेक्शन (जैसे कि '#ffffff' या
'white' ); null वैल्यू से रंग रीसेट होता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal)
बॉर्डर प्रॉपर्टी सेट करता है. मान्य वैल्यू ये हैं: true
(चालू है), false
(बंद है), और null
(कोई बदलाव नहीं).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets borders on the top and bottom, but leaves the left and right unchanged cell.setBorder(true, null, true, null, false, false);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
top | Boolean | बॉर्डर के लिए true , किसी के लिए false , बिना किसी बदलाव के null . |
left | Boolean | बॉर्डर के लिए true , किसी के लिए false , बिना किसी बदलाव के null . |
bottom | Boolean | बॉर्डर के लिए true , किसी के लिए false , बिना किसी बदलाव के null . |
right | Boolean | बॉर्डर के लिए true , किसी के लिए false , बिना किसी बदलाव के null . |
vertical | Boolean | आंतरिक वर्टिकल बॉर्डर के लिए true , किसी के लिए false नहीं, बिना किसी बदलाव के null . |
horizontal | Boolean | आंतरिक हॉरिज़ॉन्टल बॉर्डर के लिए true , किसी के लिए false नहीं, किसी बदलाव के लिए null . |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal, color, style)
बॉर्डर प्रॉपर्टी को रंग और/या स्टाइल के साथ सेट करता है. मान्य वैल्यू ये हैं: true
(चालू है), false
(बंद है), और null
(कोई बदलाव नहीं). रंग के लिए, सीएसएस नोटेशन में रंग का इस्तेमाल करें (जैसे कि '#ffffff'
या 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets borders on the top and bottom, but leaves the left and right unchanged // Also sets the color to "red", and the border to "DASHED". cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
top | Boolean | बॉर्डर के लिए true , किसी के लिए false , बिना किसी बदलाव के null . |
left | Boolean | बॉर्डर के लिए true , किसी के लिए false , बिना किसी बदलाव के null . |
bottom | Boolean | बॉर्डर के लिए true , किसी के लिए false , बिना किसी बदलाव के null . |
right | Boolean | बॉर्डर के लिए true , किसी के लिए false , बिना किसी बदलाव के null . |
vertical | Boolean | आंतरिक वर्टिकल बॉर्डर के लिए true , किसी के लिए false नहीं, बिना किसी बदलाव के null . |
horizontal | Boolean | आंतरिक हॉरिज़ॉन्टल बॉर्डर के लिए true , किसी के लिए false नहीं, किसी बदलाव के लिए null . |
color | String | सीएसएस नोटेशन में एक रंग (जैसे कि '#ffffff' या 'white' ), डिफ़ॉल्ट रंग के लिए null (काला). |
style | BorderStyle | बॉर्डर के लिए स्टाइल, डिफ़ॉल्ट स्टाइल (सॉलिड) के लिए null . |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidation(rule)
रेंज में मौजूद सभी सेल के लिए, डेटा की पुष्टि करने का एक नियम सेट करता है.
// Set the data validation rule for cell A1 to require a value from B1:B10. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
rule | DataValidation | डेटा की पुष्टि करने का नियम, जिसे सेट किया जाना है या डेटा की पुष्टि हटाने के लिए null . |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidations(rules)
रेंज में मौजूद सभी सेल के लिए, डेटा की पुष्टि करने के नियम सेट करता है. इस तरीके में डेटा की पुष्टि करने के लिए, दो-डाइमेंशन वाले ऐरे को लिया जाता है, जिसे पहले पंक्ति और फिर कॉलम के हिसाब से इंडेक्स किया जाता है. अरे डाइमेंशन, रेंज डाइमेंशन के मुताबिक होने चाहिए.
// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10. var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5'); var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build(); var rules = destinationRange.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { rules[i][j] = rule; } } destinationRange.setDataValidations(rules);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
rules | DataValidation[][] | डेटा पुष्टि के नियमों का दो डाइमेंशन वाला कलेक्शन, जिसे सेट किया जाना है. null वैल्यू,
डेटा की पुष्टि को हटा देती हैं. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColor(color)
सीएसएस नोटेशन (जैसे '#ffffff'
या 'white'
) में फ़ॉन्ट का रंग सेट करता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontColor("red");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
color | String | सीएसएस नोटेशन में फ़ॉन्ट का रंग (जैसे कि '#ffffff' या 'white' ); null वैल्यू से रंग रीसेट हो जाता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObject(color)
दी गई रेंज के लिए फ़ॉन्ट का कलर सेट करता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var cell = sheet.getRange("B2"); cell.setFontColor(color);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
color | Color | फ़ॉन्ट का रंग सेट किया जाना है; null वैल्यू से रंग रीसेट होता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObjects(colors)
फ़ॉन्ट के रंगों का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); var colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4] ]; var cell = sheet.getRange("B5:C6"); cell.setFontColorObjects(colors);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
colors | Color[][] | रंगों की दो डाइमेंशन वाला अरे; null वैल्यू से फ़ॉन्ट का रंग रीसेट होता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColors(colors)
फ़ॉन्ट के रंगों का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). रंग, सीएसएस नोटेशन (जैसे कि '#ffffff'
या 'white'
) में हैं.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colors = [ ["red", "white", "blue"], ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents ]; var cell = sheet.getRange("B5:D6"); cell.setFontColors(colors);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
colors | Object[][] | सीएसएस नोटेशन में रंगों का दो-डाइमेंशन वाला कलेक्शन (जैसे कि '#ffffff' या
'white' ); null वैल्यू से रंग रीसेट होता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamilies(fontFamilies)
फ़ॉन्ट फ़ैमिली की आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). फ़ॉन्ट फ़ैमिली के उदाहरण के तौर पर " बैकअप" या " चरण" में से एक है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var fonts = [ ["Arial", "Helvetica", "Verdana"], ["Courier New", "Arial", "Helvetica] ]; var cell = sheet.getRange("B2:D3"); cell.setFontFamilies(fonts);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
fontFamilies | Object[][] | फ़ॉन्ट फ़ैमिली का दो डाइमेंशन वाला कलेक्शन; null वैल्यू से
फ़ॉन्ट फ़ैमिली को रीसेट किया जाता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamily(fontFamily)
फ़ॉन्ट फ़ैमिली सेट करता है, जैसे कि "">ऐरियल" या ""हेल्थ".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontFamily("Helvetica");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
fontFamily | String | सेट की जाने वाली फ़ॉन्ट फ़ैमिली; null वैल्यू, फ़ॉन्ट फ़ैमिली को रीसेट करती है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLine(fontLine)
दी गई रेंज ('underline'
, 'line-through'
, या
'none'
) की फ़ॉन्ट लाइन का स्टाइल सेट करता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontLine("line-through");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
fontLine | String | फ़ॉन्ट लाइन की स्टाइल, 'underline' , 'line-through' या
'none' ; null वैल्यू से फ़ॉन्ट लाइन का स्टाइल रीसेट होता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLines(fontLines)
लाइन स्टाइल का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontLines = [ ["underline", "line-through", "none"] ]; var range = sheet.getRange("B2:D2"); range.setFontLines(fontLines);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
fontLines | Object[][] | फ़ॉन्ट लाइन स्टाइल ('underline' , 'line-through' या 'none' ) का दो डाइमेंशन वाला कलेक्शन. null वैल्यू, फ़ॉन्ट लाइन की स्टाइल को रीसेट करती हैं. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSize(size)
फ़ॉन्ट का साइज़ सेट करता है. इसमें इस्तेमाल के लिए पॉइंट साइज़ शामिल होता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontSize(20);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
size | Integer | पॉइंट साइज़ में फ़ॉन्ट का साइज़. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSizes(sizes)
फ़ॉन्ट साइज़ का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). साइज़, पॉइंट के हिसाब से होते हैं.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontSizes = [ [16, 20, 24] ]; var range = sheet.getRange("B2:D2"); range.setFontSizes(fontSizes);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
sizes | Object[][] | साइज़ का दो-डाइमेंशन वाला अरे. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyle(fontStyle)
दी गई रेंज ('italic'
या 'normal'
) के लिए फ़ॉन्ट स्टाइल सेट करें.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontStyle("italic");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
fontStyle | String | फ़ॉन्ट स्टाइल, 'italic' या 'normal' ; null
वैल्यू, फ़ॉन्ट स्टाइल को रीसेट करती है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyles(fontStyles)
फ़ॉन्ट स्टाइल का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontStyles = [ ["italic", "normal"] ]; var range = sheet.getRange("B2:C2"); range.setFontStyles(fontStyles);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
fontStyles | Object[][] | 'italic' या 'normal' वाली फ़ॉन्ट स्टाइल का दो-डाइमेंशन वाला कलेक्शन, null वैल्यू से फ़ॉन्ट स्टाइल रीसेट होती है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeight(fontWeight)
दी गई रेंज के लिए फ़ॉन्ट की मोटाई सेट करें (नॉर्मल/बोल्ड).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontWeight("bold");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
fontWeight | String | फ़ॉन्ट की मोटाई 'bold' या 'normal' हो; null
वैल्यू से फ़ॉन्ट की मोटाई रीसेट हो जाती है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeights(fontWeights)
फ़ॉन्ट की मोटाई का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). फ़ॉन्ट की मोटाई का एक उदाहरण "बोल्ड" है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontStyles = [ [ "bold", "bold", "normal" ] ]; var range = sheet.getRange("B2:D2"); range.setFontWeights(fontStyles);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
fontWeights | Object[][] | फ़ॉन्ट की मोटाई का दो-डाइमेंशन वाला अरे, या तो 'bold' या 'normal' ; null वैल्यू से फ़ॉन्ट की मोटाई रीसेट होती है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
इस रेंज के लिए फ़ॉर्मूला अपडेट करता है. दिया गया फ़ॉर्मूला A1 नोटेशन में होना चाहिए.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); cell.setFormula("=SUM(B3:B4)");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
formula | String | सेल के लिए सेट किए जाने वाले फ़ॉर्मूला को दिखाने वाली स्ट्रिंग. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulaR1C1(formula)
इस रेंज के लिए फ़ॉर्मूला अपडेट करता है. दिया गया फ़ॉर्मूला R1C1 नोटेशन में होना चाहिए.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); // This sets the formula to be the sum of the 3 rows above B5 cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
formula | String | स्ट्रिंग फ़ॉर्मूला. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulas(formulas)
फ़ॉर्मूला की आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). दिए गए फ़ॉर्मूले A1 नोटेशन में होने चाहिए. इस तरीके में, फ़ॉर्मूले की दो-डाइमेंशन वाली सूची को पहले पंक्ति के हिसाब से इंडेक्स किया जाता है और फिर कॉलम के हिसाब से इंडेक्स किया जाता है. अरे डाइमेंशन, रेंज डाइमेंशन के मुताबिक होने चाहिए.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This sets the formulas to be a row of sums, followed by a row of averages right below. // The size of the two-dimensional array must match the size of the range. var formulas = [ ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"], ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"] ]; var cell = sheet.getRange("B5:D6"); cell.setFormulas(formulas);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
formulas | String[][] | फ़ॉर्मूला की दो डाइमेंशन वाली स्ट्रिंग अरे. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulasR1C1(formulas)
फ़ॉर्मूला की आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). दिए गए फ़ॉर्मूले R1C1 नोटेशन में होने चाहिए.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates formulas for a row of sums, followed by a row of averages. var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])"; var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])"; // The size of the two-dimensional array must match the size of the range. var formulas = [ [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove], [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove] ]; var cell = sheet.getRange("B5:D6"); // This sets the formula to be the sum of the 3 rows above B5. cell.setFormulasR1C1(formulas);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
formulas | String[][] | R1C1 फ़ॉर्मैट में, फ़ॉर्मूला की दो डाइमेंशन वाली अरे. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignment(alignment)
दी गई रेंज के लिए, हॉरिज़ॉन्टल (बाएं से दाएं) अलाइनमेंट सेट करें (बाएं/सेंटर/दाएं).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setHorizontalAlignment("center");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
alignment | String | अलाइनमेंट, 'left' , 'center' या 'normal' ; किसी null वैल्यू से अलाइनमेंट रीसेट हो जाता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignments(alignments)
हॉरिज़ॉन्टल अलाइनमेंट का रेक्टैंगल ग्रिड सेट करता है. setHorizontalAlignment(alignment)
देखें
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var horizontalAlignments = [ [ "left", "right", "center" ] ]; var range = sheet.getRange("B2:D2"); range.setHorizontalAlignments(horizontalAlignments);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
alignments | Object[][] | अलाइनमेंट का दो डाइमेंशन वाला अरे, जिसमें 'left' , 'center' या 'normal' शामिल है. null वैल्यू, अलाइनमेंट को रीसेट करती है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
इन्हें भी देखें
setNote(note)
नोट को दिए गए मान पर सेट करता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setNote("This is a note");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
note | String | रेंज के लिए सेट की जाने वाली नोट वैल्यू; null वैल्यू डालने पर नोट हट जाता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNotes(notes)
नोट का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var notes = [ ["it goes", "like this", "the fourth, the fifth"], ["the minor fall", "and the", "major lift"] ]; var cell = sheet.getRange("B2:D3"); cell.setNotes(notes)
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
notes | Object[][] | नोट का दो डाइमेंशन वाला कलेक्शन; null वैल्यू से नोट हट जाता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
इन्हें भी देखें
setNumberFormat(numberFormat)
दी गई फ़ॉर्मैटिंग स्ट्रिंग पर संख्या या तारीख के फ़ॉर्मैट को सेट करता है. स्वीकार किए जाने वाले फ़ॉर्मैट पैटर्न के बारे में Sheets API दस्तावेज़ में बताया गया है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Always show 3 decimal points cell.setNumberFormat("0.000");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
numberFormat | String | संख्या के फ़ॉर्मैट वाली स्ट्रिंग. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNumberFormats(numberFormats)
संख्या या तारीख फ़ॉर्मैट का आयताकार ग्रिड सेट करता है (इस सीमा के डाइमेंशन से मेल खाना चाहिए). ये वैल्यू, फ़ॉर्मैट पैटर्न स्ट्रिंग हैं, जैसा कि Sheets API दस्तावेज़ में बताया गया है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var formats = [ [ "0.000", "0,000,000", "$0.00" ] ]; var range = sheet.getRange("B2:D2"); range.setNumberFormats(formats);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
numberFormats | Object[][] | संख्या फ़ॉर्मैट की दो डाइमेंशन वाली अरे. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRichTextValue(value)
रेंज में मौजूद सेल के लिए रिच टेक्स्ट की वैल्यू सेट करता है.
// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var richText = SpreadsheetApp.newRichTextValue() .setText("Hello world") .setTextStyle(0, 5, bold) .build(); range.setRichTextValue(richText);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
value | RichTextValue | पसंदीदा रिच टेक्स्ट वैल्यू. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRichTextValues(values)
रिच टेक्स्ट वैल्यू का रेक्टैंगल ग्रिड सेट करता है.
// Sets the cells in range A1:A2 to have Rich Text values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:A2"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var italic = SpreadsheetApp.newTextStyle() .setItalic(true) .build(); var richTextA1 = SpreadsheetApp.newRichTextValue() .setText("This cell is bold") .setTextStyle(bold) .build(); var richTextA2 = SpreadsheetApp.newRichTextValue() .setText("bold words, italic words") .setTextStyle(0, 11, bold) .setTextStyle(12, 24, italic) .build(); range.setRichTextValues([[richTextA1], [richTextA2]]);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
values | RichTextValue[][] | रिच टेक्स्ट की मनमुताबिक वैल्यू. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setShowHyperlink(showHyperlink)
सेट करता है कि रेंज को हाइपरलिंक दिखाना चाहिए या नहीं.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its hyperlink value. const range = sheet.getRange('A30'); range.setValue('https://www.example.com'); // Sets cell A30 to show hyperlinks. range.setShowHyperlink(true);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
showHyperlink | Boolean | हाइपरलिंक दिखाना है या नहीं. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirection(direction)
रेंज में सेल के लिए टेक्स्ट की दिशा सेट करता है. अगर तय की गई दिशा null
है, तो दिशा का अनुमान लगाया जाता है और फिर सेट किया जाता है.
// Sets right-to-left text direction for the range. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
direction | TextDirection | मनचाहे टेक्स्ट की दिशा; अगर null है, तो सेटिंग से पहले
निर्देश का अनुमान लगाया जाता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirections(directions)
टेक्स्ट के लिए निर्देशों का एक आयताकार ग्रिड सेट करता है. अगर तय की गई दिशा null
है, तो दिशा का अनुमान लगाया जाता है और फिर सेट किया जाता है.
// Copies all of the text directions from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setTextRotations(range1.getTextDirections());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
directions | TextDirection[][] | मनचाहे टेक्स्ट के निर्देश; अगर तय की गई दिशा null है, तो सेटिंग से पहले इसका अनुमान लगाया जाता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(degrees)
रेंज में मौजूद सेल के लिए टेक्स्ट रोटेशन सेटिंग सेट करता है. यह इनपुट, स्टैंडर्ड टेक्स्ट ओरिएंटेशन और मनचाहे ओरिएंटेशन के बीच के ऐंगल से मेल खाता है. शून्य के इनपुट से पता चलता है कि टेक्स्ट को स्टैंडर्ड ओरिएंटेशन पर सेट किया गया है.
टेक्स्ट की दिशा बाईं से दाईं ओर के लिए, पॉज़िटिव कोण घड़ी की उलटी दिशा में होते हैं, वहीं दाईं से बाईं ओर वे घड़ी की दिशा में होते हैं.
// Sets all cell's in range B2:D4 to have text rotated up 45 degrees. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setTextRotation(45);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
degrees | Integer | स्टैंडर्ड ओरिएंटेशन और पसंदीदा ओरिएंटेशन के बीच का पसंदीदा ऐंगल. बाएं से दाएं टेक्स्ट के लिए, पॉज़िटिव कोण घड़ी की उलटी दिशा में होते हैं. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(rotation)
रेंज में मौजूद सेल के लिए टेक्स्ट रोटेशन सेटिंग सेट करता है.
// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1. var sheet = SpreadsheetApp.getActiveSheet(); var rotation = sheet.getRange("A1").getTextRotation(); sheet.getRange("B2:D4").setTextRotation(rotation);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
rotation | TextRotation | पसंदीदा टेक्स्ट रोटेशन सेटिंग. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotations(rotations)
टेक्स्ट के घुमाव का आयताकार ग्रिड सेट करता है.
// Copies all of the text rotations from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setTextRotations(range1.getTextRotations());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
rotations | TextRotation[][] | पसंदीदा टेक्स्ट रोटेशन सेटिंग. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextStyle(style)
रेंज में मौजूद सेल के लिए टेक्स्ट की स्टाइल सेट करता है.
// Sets the cells in range C5:D6 to have underlined size 15 font. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("C5:D6"); var style = SpreadsheetApp.newTextStyle() .setFontSize(15) .setUnderline(true) .build(); range.setTextStyle(style);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
style | TextStyle | पसंदीदा टेक्स्ट स्टाइल. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextStyles(styles)
टेक्स्ट स्टाइल का आयताकार ग्रिड सेट करता है.
// Sets text styles for cells in range A1:B2 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B2"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var otherStyle = SpreadsheetApp.newTextStyle() .setBold(true) .setUnderline(true) .setItalic(true) .setForegroundColor("#335522") .setFontSize(44) .build(); range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
styles | TextStyle[][] | आपके हिसाब से टेक्स्ट के स्टाइल. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(value)
रेंज की वैल्यू सेट करता है. वैल्यू, न्यूमेरिक, स्ट्रिंग, बूलियन या तारीख वाली हो सकती है. अगर यह '='
से शुरू होता है, तो इसे एक फ़ॉर्मूला माना जाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setValue(100);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
value | Object | रेंज के लिए वैल्यू. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValues(values)
वैल्यू की आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). अगर कोई वैल्यू =
से शुरू होती है, तो उसे एक फ़ॉर्मूला माना जाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var values = [ [ "2.000", "1,000,000", "$2.99" ] ]; var range = sheet.getRange("B2:D2"); range.setValues(values);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
values | Object[][] | वैल्यू की दो डाइमेंशन वाला अरे. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignment(alignment)
दी गई रेंज (ऊपर/मध्य/नीचे) के लिए वर्टिकल (ऊपर से नीचे) अलाइनमेंट सेट करें.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setVerticalAlignment("middle");
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
alignment | String | अलाइनमेंट, 'top' , 'middle' या 'bottom' ; किसी null वैल्यू से अलाइनमेंट रीसेट हो जाता है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignments(alignments)
वर्टिकल अलाइनमेंट का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var alignments = [ [ "top", "middle", "bottom" ] ]; var range = sheet.getRange("B2:D2"); range.setVerticalAlignments(alignments);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
alignments | Object[][] | अलाइनमेंट का दो डाइमेंशन वाला अरे, जिसमें 'top' , 'middle'
या 'bottom' शामिल है. null वैल्यू, अलाइनमेंट को रीसेट करती है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
इन्हें भी देखें
setVerticalText(isVertical)
सेट करता है कि रेंज में सेल के टेक्स्ट को स्टैक करना है या नहीं. अगर टेक्स्ट वर्टिकल तौर पर स्टैक होता है, तो डिग्री टेक्स्ट रोटेशन सेटिंग को अनदेखा कर दिया जाता है.
// Sets all cell's in range B2:D4 to have vertically stacked text. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setVerticalText(true);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
isVertical | Boolean | टेक्स्ट को स्टैक करना है या नहीं. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrap(isWrapEnabled)
दी गई रेंज का सेल रैप सेट करें.
जिन सेल के लिए रैप चालू किया गया है (डिफ़ॉल्ट तौर पर), उनका पूरा कॉन्टेंट दिखाने के लिए उनका साइज़ बदल जाता है. रैप की सुविधा वाली सेल, बंद की गई सेल का साइज़ बदले बिना या उन्हें एक से ज़्यादा लाइनों में चलाए बिना, सेल में ज़्यादा से ज़्यादा दिखाई जाती है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setWrap(true);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
isWrapEnabled | Boolean | टेक्स्ट रैप करना है या नहीं. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategies(strategies)
रैप रणनीतियों का आयताकार ग्रिड सेट करता है.
// Copies all of the wrap strategies from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setWrapStrategies(range1.getWrapStrategies());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
strategies | WrapStrategy[][] | रैपिंग के लिए आपके हिसाब से रणनीतियां. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategy(strategy)
रेंज में मौजूद सेल के लिए, टेक्स्ट रैपिंग की रणनीति सेट करता है.
// Sets all cells in range B2:D4 to use the clip wrap strategy. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
strategy | WrapStrategy | रैपिंग के लिए आपकी पसंद की रणनीति. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWraps(isWrapEnabled)
वर्ड रैप नीतियों का आयताकार ग्रिड सेट करता है (इस रेंज के डाइमेंशन से मेल खाना चाहिए). जिन सेल के लिए रैप चालू है (डिफ़ॉल्ट) उनका पूरा कॉन्टेंट दिखाने के लिए साइज़ बदल जाता है. जिन सेल को रैप करने की सुविधा बंद कर दी गई है वे साइज़ बदलें बिना या कई लाइनों पर चलाए बिना, सेल में ज़्यादा से ज़्यादा दिखते हैं.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var wraps = [ [ true, true, false ] ]; var range = sheet.getRange("B2:D2"); range.setWraps(wraps);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
isWrapEnabled | Object[][] | रैप वैरिएबल का दो-डाइमेंशन वाला अरे, जो यह तय करता है कि सेल में टेक्स्ट को रैप करना है या नहीं. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
इन्हें भी देखें
shiftColumnGroupDepth(delta)
तय की गई रकम से श्रेणी के कॉलम के ग्रुप की गहराई बदलता है.
इसका असर, रेंज से इंटरसेक्ट करने वाले ग्रुप बनाने, उनमें बदलाव करने या उन्हें मिटाने से होता है. सकारात्मक डेल्टा के लिए, समूह बनाए और/या उनमें बदलाव किया जाता है. नेगेटिव डेल्टा के लिए, समूह खत्म हो जाते हैं और/या उनमें बदलाव किया जाता है.
ग्रुप की गहराई को शून्य या आठ से कम करने पर, इसका कोई असर नहीं पड़ता.
अगर column group control position
BEFORE
है, तो पहली लाइन की डेप्थ शिफ़्ट
करने पर गड़बड़ी दिखती है.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // The column grouping depth is increased by 1. range.shiftColumnGroupDepth(1); // The column grouping depth is decreased by 1. range.shiftColumnGroupDepth(-1);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
delta | Integer | वह रकम जिसके ज़रिए इस रेंज के कॉलम ग्रुप की गहराई में बदलाव करना है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
थ्रो
Error
— जब कंट्रोल की पोज़िशन GroupControlTogglePosition.BEFORE
होने पर, पहले कॉलम की डेप्थ को शिफ़्ट करने की कोशिश की जाती है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
shiftRowGroupDepth(delta)
तय की गई रकम से रेंज की पंक्ति की ग्रुप गहराई को बदलता है.
इसका असर, रेंज से इंटरसेक्ट करने वाले ग्रुप बनाने, उनमें बदलाव करने या उन्हें मिटाने से होता है. सकारात्मक डेल्टा के लिए, समूह बनाए और/या उनमें बदलाव किया जाता है. नेगेटिव डेल्टा के लिए, समूह खत्म हो जाते हैं और/या उनमें बदलाव किया जाता है.
ग्रुप की गहराई को शून्य या आठ से कम करने पर, इसका कोई असर नहीं पड़ता.
अगर row group control position
, BEFORE
है, तो पहली पंक्ति की गहराई बदलने की कोशिश करने पर यह गड़बड़ी दिखाता है.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // The row grouping depth is increased by 1. range.shiftRowGroupDepth(1); // The row grouping depth is decreased by 1. range.shiftRowGroupDepth(-1);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
delta | Integer | वह मात्रा जिससे इस रेंज के पंक्ति ग्रुप की गहराई को बदलना है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
थ्रो
Error
— जब कंट्रोल की पोज़िशन GroupControlTogglePosition.BEFORE
होने पर, पहली लाइन की डेप्थ को शिफ़्ट करने की कोशिश की जाती है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(sortSpecObj)
दी गई रेंज में, बताए गए कॉलम और क्रम के मुताबिक सेल को क्रम से लगाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:C7"); // Sorts by the values in the first column (A) range.sort(1); // Sorts by the values in the second column (B) range.sort(2); // Sorts descending by column B range.sort({column: 2, ascending: false}); // Sorts descending by column B, then ascending by column A // Note the use of an array range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]); // For rows that are sorted in ascending order, the "ascending" parameter is // optional, and just an integer with the column can be used instead. Note that // in general, keeping the sort specification consistent results in more readable // code. You can express the earlier sort as: range.sort([{column: 2, ascending: false}, 1]); // Alternatively, if you want all columns to be in ascending order, you can use // the following (this makes column 2 ascending) range.sort([2, 1]); // ... which is equivalent to range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
sortSpecObj | Object | वे कॉलम जिनके आधार पर क्रम से लगाना है. |
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns()
अपने-आप पता लगाए गए डीलिमिटर के आधार पर, टेक्स्ट के कॉलम को एक से ज़्यादा कॉलम में बांट देता है.
// A1:A3 has the following values: // A B C // 1 |one,one,one | | | // 2 |two,two,two | | | // 3 |three,three,three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns(); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns(delimiter)
कस्टम डीलिमिटर के तौर पर बताई गई स्ट्रिंग का इस्तेमाल करके, टेक्स्ट के कॉलम को एक से ज़्यादा कॉलम में बांट देता है.
// A1:A3 has the following values: // A B C // 1 |one#one#one | | | // 2 |two#two#two | | | // 3 |three#three#three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns('#'); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
delimiter | String | स्प्लिट करने के लिए कस्टम डीलिमिटर. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns(delimiter)
तय किए गए डीलिमिटर के आधार पर, टेक्स्ट के कॉलम को एक से ज़्यादा कॉलम में बांट देता है.
// A1:A3 has the following values: // A B C // 1 |one;one;one | | | // 2 |two;two;two | | | // 3 |three;three;three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
delimiter | TextToColumnsDelimiter | स्प्लिट करने के लिए प्रीसेट डीलिमिटर. |
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trimWhitespace()
इस रेंज की हर सेल में खाली सफ़ेद जगह (जैसे कि खाली जगह, टैब या नई लाइन) में काट-छांट करता है. हर सेल के टेक्स्ट की शुरुआत और आखिर से सभी खाली सफ़ेद जगह हटा देता है और बचे हुए व्हाइटस्पेस वर्णों के किसी भी उप-क्रम को एक स्पेस में कम कर देता है.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:A4'); range.activate(); range.setValues( [' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)']) range.trimWhitespace(); var values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
uncheck()
रेंज में चेकबॉक्स की स्थिति को “सही का निशान हटाया गया” में बदलता है. रेंज में उन सेल को अनदेखा करता है जिनमें फ़िलहाल, कॉन्फ़िगर किया गया या नहीं चुना गया मान शामिल नहीं है.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the range A1:B10 to 'unchecked'. var range = SpreadsheetApp.getActive().getRange('A1:B10'); range.uncheck();
रिटर्न
Range
— यह रेंज, चेन करने के लिए है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets