Class SpreadsheetApp

स्प्रेडशीटऐप्लिकेशन

Google Sheets फ़ाइलें ऐक्सेस करना और बनाना. यह क्लास, स्प्रेडशीट सेवा की पैरंट क्लास है.

प्रॉपर्टी

प्रॉपर्टीटाइपब्यौरा
AutoFillSeriesAutoFillSeriesअपने-आप भरी गई वैल्यू का हिसाब लगाने के लिए, इस्तेमाल की जाने वाली सीरीज़ के टाइप की सूची.
BandingThemeBandingThemeबैंडिंग की संभावित थीम की सूची.
BooleanCriteriaBooleanCriteriaकंडीशनल फ़ॉर्मैटिंग की बूलियन शर्तों की सूची.
BorderStyleBorderStyleRange पर बॉर्डर सेट करने के लिए, मान्य स्टाइल की सूची.
ColorTypeColorTypeरंग के संभावित टाइप की सूची.
CopyPasteTypeCopyPasteTypeचिपकाने के अलग-अलग तरीकों की जानकारी.
DataExecutionErrorCodeDataExecutionErrorCodeडेटा प्रोसेस करते समय दिखने वाली गड़बड़ी के कोड.
DataExecutionStateDataExecutionStateडेटा लागू करने की संभावित स्थितियों की जानकारी.
DataSourceParameterTypeDataSourceParameterTypeडेटा सोर्स पैरामीटर के संभावित टाइप की जानकारी.
DataSourceRefreshScopeDataSourceRefreshScopeडेटा सोर्स को रीफ़्रेश करने के संभावित स्कोप की जानकारी.
DataSourceTypeDataSourceTypeडेटा सोर्स के अलग-अलग टाइप की जानकारी.
DataValidationCriteriaDataValidationCriteriaडेटा की पुष्टि करने की शर्तों को दिखाने वाला एनोटेशन, जिसे रेंज पर सेट किया जा सकता है.
DateTimeGroupingRuleTypeDateTimeGroupingRuleTypeतारीख और समय के हिसाब से ग्रुप में रखने के नियम की जानकारी.
DeveloperMetadataLocationTypeDeveloperMetadataLocationTypeडेवलपर मेटाडेटा की जगह के संभावित टाइप की सूची.
DeveloperMetadataVisibilityDeveloperMetadataVisibilityडेवलपर मेटाडेटा की संभावित विज़िबिलिटी की जानकारी.
DimensionDimensionकिसी स्प्रेडशीट के संभावित डाइमेंशन की गिनती.
DirectionDirectionऐरो बटन का इस्तेमाल करके, स्प्रेडशीट में आगे-पीछे जाने की दिशाओं की जानकारी.
FrequencyTypeFrequencyTypeफ़्रीक्वेंसी के संभावित टाइप की जानकारी.
GroupControlTogglePositionGroupControlTogglePositionग्रुप कंट्रोल टॉगल की उन स्थितियों की सूची जिनमें यह टॉगल हो सकता है.
InterpolationTypeInterpolationTypeकंडीशनल फ़ॉर्मैट ग्रेडिएंट इंटरपोलेशन टाइप की जानकारी.
PivotTableSummarizeFunctionPivotTableSummarizeFunctionऐसे फ़ंक्शन की सूची जिनका इस्तेमाल, पिवट टेबल में वैल्यू की खास जानकारी देने के लिए किया जा सकता है.
PivotValueDisplayTypePivotValueDisplayTypeपिवट वैल्यू को दिखाने के तरीकों की सूची.
ProtectionTypeProtectionTypeस्प्रेडशीट के उन हिस्सों को दिखाने वाला एनोटेशन जिन्हें बदलावों से सुरक्षित किया जा सकता है.
RecalculationIntervalRecalculationIntervalउन इंटरवल की सूची जिनका इस्तेमाल, स्प्रेडशीट में फिर से कैलकुलेट करने के लिए किया जा सकता है.
RelativeDateRelativeDateतारीख के आधार पर BooleanCriteria में इस्तेमाल की जाने वाली वैल्यू का हिसाब लगाने के लिए, रिलेटिव तारीख के विकल्पों की सूची.
SheetTypeSheetTypeस्प्रेडशीट में मौजूद अलग-अलग तरह की शीट की जानकारी.
SortOrderSortOrderक्रम से लगाने का तरीका.
TextDirectionTextDirectionमान्य टेक्स्ट निर्देशों की सूची.
TextToColumnsDelimiterTextToColumnsDelimiterटेक्स्ट को कॉलम में बांटने के लिए, पहले से सेट किए गए डीलिमिटर की सूची.
ThemeColorTypeThemeColorTypeथीम के कलर के अलग-अलग टाइप.
ValueTypeValueTypeस्प्रेडशीट सेवा की रेंज क्लास से Range.getValue() और Range.getValues() से लौटाई गई वैल्यू टाइप की सूची. यहां दी गई वैल्यू, Number, Boolean, Date या String के अलावा, इनूमरेशन की अन्य वैल्यू हैं.
WrapStrategyWrapStrategyसेल को रैप करने के लिए इस्तेमाल की जाने वाली रणनीतियों की सूची.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
create(name)Spreadsheetदिए गए नाम से नई स्प्रेडशीट बनाता है.
create(name, rows, columns)Spreadsheetदिए गए नाम और तय की गई पंक्तियों और कॉलम की संख्या के साथ एक नई स्प्रेडशीट बनाता है.
enableAllDataSourcesExecution()voidसभी तरह के डेटा सोर्स के लिए, डेटा प्रोसेस करने की सुविधा चालू करता है.
enableBigQueryExecution()voidBigQuery डेटा सोर्स के लिए, डेटा एक्सीक्यूशन की सुविधा चालू करता है.
enableLookerExecution()voidLooker डेटा सोर्स के लिए, डेटा प्रोसेस करने की सुविधा चालू करता है.
flush()voidस्प्रेडशीट में किए गए सभी बदलाव लागू करता है.
getActive()Spreadsheetफ़िलहाल चालू स्प्रेडशीट दिखाता है. अगर कोई स्प्रेडशीट चालू नहीं है, तो null दिखाता है.
getActiveRange()Rangeयह फ़ंक्शन, चालू शीट में चुनी गई रेंज दिखाता है. अगर कोई चालू रेंज नहीं है, तो यह null दिखाता है.
getActiveRangeList()RangeListअगर कोई रेंज नहीं चुनी गई है, तो यह फ़ंक्शन चालू शीट या null में मौजूद ऐक्टिव रेंज की सूची दिखाता है.
getActiveSheet()Sheetस्प्रेडशीट में मौजूद चालू शीट को दिखाता है.
getActiveSpreadsheet()Spreadsheetफ़िलहाल चालू स्प्रेडशीट दिखाता है. अगर कोई स्प्रेडशीट चालू नहीं है, तो null दिखाता है.
getCurrentCell()Rangeयह फ़ंक्शन, चालू शीट की किसी ऐक्टिव रेंज में से चुनी गई मौजूदा (हाइलाइट की गई) सेल दिखाता है. अगर कोई मौजूदा सेल नहीं है, तो यह null दिखाता है.
getSelection()Selectionस्प्रेडशीट में मौजूदा Selection दिखाता है.
getUi()Uiस्प्रेडशीट के यूज़र-इंटरफ़ेस एनवायरमेंट का एक इंस्टेंस दिखाता है. इसकी मदद से, स्क्रिप्ट में मेन्यू, डायलॉग, और साइडबार जैसी सुविधाएं जोड़ी जा सकती हैं.
newCellImage()CellImageBuilderCellImage के लिए बिल्डर बनाता है.
newColor()ColorBuilderColor के लिए बिल्डर बनाता है.
newConditionalFormatRule()ConditionalFormatRuleBuilderशर्त के साथ फ़ॉर्मैटिंग के नियम के लिए बिल्डर बनाता है.
newDataSourceSpec()DataSourceSpecBuilderDataSourceSpec के लिए बिल्डर बनाता है.
newDataValidation()DataValidationBuilderडेटा की पुष्टि करने के नियम के लिए बिल्डर बनाता है.
newFilterCriteria()FilterCriteriaBuilderFilterCriteria के लिए बिल्डर बनाता है.
newRichTextValue()RichTextValueBuilderरिच टेक्स्ट वैल्यू के लिए बिल्डर बनाता है.
newTextStyle()TextStyleBuilderटेक्स्ट स्टाइल के लिए बिल्डर बनाता है.
open(file)Spreadsheetदिए गए File ऑब्जेक्ट से जुड़ी स्प्रेडशीट खोलता है.
openById(id)Spreadsheetदिए गए आईडी वाली स्प्रेडशीट खोलता है.
openByUrl(url)Spreadsheetदिए गए यूआरएल की मदद से स्प्रेडशीट खोलता है.
setActiveRange(range)Rangeयह फ़ंक्शन, तय की गई रेंज को active range के तौर पर सेट करता है. साथ ही, रेंज में सबसे ऊपर बाईं ओर मौजूद सेल को current cell के तौर पर सेट करता है.
setActiveRangeList(rangeList)RangeListरेंज की तय की गई सूची को active ranges के तौर पर सेट करता है.
setActiveSheet(sheet)Sheetस्प्रेडशीट में चालू शीट सेट करता है.
setActiveSheet(sheet, restoreSelection)Sheetस्प्रेडशीट में मौजूद चालू शीट को सेट करता है. साथ ही, उस शीट में सबसे हाल ही में चुने गए डेटा को वापस लाने का विकल्प भी देता है.
setActiveSpreadsheet(newActiveSpreadsheet)voidचालू स्प्रेडशीट सेट करता है.
setCurrentCell(cell)Rangeकिसी सेल को current cell के तौर पर सेट करता है.

ज़्यादा जानकारी वाला दस्तावेज़

create(name)

दिए गए नाम से नई स्प्रेडशीट बनाता है.

// The code below creates a new spreadsheet "Finances" and logs the URL for it
const ssNew = SpreadsheetApp.create('Finances');
Logger.log(ssNew.getUrl());

पैरामीटर

नामटाइपब्यौरा
nameStringस्प्रेडशीट का नाम.

वापसी का टिकट

Spreadsheet — नई स्प्रेडशीट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets

create(name, rows, columns)

दिए गए नाम और तय की गई पंक्तियों और कॉलम की संख्या के साथ एक नई स्प्रेडशीट बनाता है.

// The code below creates a new spreadsheet "Finances" with 50 rows and 5
// columns and logs the URL for it
const ssNew = SpreadsheetApp.create('Finances', 50, 5);
Logger.log(ssNew.getUrl());

पैरामीटर

नामटाइपब्यौरा
nameStringस्प्रेडशीट का नाम.
rowsIntegerस्प्रेडशीट में पंक्तियों की संख्या.
columnsIntegerस्प्रेडशीट में कॉलम की संख्या.

वापसी का टिकट

Spreadsheet — नई स्प्रेडशीट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets

enableAllDataSourcesExecution()

सभी तरह के डेटा सोर्स के लिए, डेटा प्रोसेस करने की सुविधा चालू करता है.

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

// Turns data execution on for all types of data sources.
SpreadsheetApp.enableAllDataSourcesExecution();

// 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 the first data source sheet in the spreadsheet and refreshes the data.
ss.getDataSourceSheets()[0].refreshData();

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/bigquery.readonly

enableBigQueryExecution()

BigQuery डेटा सोर्स के लिए, डेटा एक्सीक्यूशन की सुविधा चालू करता है.

BigQuery डेटा सोर्स के लिए डेटा एक्सीक्यूशन की सुविधा चालू न होने पर, अपवाद दिखता है.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// 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 the first data source sheet in the spreadsheet and refreshes the
// BigQuery data.
ss.getDataSourceSheets()[0].refreshData();

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/bigquery.readonly

enableLookerExecution()

Looker डेटा सोर्स के लिए, डेटा प्रोसेस करने की सुविधा चालू करता है.

अगर Looker डेटा सोर्स के लिए डेटा एक्ज़ीक्यूशन की सुविधा चालू नहीं है, तो अपवाद दिखता है.

// Turns data execution on for Looker data sources.
SpreadsheetApp.enableLookerExecution();

// 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 the first data source sheet in the spreadsheet and refreshes the
// associated Looker data.
ss.getDataSourceSheets()[0].refreshData();

flush()

स्प्रेडशीट में किए गए सभी बदलाव लागू करता है.

परफ़ॉर्मेंस को बेहतर बनाने के लिए, स्प्रेडशीट के ऑपरेशन कभी-कभी एक साथ किए जाते हैं. जैसे, Range.getValue() को कई बार कॉल करने पर. हालांकि, कभी-कभी आपको यह पक्का करना पड़ सकता है कि सभी लंबित बदलाव तुरंत किए जाएं. उदाहरण के लिए, स्क्रिप्ट के चलने के दौरान उपयोगकर्ताओं को डेटा दिखाने के लिए.

// The code below changes the background color of cells A1 and B1 twenty times.
// You should be able to see the updates live in the spreadsheet. If flush() is
// not called, the updates may be applied live or may all be applied at once
// when the script completes.
function colors() {
  const sheet = SpreadsheetApp.getActiveSheet();
  for (let i = 0; i < 20; i++) {
    if (i % 2 === 0) {
      sheet.getRange('A1').setBackground('green');
      sheet.getRange('B1').setBackground('red');
    } else {
      sheet.getRange('A1').setBackground('red');
      sheet.getRange('B1').setBackground('green');
    }
    SpreadsheetApp.flush();
  }
}

getActive()

फ़िलहाल चालू स्प्रेडशीट दिखाता है. अगर कोई स्प्रेडशीट चालू नहीं है, तो null दिखाता है.

स्प्रेडशीट के संदर्भ में चलने वाले फ़ंक्शन, इस फ़ंक्शन को कॉल करके, उससे जुड़े स्प्रेडशीट ऑब्जेक्ट का रेफ़रंस पा सकते हैं.

// The code below logs the URL for the active spreadsheet.
Logger.log(SpreadsheetApp.getActive().getUrl());

वापसी का टिकट

Spreadsheet — चालू स्प्रेडशीट ऑब्जेक्ट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveRange()

यह फ़ंक्शन, चालू शीट में चुनी गई रेंज दिखाता है. अगर कोई चालू रेंज नहीं है, तो यह null दिखाता है. अगर एक से ज़्यादा रेंज चुनी जाती हैं, तो यह तरीका सिर्फ़ आखिरी बार चुनी गई रेंज दिखाता है.

आम तौर पर, इसका मतलब उस रेंज से होता है जिसे उपयोगकर्ता ने चालू शीट में चुना है. हालांकि, कस्टम फ़ंक्शन में इसका मतलब उस सेल से होता है जिसकी गिनती फिर से की जा रही है.

// The code below logs the background color for the active range.
const colorObject = SpreadsheetApp.getActiveRange().getBackgroundObject();
// Assume the color has ColorType.RGB.
Logger.log(colorObject.asRgbColor().asHexString());

वापसी का टिकट

Range — ऐक्टिव रेंज.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveRangeList()

अगर कोई रेंज नहीं चुनी गई है, तो यह फ़ंक्शन चालू शीट या null में मौजूद ऐक्टिव रेंज की सूची दिखाता है. हाइलाइट की गई मौजूदा सेल वाली सक्रिय रेंज, सूची में सबसे आखिर में दिखती है.

अगर सिर्फ़ एक रेंज चुनी गई है, तो यह getActiveRange() कॉल के तौर पर काम करती है.

// Returns the list of active ranges.
const rangeList = SpreadsheetApp.getActiveRangeList();

वापसी का टिकट

RangeList — ऐक्टिव रेंज की सूची

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveSheet()

स्प्रेडशीट में मौजूद चालू शीट को दिखाता है.

स्प्रेडशीट में ऐक्टिव शीट वह शीट होती है जो स्प्रेडशीट के यूज़र इंटरफ़ेस (यूआई) में दिख रही होती है.

// The code below logs the name of the active sheet.
Logger.log(SpreadsheetApp.getActiveSheet().getName());

वापसी का टिकट

Sheet — चालू शीट ऑब्जेक्ट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveSpreadsheet()

फ़िलहाल चालू स्प्रेडशीट दिखाता है. अगर कोई स्प्रेडशीट चालू नहीं है, तो null दिखाता है.

स्प्रेडशीट के संदर्भ में चलने वाले फ़ंक्शन, इस फ़ंक्शन को कॉल करके, उससे जुड़े Spreadsheet ऑब्जेक्ट का रेफ़रंस पा सकते हैं.

// The code below logs the URL for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getUrl());

वापसी का टिकट

Spreadsheet — चालू स्प्रेडशीट ऑब्जेक्ट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getCurrentCell()

यह फ़ंक्शन, चालू शीट की किसी ऐक्टिव रेंज में से चुनी गई मौजूदा (हाइलाइट की गई) सेल दिखाता है. अगर कोई मौजूदा सेल नहीं है, तो यह null दिखाता है.

// Returns the current highlighted cell in the one of the active ranges.
const currentCell = SpreadsheetApp.getCurrentCell();

वापसी का टिकट

Range — मौजूदा सेल

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSelection()

स्प्रेडशीट में मौजूदा Selection दिखाता है.

const selection = SpreadsheetApp.getSelection();
const currentCell = selection.getCurrentCell();

वापसी का टिकट

Selection — चुना गया मौजूदा आइटम

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getUi()

स्प्रेडशीट के यूज़र-इंटरफ़ेस एनवायरमेंट का एक इंस्टेंस दिखाता है. इसकी मदद से, स्क्रिप्ट में मेन्यू, डायलॉग, और साइडबार जैसी सुविधाएं जोड़ी जा सकती हैं. कोई स्क्रिप्ट, सिर्फ़ खुली स्प्रेडशीट के मौजूदा इंस्टेंस के यूज़र इंटरफ़ेस (यूआई) के साथ इंटरैक्ट कर सकती है. ऐसा तब ही होगा, जब स्क्रिप्ट को स्प्रेडशीट से बाउंड किया गया हो. ज़्यादा जानकारी के लिए, मेन्यू और डायलॉग और साइडबार के लिए बनी गाइड देखें.

// Add a custom menu to the active spreadsheet, including a separator and a
// sub-menu.
function onOpen(e) {
  SpreadsheetApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(
          SpreadsheetApp.getUi()
              .createMenu('My sub-menu')
              .addItem('One sub-menu item', 'mySecondFunction')
              .addItem('Another sub-menu item', 'myThirdFunction'),
          )
      .addToUi();
}

वापसी का टिकट

Ui — इस स्प्रेडशीट के यूज़र-इंटरफ़ेस एनवायरमेंट का एक इंस्टेंस


newCellImage()

CellImage के लिए बिल्डर बनाता है.

// 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 on Sheet1.
const range = sheet.getRange('A1');

// Builds an image using a source URL.
const cellImage =
    SpreadsheetApp.newCellImage()
        .setSourceUrl(
            'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',
            )
        .build();

// Sets the image in cell A1.
range.setValue(cellImage);

वापसी का टिकट

CellImageBuilder — नया बिल्डर.


newColor()

Color के लिए बिल्डर बनाता है.

const rgbColor = SpreadsheetApp.newColor().setRgbColor('#FF0000').build();

वापसी का टिकट

ColorBuilder — नया बिल्डर.


newConditionalFormatRule()

शर्त के साथ फ़ॉर्मैटिंग के नियम के लिए बिल्डर बनाता है.

// Adds a conditional format rule to a sheet that causes all cells in range
// A1:B3 to turn red if they contain a number between 1 and 10.
const sheet = SpreadsheetApp.getActive().getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

वापसी का टिकट

ConditionalFormatRuleBuilder — नया बिल्डर.


newDataSourceSpec()

DataSourceSpec के लिए बिल्डर बनाता है.

// 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',
);

// Enables BigQuery.
SpreadsheetApp.enableBigQueryExecution();

// Builds a data source specification.
// TODO (developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
                           .asBigQuery()
                           .setProjectId('project-id-1')
                           .setTableProjectId('bigquery-public-data')
                           .setDatasetId('ncaa_basketball')
                           .setTableId('mbb_historical_teams_games')
                           .build();

// Adds the data source and its data to the spreadsheet.
ss.insertDataSourceSheet(dataSourceSpec);

वापसी का टिकट

DataSourceSpecBuilder — नया बिल्डर.


newDataValidation()

डेटा की पुष्टि करने के नियम के लिए बिल्डर बनाता है.

const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberBetween(1, 100)
                 .setAllowInvalid(false)
                 .setHelpText('Number must be between 1 and 100.')
                 .build();
cell.setDataValidation(rule);

वापसी का टिकट

DataValidationBuilder — नया बिल्डर.


newFilterCriteria()

FilterCriteria के लिए बिल्डर बनाता है.

// 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 the range to A1:D20.
const range = sheet.getRange('A1:D20');

// Creates a filter and applies it to the specified range.
range.createFilter();

// Gets the current filter for the range and creates filter criteria that only
// shows cells that aren't empty.
const filter = range.getFilter();
const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();

// Sets the criteria to  column C.
filter.setColumnFilterCriteria(3, criteria);

वापसी का टिकट

FilterCriteriaBuilder — नया बिल्डर


newRichTextValue()

रिच टेक्स्ट वैल्यू के लिए बिल्डर बनाता है.

// Sets cell A1 to have the text "Hello world", with "Hello" bolded.
const cell = SpreadsheetApp.getActive().getRange('A1');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const value = SpreadsheetApp.newRichTextValue()
                  .setText('Hello world')
                  .setTextStyle(0, 5, bold)
                  .build();
cell.setRichTextValue(value);

वापसी का टिकट

RichTextValueBuilder — नया बिल्डर.


newTextStyle()

टेक्स्ट स्टाइल के लिए बिल्डर बनाता है.

// Sets range A1:B3 to have red, size 22, bolded, underlined text.
const range = SpreadsheetApp.getActive().getRange('A1:B3');
const style = SpreadsheetApp.newTextStyle()
                  .setForegroundColor('red')
                  .setFontSize(22)
                  .setBold(true)
                  .setUnderline(true)
                  .build();
range.setTextStyle(style);

वापसी का टिकट

TextStyleBuilder — नया बिल्डर.


open(file)

दिए गए File ऑब्जेक्ट से जुड़ी स्प्रेडशीट खोलता है.

// Get any starred spreadsheets from Google Drive, then open the spreadsheets
// and log the name of the first sheet within each spreadsheet.
const files = DriveApp.searchFiles(
    `starred = true and mimeType = "${MimeType.GOOGLE_SHEETS}"`,
);
while (files.hasNext()) {
  const spreadsheet = SpreadsheetApp.open(files.next());
  const sheet = spreadsheet.getSheets()[0];
  Logger.log(sheet.getName());
}

पैरामीटर

नामटाइपब्यौरा
fileFileवह फ़ाइल जिसे खोलना है.

वापसी का टिकट

Spreadsheet — स्प्रेडशीट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets

openById(id)

दिए गए आईडी वाली स्प्रेडशीट खोलता है. स्प्रेडशीट का आईडी, उसके यूआरएल से निकाला जा सकता है. उदाहरण के लिए, यूआरएल https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 में स्प्रेडशीट आईडी "abc1234567" है.

// The code below opens a spreadsheet using its ID and logs the name for it.
// Note that the spreadsheet is NOT physically opened on the client side.
// It is opened on the server only (for modification by the script).
const ss = SpreadsheetApp.openById('abc1234567');
Logger.log(ss.getName());

पैरामीटर

नामटाइपब्यौरा
idStringस्प्रेडशीट का यूनीक आइडेंटिफ़ायर.

वापसी का टिकट

Spreadsheet — दिए गए आईडी वाला स्प्रेडशीट ऑब्जेक्ट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets

openByUrl(url)

दिए गए यूआरएल की मदद से स्प्रेडशीट खोलता है. अगर यूआरएल मौजूद नहीं है या उपयोगकर्ता के पास उसे ऐक्सेस करने की अनुमति नहीं है, तो स्क्रिप्टिंग एक्सेप्शन दिखाता है.

// Opens a spreadsheet by its URL and logs its name.
// Note that the spreadsheet doesn't physically open on the client side.
// It opens on the server only (for modification by the script).
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc1234567/edit',
);
console.log(ss.getName());

पैरामीटर

नामटाइपब्यौरा
urlStringस्प्रेडशीट का यूआरएल.

वापसी का टिकट

Spreadsheet — दिए गए यूआरएल वाला स्प्रेडशीट ऑब्जेक्ट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets

setActiveRange(range)

यह फ़ंक्शन, तय की गई रेंज को active range के तौर पर सेट करता है. साथ ही, रेंज में सबसे ऊपर बाईं ओर मौजूद सेल को current cell के तौर पर सेट करता है.

स्प्रेडशीट का यूज़र इंटरफ़ेस (यूआई), चुनी गई रेंज वाली शीट दिखाता है और चुनी गई रेंज में मौजूद सेल को चुनता है.

// The code below sets range C1:D4 in the first sheet as the active range.
const range =
    SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('C1:D4');
SpreadsheetApp.setActiveRange(range);

const selection = SpreadsheetApp.getSelection();
// Current cell: C1
const currentCell = selection.getCurrentCell();
// Active Range: C1:D4
const activeRange = selection.getActiveRange();

पैरामीटर

नामटाइपब्यौरा
rangeRangeवह रेंज जिसे चालू रेंज बनाना है.

वापसी का टिकट

Range — नई चालू रेंज


setActiveRangeList(rangeList)

रेंज की तय की गई सूची को active ranges के तौर पर सेट करता है. सूची में आखिरी रेंज को active range के तौर पर सेट किया गया है.

// The code below sets ranges [D4, B2:C4] in the active sheet as the active
// ranges.
const rangeList = SpreadsheetApp.getActiveSheet().getRanges(['D4', 'B2:C4']);
SpreadsheetApp.setActiveRangeList(rangeList);

const selection = SpreadsheetApp.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const activeRangeList = selection.getActiveRangeList();

पैरामीटर

नामटाइपब्यौरा
rangeListRangeListचुनी जाने वाली रेंज की सूची.

वापसी का टिकट

RangeList — चुनी गई नई रेंज की सूची

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setActiveSheet(sheet)

स्प्रेडशीट में चालू शीट सेट करता है. Google Sheets का यूज़र इंटरफ़ेस (यूआई), चुनी गई शीट तब तक दिखाता है, जब तक कि वह किसी दूसरी स्प्रेडशीट से न जुड़ी हो.

// The code below makes the 2nd sheet active in the active spreadsheet.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
SpreadsheetApp.setActiveSheet(spreadsheet.getSheets()[1]);

पैरामीटर

नामटाइपब्यौरा
sheetSheetनई ऐक्टिव शीट.

वापसी का टिकट

Sheet — वह शीट जिसे नई चालू शीट बनाया गया है


setActiveSheet(sheet, restoreSelection)

स्प्रेडशीट में मौजूद चालू शीट को सेट करता है. साथ ही, उस शीट में सबसे हाल ही में चुने गए डेटा को वापस लाने का विकल्प भी देता है. Google Sheets का यूज़र इंटरफ़ेस (यूआई), चुनी गई शीट तब तक दिखाता है, जब तक वह किसी दूसरी स्प्रेडशीट से नहीं जुड़ी होती.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const firstSheet = spreadsheet.getSheets()[0];
const secondSheet = spreadsheet.getSheets()[1];
// Set the first sheet as the active sheet and select the range D4:F4.
spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate();

// Switch to the second sheet to do some work.
spreadsheet.setActiveSheet(secondSheet);
// Switch back to first sheet, and restore its selection.
spreadsheet.setActiveSheet(firstSheet, true);

// The selection of first sheet is restored, and it logs D4:F4
const range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

पैरामीटर

नामटाइपब्यौरा
sheetSheetनई ऐक्टिव शीट.
restoreSelectionBooleanअगर true चुना जाता है, तो नई शीट चालू होने पर, सबसे हाल ही में चुना गया सेल फिर से चुना जाता है. अगर false चुना जाता है, तो मौजूदा सेल को बदले बिना नई शीट चालू हो जाती है.

वापसी का टिकट

Sheet — नई चालू शीट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setActiveSpreadsheet(newActiveSpreadsheet)

चालू स्प्रेडशीट सेट करता है.

// The code below makes the spreadsheet with key "1234567890" the active
// spreadsheet
const ss = SpreadsheetApp.openById('1234567890');
SpreadsheetApp.setActiveSpreadsheet(ss);

पैरामीटर

नामटाइपब्यौरा
newActiveSpreadsheetSpreadsheetवह स्प्रेडशीट जिसे चालू स्प्रेडशीट बनाना है.

setCurrentCell(cell)

किसी सेल को current cell के तौर पर सेट करता है.

अगर चुनी गई सेल, पहले से चुनी गई रेंज में मौजूद है, तो वह रेंज चालू रेंज बन जाती है और सेल को मौजूदा सेल के तौर पर सेट कर दिया जाता है.

अगर चुनी गई किसी भी रेंज में, बताई गई सेल मौजूद नहीं है, तो मौजूदा सेल हटा दी जाती है और सेल, मौजूदा सेल और चालू रेंज बन जाती है.

ध्यान दें:तय किए गए Range में एक सेल होनी चाहिए. ऐसा न होने पर, यह तरीका काम नहीं करता.

// The code below sets the cell B5 in the first sheet as the current cell.
const cell =
    SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('B5');
SpreadsheetApp.setCurrentCell(cell);

const selection = SpreadsheetApp.getSelection();
// Current cell: B5
const currentCell = selection.getCurrentCell();

पैरामीटर

नामटाइपब्यौरा
cellRangeवह सेल जिसे मौजूदा सेल के तौर पर सेट करना है.

वापसी का टिकट

Range — नई सेट की गई मौजूदा सेल

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets