এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

Class SpreadsheetApp

গুগল শিটস ফাইল অ্যাক্সেস ও তৈরি করুন। এই ক্লাসটি স্প্রেডশিট সার্ভিসের প্যারেন্ট ক্লাস।

বৈশিষ্ট্য

সম্পত্তি	প্রকার	বর্ণনা
`Auto Fill Series`	`Auto Fill Series`	স্বয়ংক্রিয়ভাবে পূরণকৃত মান গণনা করতে ব্যবহৃত সিরিজগুলোর প্রকারভেদের একটি তালিকা।
`Banding Theme`	`Banding Theme`	সম্ভাব্য ব্যান্ডিং থিমগুলির একটি তালিকা।
`Boolean Criteria`	`Boolean Criteria`	শর্তসাপেক্ষ ফরম্যাটিং বুলিয়ান মানদণ্ডগুলোর একটি তালিকা।
`Border Style`	`Border Style`	একটি `Range` বর্ডার সেট করার জন্য বৈধ স্টাইলগুলোর একটি তালিকা।
`Color Type`	`Color Type`	সম্ভাব্য রঙের প্রকারভেদগুলোর একটি তালিকা।
`Copy Paste Type`	`Copy Paste Type`	সম্ভাব্য পেস্টের প্রকারভেদগুলোর একটি তালিকা।
`Data Execution Error Code`	`Data Execution Error Code`	সম্ভাব্য ডেটা এক্সিকিউশন ত্রুটি কোডগুলোর একটি তালিকা।
`Data Execution State`	`Data Execution State`	ডেটা নির্বাহের সম্ভাব্য অবস্থাগুলোর একটি তালিকা।
`Data Source Parameter Type`	`Data Source Parameter Type`	সম্ভাব্য ডেটা উৎস প্যারামিটার প্রকারগুলির একটি তালিকা।
`Data Source Refresh Scope`	`Data Source Refresh Scope`	সম্ভাব্য ডেটা সোর্স রিফ্রেশ স্কোপগুলোর একটি তালিকা।
`Data Source Type`	`Data Source Type`	সম্ভাব্য ডেটা উৎসের প্রকারগুলোর একটি তালিকা।
`Data Validation Criteria`	`Data Validation Criteria`	একটি এনুমারেশন যা ডেটা যাচাইকরণের মানদণ্ডকে উপস্থাপন করে এবং যা একটি রেঞ্জের উপর সেট করা যেতে পারে।
`Date Time Grouping Rule Type`	`Date Time Grouping Rule Type`	তারিখ ও সময় দলবদ্ধকরণ নিয়মের একটি তালিকা।
`Developer Metadata Location Type`	`Developer Metadata Location Type`	সম্ভাব্য ডেভেলপার মেটাডেটা অবস্থানের প্রকারগুলোর একটি তালিকা।
`Developer Metadata Visibility`	`Developer Metadata Visibility`	ডেভেলপার মেটাডেটার সম্ভাব্য দৃশ্যমানতাগুলোর একটি তালিকা।
`Dimension`	`Dimension`	একটি স্প্রেডশীটের সম্ভাব্য মাত্রাগুলোর একটি তালিকা।
`Direction`	`Direction`	অ্যারো কী ব্যবহার করে একটি স্প্রেডশীটের মধ্যে যে যে দিকে যাওয়া যায়, তার একটি তালিকা।
`Frequency Type`	`Frequency Type`	সম্ভাব্য ফ্রিকোয়েন্সি প্রকারগুলির একটি তালিকা।
`Group Control Toggle Position`	`Group Control Toggle Position`	গ্রুপ কন্ট্রোল টগলটি যে যে অবস্থানে থাকতে পারে, তার একটি তালিকা।
`Interpolation Type`	`Interpolation Type`	কন্ডিশনাল ফরম্যাট গ্রেডিয়েন্ট ইন্টারপোলেশন প্রকারগুলোর একটি তালিকা।
`Pivot Table Summarize Function`	`Pivot Table Summarize Function`	পিভট টেবিলে মানগুলোর সারসংক্ষেপ করতে যে ফাংশনগুলো ব্যবহার করা যেতে পারে, তার একটি তালিকা।
`Pivot Value Display Type`	`Pivot Value Display Type`	যে যে উপায়ে একটি পিভট মান প্রদর্শন করা যেতে পারে, তার একটি তালিকা।
`Protection Type`	`Protection Type`	একটি স্প্রেডশিটের সেই অংশগুলিকে প্রতিনিধিত্বকারী একটি তালিকা, যেগুলিকে সম্পাদনা থেকে সুরক্ষিত রাখা যায়।
`Recalculation Interval`	`Recalculation Interval`	স্প্রেডশিটে পুনর্গণনার জন্য ব্যবহারযোগ্য সম্ভাব্য ব্যবধানগুলোর একটি তালিকা।
`Relative Date`	`Relative Date`	তারিখ-ভিত্তিক `Boolean Criteria` ব্যবহৃতব্য মান গণনা করার জন্য আপেক্ষিক তারিখ বিকল্পগুলির একটি তালিকা।
`Sheet Type`	`Sheet Type`	একটি স্প্রেডশিটে যে বিভিন্ন ধরণের শীট থাকতে পারে তার একটি তালিকা।
`Sort Order`	`Sort Order`	সাজানোর ক্রমের একটি তালিকা।
`Text Direction`	`Text Direction`	বৈধ পাঠ্য নির্দেশাবলীর একটি তালিকা।
`Text To Columns Delimiter`	`Text To Columns Delimiter`	টেক্সটকে কলামে বিভক্ত করার জন্য পূর্বনির্ধারিত বিভাজকগুলোর একটি তালিকা।
`Theme Color Type`	`Theme Color Type`	সম্ভাব্য থিম রঙের প্রকারভেদগুলোর একটি তালিকা।
`Value Type`	`Value Type`	Spreadsheet সার্ভিসের Range ক্লাসের `Range.getValue()` এবং `Range.getValues()` দ্বারা ফেরত আসা ভ্যালু টাইপগুলোর একটি তালিকা। নিচে তালিকাভুক্ত তালিকা ভ্যালুগুলো `Number` , `Boolean` , `Date` , বা `String` ছাড়াও অন্তর্ভুক্ত।
`Wrap Strategy`	`Wrap Strategy`	কোষ আবৃত করার জন্য ব্যবহৃত কৌশলগুলোর একটি তালিকা।

পদ্ধতি

পদ্ধতি	রিটার্ন টাইপ	সংক্ষিপ্ত বিবরণ
`create(name)`	`Spreadsheet`	প্রদত্ত নামে একটি নতুন স্প্রেডশীট তৈরি করে।
`create(name, rows, columns)`	`Spreadsheet`	প্রদত্ত নাম এবং নির্দিষ্ট সংখ্যক সারি ও কলাম সহ একটি নতুন স্প্রেডশীট তৈরি করে।
`enable All Data Sources Execution()`	`void`	সব ধরনের ডেটা সোর্সের জন্য ডেটা এক্সিকিউশন চালু করে।
`enable Big Query Execution()`	`void`	BigQuery ডেটা সোর্সগুলির জন্য ডেটা এক্সিকিউশন চালু করে।
`enable Looker Execution()`	`void`	লুকার ডেটা সোর্সগুলির জন্য ডেটা এক্সিকিউশন চালু করে।
`flush()`	`void`	স্প্রেডশিটের সমস্ত মুলতুবি থাকা পরিবর্তন প্রয়োগ করে।
`get Active()`	`Spreadsheet`	বর্তমানে সক্রিয় স্প্রেডশীটটি ফেরত দেয়, অথবা কোনোটি না থাকলে `null` ফেরত দেয়।
`get Active Range()`	`Range`	সক্রিয় শীটে নির্বাচিত রেঞ্জটি ফেরত দেয়, অথবা কোনো সক্রিয় রেঞ্জ না থাকলে `null` ফেরত দেয়।
`get Active Range List()`	`Range List \|null`	সক্রিয় শীটে থাকা সক্রিয় রেঞ্জগুলোর তালিকা ফেরত দেয়, অথবা কোনো রেঞ্জ নির্বাচিত না থাকলে `null` ফেরত দেয়।
`get Active Sheet()`	`Sheet`	একটি স্প্রেডশিটের সক্রিয় শীটটি খুঁজে বের করে।
`get Active Spreadsheet()`	`Spreadsheet`	বর্তমানে সক্রিয় স্প্রেডশীটটি ফেরত দেয়, অথবা কোনোটি না থাকলে `null` ফেরত দেয়।
`get Current Cell()`	`Range \|null`	সক্রিয় শীটের সক্রিয় রেঞ্জগুলোর মধ্যে থেকে নির্বাচিত বর্তমান (হাইলাইট করা) সেলটি ফেরত দেয়, অথবা কোনো বর্তমান সেল না থাকলে `null` ফেরত দেয়।
`get Selection()`	`Selection`	স্প্রেডশিটে বর্তমানে `Selection` ফেরত দেয়।
`get Ui()`	`Ui`	স্প্রেডশীটের ইউজার-ইন্টারফেস এনভায়রনমেন্টের একটি ইনস্ট্যান্স ফেরত দেয়, যা স্ক্রিপ্টটিকে মেনু, ডায়ালগ এবং সাইডবারের মতো বৈশিষ্ট্য যোগ করার সুযোগ দেয়।
`new Cell Image()`	`Cell Image Builder`	`Cell Image` জন্য একটি বিল্ডার তৈরি করে।
`new Color()`	`Color Builder`	একটি `Color` জন্য বিল্ডার তৈরি করে।
`new Conditional Format Rule()`	`Conditional Format Rule Builder`	শর্তসাপেক্ষ ফরম্যাটিং নিয়মের জন্য একটি বিল্ডার তৈরি করে।
`new Data Source Spec()`	`Data Source Spec Builder`	`Data Source Spec` এর জন্য একটি বিল্ডার তৈরি করে।
`new Data Validation()`	`Data Validation Builder`	ডেটা যাচাইকরণ নিয়মের জন্য একটি বিল্ডার তৈরি করে।
`new Filter Criteria()`	`Filter Criteria Builder`	`Filter Criteria` জন্য একটি বিল্ডার তৈরি করে।
`new Rich Text Value()`	`Rich Text Value Builder`	রিচ টেক্সট ভ্যালুর জন্য একটি বিল্ডার তৈরি করে।
`new Text Style()`	`Text Style Builder`	টেক্সট স্টাইলের জন্য একটি বিল্ডার তৈরি করে।
`open(file)`	`Spreadsheet`	প্রদত্ত ফাইল অবজেক্টের সাথে সংশ্লিষ্ট স্প্রেডশীটটি খোলে।
`open By Id(id)`	`Spreadsheet`	প্রদত্ত আইডি দিয়ে স্প্রেডশিটটি খোলে।
`open By Url(url)`	`Spreadsheet`	প্রদত্ত URL-সহ স্প্রেডশিটটি খোলে।
`set Active Range(range)`	`Range`	নির্দিষ্ট রেঞ্জটিকে `active range` হিসেবে সেট করে এবং উক্ত রেঞ্জের উপরের বাম দিকের সেলটি `current cell` হিসেবে নির্ধারিত হয়।
`set Active Range List(rangeList)`	`Range List`	নির্দিষ্ট রেঞ্জগুলির তালিকাটিকে `active ranges` হিসাবে সেট করে।
`set Active Sheet(sheet)`	`Sheet`	একটি স্প্রেডশিটে সক্রিয় শীট নির্ধারণ করে।
`set Active Sheet(sheet, restoreSelection)`	`Sheet`	একটি স্প্রেডশীটে সক্রিয় শীট নির্ধারণ করে, এবং সেই শীটের মধ্যে সর্বশেষ নির্বাচিত অংশটি পুনরুদ্ধার করার বিকল্পও দেয়।
`set Active Spreadsheet(newActiveSpreadsheet)`	`void`	সক্রিয় স্প্রেডশীট নির্ধারণ করে।
`set Current Cell(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());

প্যারামিটার

নাম	প্রকার	বর্ণনা
`name`	`String`	স্প্রেডশিটটির নাম।

ফেরত

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());

প্যারামিটার

নাম	প্রকার	বর্ণনা
`name`	`String`	স্প্রেডশিটটির নাম।
`rows`	`Integer`	স্প্রেডশিটটির সারির সংখ্যা।
`columns`	`Integer`	স্প্রেডশিটটির কলাম সংখ্যা।

ফেরত

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 ডেটা সোর্স চালু না থাকলে, তার ডেটা এক্সিকিউশন একটি এক্সেপশন থ্রো করে।

// 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 |null — সক্রিয় রেঞ্জগুলোর তালিকা।

অনুমোদন

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

`getActiveSheet()`

একটি স্প্রেডশিটের সক্রিয় শীটটি খুঁজে বের করে।

একটি স্প্রেডশীটের সক্রিয় শীট হলো সেই শীটটি যা স্প্রেডশীট UI-তে প্রদর্শিত হচ্ছে।

// 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()`

যেসব ফাংশন স্প্রেডশীটের প্রেক্ষাপটে চালানো হয়, সেগুলো এই ফাংশনটি কল করার মাধ্যমে সংশ্লিষ্ট 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 |null — বর্তমান সেল।

অনুমোদন

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()`

স্প্রেডশীটের ইউজার-ইন্টারফেস এনভায়রনমেন্টের একটি ইনস্ট্যান্স ফেরত দেয়, যা স্ক্রিপ্টটিকে মেনু, ডায়ালগ এবং সাইডবারের মতো ফিচার যোগ করার সুযোগ দেয়। একটি স্ক্রিপ্ট শুধুমাত্র খোলা স্প্রেডশীটের বর্তমান ইনস্ট্যান্সের UI-এর সাথে ইন্টারঅ্যাক্ট করতে পারে, এবং তাও কেবল যদি স্ক্রিপ্টটি স্প্রেডশীটটির সাথে বাইন্ড করা থাকে। আরও তথ্যের জন্য, মেনু , ডায়ালগ এবং সাইডবার সম্পর্কিত গাইডগুলো দেখুন।

// 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)`

প্রদত্ত ফাইল অবজেক্টের সাথে সংশ্লিষ্ট স্প্রেডশীটটি খোলে।

// 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());
}

প্যারামিটার

নাম	প্রকার	বর্ণনা
`file`	`File`	খোলার জন্য ফাইলটি।

ফেরত

Spreadsheet — স্প্রেডশিটটি।

অনুমোদন

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

`openById(id)`

প্রদত্ত আইডি সহ স্প্রেডশীটটি খোলে। একটি স্প্রেডশীট আইডি তার URL থেকে বের করা যেতে পারে। উদাহরণস্বরূপ, https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 এই URL-এর স্প্রেডশীট আইডি হল "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());

প্যারামিটার

নাম	প্রকার	বর্ণনা
`id`	`String`	স্প্রেডশিটটির অনন্য শনাক্তকারী।

ফেরত

Spreadsheet — প্রদত্ত আইডিযুক্ত স্প্রেডশিট অবজেক্টটি।

অনুমোদন

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

`openByUrl(url)`

প্রদত্ত URL দিয়ে স্প্রেডশিটটি খোলে। যদি URL-টি বিদ্যমান না থাকে অথবা ব্যবহারকারীর এটি অ্যাক্সেস করার অনুমতি না থাকে, তাহলে একটি স্ক্রিপ্টিং ব্যতিক্রম (scripting exception) দেখায়।

// 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());

প্যারামিটার

নাম	প্রকার	বর্ণনা
`url`	`String`	স্প্রেডশিটটির ইউআরএল।

ফেরত

Spreadsheet — প্রদত্ত URL-যুক্ত স্প্রেডশিট অবজেক্টটি।

অনুমোদন

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

`setActiveRange(range)`

নির্দিষ্ট রেঞ্জটিকে active range হিসেবে সেট করে এবং উক্ত রেঞ্জের উপরের বাম দিকের সেলটি current cell হিসেবে নির্ধারিত হয়।

স্প্রেডশীট UI নির্বাচিত রেঞ্জ ধারণকারী শীটটি প্রদর্শন করে এবং সেই রেঞ্জে সংজ্ঞায়িত সেলগুলো নির্বাচন করে।

// 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();

প্যারামিটার

নাম	প্রকার	বর্ণনা
`range`	`Range`	পরিসরটিকে সক্রিয় পরিসর হিসেবে তৈরি করতে হবে।

ফেরত

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();

প্যারামিটার

নাম	প্রকার	বর্ণনা
`range List`	`Range List`	নির্বাচন করার জন্য পরিসরের তালিকা।

ফেরত

RangeList — নতুন নির্বাচিত রেঞ্জসমূহের তালিকা।

অনুমোদন

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

`setActiveSheet(sheet)`

একটি স্প্রেডশিটে সক্রিয় শীট নির্ধারণ করে। নির্বাচিত শীটটি যদি অন্য কোনো স্প্রেডশিটের না হয়, তবে গুগল শীটস ইউআই সেটিই প্রদর্শন করে।

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

প্যারামিটার

নাম	প্রকার	বর্ণনা
`sheet`	`Sheet`	নতুন সক্রিয় শীট।

ফেরত

Sheet — যে শীটটিকে নতুন সক্রিয় শীট হিসেবে তৈরি করা হয়েছে।

`setActiveSheet(sheet, restoreSelection)`

একটি স্প্রেডশিটে সক্রিয় শীট সেট করে, এবং সেই শীটের মধ্যে সর্বশেষ নির্বাচনটি পুনরুদ্ধার করার বিকল্পও থাকে। নির্বাচিত শীটটি যদি অন্য কোনো স্প্রেডশিটের না হয়, তবে গুগল শীটস ইউআই সেটিই প্রদর্শন করে।

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());

প্যারামিটার

নাম	প্রকার	বর্ণনা
`sheet`	`Sheet`	নতুন সক্রিয় শীট।
`restore Selection`	`Boolean`	যদি `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);

প্যারামিটার

নাম	প্রকার	বর্ণনা
`new Active Spreadsheet`	`Spreadsheet`	স্প্রেডশিটটিকে সক্রিয় স্প্রেডশিট হিসেবে তৈরি করতে হবে।

`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();

প্যারামিটার

নাম	প্রকার	বর্ণনা
`cell`	`Range`	যে সেলটিকে বর্তমান সেল হিসেবে সেট করতে হবে।

ফেরত

Range — নতুনভাবে সেট করা বর্তমান সেল।

অনুমোদন

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