Google পত্রক ফাইলগুলি অ্যাক্সেস করুন এবং তৈরি করুন৷ এই ক্লাসটি স্প্রেডশীট পরিষেবার জন্য মূল শ্রেণী।
বৈশিষ্ট্য
সম্পত্তি | টাইপ | বর্ণনা |
---|---|---|
AutoFillSeries | AutoFillSeries | স্বয়ংক্রিয়-পূর্ণ মান গণনা করতে ব্যবহৃত সিরিজের প্রকারের একটি গণনা। |
BandingTheme | BandingTheme | সম্ভাব্য ব্যান্ডিং থিমগুলির একটি গণনা। |
BooleanCriteria | BooleanCriteria | শর্তসাপেক্ষ বিন্যাস বুলিয়ান মানদণ্ডের একটি গণনা। |
BorderStyle | BorderStyle | একটি Range সীমানা নির্ধারণের জন্য বৈধ শৈলীগুলির একটি গণনা। |
ColorType | ColorType | সম্ভাব্য রঙের প্রকারের একটি গণনা। |
CopyPasteType | CopyPasteType | সম্ভাব্য পেস্ট ধরনের একটি গণনা. |
DataExecutionErrorCode | DataExecutionErrorCode | সম্ভাব্য ডেটা এক্সিকিউশন ত্রুটি কোডগুলির একটি গণনা। |
DataExecutionState | DataExecutionState | সম্ভাব্য ডেটা এক্সিকিউশন স্টেটের একটি গণনা। |
DataSourceParameterType | DataSourceParameterType | সম্ভাব্য ডেটা সোর্স প্যারামিটার প্রকারের একটি গণনা। |
DataSourceRefreshScope | DataSourceRefreshScope | সম্ভাব্য ডেটা সোর্স রিফ্রেশ স্কোপের একটি গণনা। |
DataSourceType | DataSourceType | সম্ভাব্য তথ্য উৎস প্রকারের একটি গণনা। |
DataValidationCriteria | DataValidationCriteria | ডেটা যাচাইকরণের মানদণ্ডের প্রতিনিধিত্বকারী একটি গণনা যা একটি পরিসরে সেট করা যেতে পারে। |
DateTimeGroupingRuleType | DateTimeGroupingRuleType | তারিখ সময় গ্রুপিং নিয়ম একটি গণনা. |
DeveloperMetadataLocationType | DeveloperMetadataLocationType | সম্ভাব্য বিকাশকারী মেটাডেটা অবস্থান প্রকারের একটি গণনা। |
DeveloperMetadataVisibility | DeveloperMetadataVisibility | সম্ভাব্য বিকাশকারী মেটাডেটা দৃশ্যমানতার একটি গণনা। |
Dimension | Dimension | একটি স্প্রেডশীটের সম্ভাব্য মাত্রার একটি গণনা। |
Direction | Direction | সম্ভাব্য দিকনির্দেশের একটি গণনা যা তীর কী ব্যবহার করে স্প্রেডশীটের মধ্যে স্থানান্তর করতে পারে। |
FrequencyType | FrequencyType | সম্ভাব্য ফ্রিকোয়েন্সি প্রকারের একটি গণনা। |
GroupControlTogglePosition | GroupControlTogglePosition | গ্রুপ কন্ট্রোল টগল যে অবস্থানে থাকতে পারে তার একটি গণনা। |
InterpolationType | InterpolationType | শর্তাধীন বিন্যাস গ্রেডিয়েন্ট ইন্টারপোলেশন প্রকারের একটি গণনা। |
PivotTableSummarizeFunction | PivotTableSummarizeFunction | একটি পিভট টেবিলে মান সংক্ষিপ্ত করতে ব্যবহৃত ফাংশনগুলির একটি গণনা৷ |
PivotValueDisplayType | PivotValueDisplayType | একটি পিভট মান প্রদর্শিত হতে পারে এমন উপায়গুলির একটি গণনা৷ |
ProtectionType | ProtectionType | একটি স্প্রেডশীটের অংশগুলির প্রতিনিধিত্বকারী একটি গণনা যা সম্পাদনা থেকে সুরক্ষিত হতে পারে। |
RecalculationInterval | RecalculationInterval | সম্ভাব্য বিরতির একটি গণনা যা স্প্রেডশীট পুনঃগণনাতে ব্যবহার করা যেতে পারে। |
RelativeDate | RelativeDate | তারিখ-ভিত্তিক BooleanCriteria ব্যবহার করা একটি মান গণনা করার জন্য আপেক্ষিক তারিখ বিকল্পগুলির একটি গণনা। |
SheetType | SheetType | একটি স্প্রেডশীটে বিদ্যমান বিভিন্ন ধরণের শীটগুলির একটি গণনা৷ |
SortOrder | SortOrder | সাজানোর ক্রম একটি গণনা. |
TextDirection | TextDirection | বৈধ পাঠ্য দিকনির্দেশের একটি গণনা। |
TextToColumnsDelimiter | TextToColumnsDelimiter | কলামে বিভক্ত পাঠ্যের জন্য প্রিসেট ডিলিমিটারের একটি গণনা। |
ThemeColorType | ThemeColorType | সম্ভাব্য থিমের রঙের প্রকারের একটি গণনা। |
ValueType | ValueType | স্প্রেডশীট পরিষেবার রেঞ্জ ক্লাস থেকে Range.getValue() এবং Range.getValues() দ্বারা প্রত্যাবর্তিত মান প্রকারের একটি গণনা৷ নীচে তালিকাভুক্ত গণনার মানগুলি Number , Boolean , Date বা String ছাড়াও রয়েছে। |
WrapStrategy | WrapStrategy | ঘর মোড়ানোর জন্য ব্যবহৃত কৌশলগুলির একটি গণনা। |
পদ্ধতি
পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বিবরণ |
---|---|---|
create(name) | Spreadsheet | প্রদত্ত নামের সাথে একটি নতুন স্প্রেডশীট তৈরি করে। |
create(name, rows, columns) | Spreadsheet | প্রদত্ত নাম এবং সারি এবং কলামের নির্দিষ্ট সংখ্যা সহ একটি নতুন স্প্রেডশীট তৈরি করে। |
enableAllDataSourcesExecution() | void | সব ধরনের ডেটা উৎসের জন্য ডেটা এক্সিকিউশন চালু করে। |
enableBigQueryExecution() | void | BigQuery ডেটা উৎসের জন্য ডেটা এক্সিকিউশন চালু করে। |
enableLookerExecution() | void | Looker ডেটা উৎসের জন্য ডেটা এক্সিকিউশন চালু করে। |
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() | CellImageBuilder | একটি CellImage জন্য একজন নির্মাতা তৈরি করে। |
newColor() | ColorBuilder | একটি Color জন্য একটি নির্মাতা তৈরি করে। |
newConditionalFormatRule() | ConditionalFormatRuleBuilder | শর্তসাপেক্ষ বিন্যাস নিয়মের জন্য একজন নির্মাতা তৈরি করে। |
newDataSourceSpec() | DataSourceSpecBuilder | একটি DataSourceSpec জন্য একটি নির্মাতা তৈরি করে। |
newDataValidation() | DataValidationBuilder | একটি ডেটা যাচাইকরণ নিয়মের জন্য একটি নির্মাতা তৈরি করে। |
newFilterCriteria() | FilterCriteriaBuilder | একটি FilterCriteria জন্য একটি নির্মাতা তৈরি করে। |
newRichTextValue() | RichTextValueBuilder | একটি সমৃদ্ধ পাঠ্য মানের জন্য একটি নির্মাতা তৈরি করে। |
newTextStyle() | TextStyleBuilder | একটি পাঠ্য শৈলীর জন্য একটি নির্মাতা তৈরি করে। |
open(file) | Spreadsheet | প্রদত্ত ফাইল অবজেক্টের সাথে সম্পর্কিত স্প্রেডশীট খোলে। |
openById(id) | Spreadsheet | প্রদত্ত আইডি দিয়ে স্প্রেডশীট খোলে। |
openByUrl(url) | Spreadsheet | প্রদত্ত URL দিয়ে স্প্রেডশীট খোলে। |
setActiveRange(range) | Range | current cell হিসাবে ব্যাপ্তির উপরের বাম কক্ষের সাথে active range হিসাবে নির্দিষ্ট পরিসর সেট করে। |
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 var 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 var 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() { var sheet = SpreadsheetApp.getActiveSheet(); for (var 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. var 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. var rangeList = SpreadsheetApp.getActiveRangeList();
প্রত্যাবর্তন
RangeList
— সক্রিয় ব্যাপ্তির তালিকা
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
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()
বর্তমানে সক্রিয় স্প্রেডশীট ফেরত দেয়, অথবা কোনোটি না থাকলে 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. var currentCell = SpreadsheetApp.getCurrentCell();
প্রত্যাবর্তন
Range
— বর্তমান কোষ
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
স্প্রেডশীটে বর্তমান Selection
প্রদান করে।
var selection = SpreadsheetApp.getSelection(); var 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
জন্য একটি নির্মাতা তৈরি করে।
var 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. var sheet = SpreadsheetApp.getActive().getActiveSheet(); var range = sheet.getRange('A1:B3'); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build() var 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()
একটি ডেটা যাচাইকরণ নিয়মের জন্য একটি নির্মাতা তৈরি করে।
var cell = SpreadsheetApp.getActive().getRange('A1'); var 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. var cell = SpreadsheetApp.getActive().getRange('A1'); var bold = SpreadsheetApp.newTextStyle().setBold(true).build(); var 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. var range = SpreadsheetApp.getActive().getRange('A1:B3'); var 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. var files = DriveApp.searchFiles( 'starred = true and mimeType = "' + MimeType.GOOGLE_SHEETS + '"'); while (files.hasNext()) { var spreadsheet = SpreadsheetApp.open(files.next()); var sheet = spreadsheet.getSheets()[0]; Logger.log(sheet.getName()); }
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
file | File | ফাইলটি খুলতে হবে। |
প্রত্যাবর্তন
Spreadsheet
- স্প্রেডশীট
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/spreadsheets
openById(id)
প্রদত্ত আইডি দিয়ে স্প্রেডশীট খোলে। একটি স্প্রেডশীট আইডি এর URL থেকে বের করা যেতে পারে। উদাহরণস্বরূপ, URL 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). var ss = SpreadsheetApp.openById("abc1234567"); Logger.log(ss.getName());
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
id | String | স্প্রেডশীটের অনন্য শনাক্তকারী। |
প্রত্যাবর্তন
Spreadsheet
— প্রদত্ত আইডি সহ স্প্রেডশীট বস্তু
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/spreadsheets
openByUrl(url)
প্রদত্ত URL দিয়ে স্প্রেডশীট খোলে। 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). var ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc1234567/edit'); console.log(ss.getName());
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
url | String | স্প্রেডশীটের URL। |
প্রত্যাবর্তন
Spreadsheet
- প্রদত্ত URL সহ স্প্রেডশীট বস্তু।
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
current cell
হিসাবে ব্যাপ্তির উপরের বাম কক্ষের সাথে active range
হিসাবে নির্দিষ্ট পরিসর সেট করে।
স্প্রেডশীট UI সেই শীটটি প্রদর্শন করে যাতে নির্বাচিত পরিসর রয়েছে এবং নির্বাচিত পরিসরে সংজ্ঞায়িত কক্ষগুলি নির্বাচন করে।
// The code below sets range C1:D4 in the first sheet as the active range. var range = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('C1:D4'); SpreadsheetApp.setActiveRange(range); var selection = SpreadsheetApp.getSelection(); // Current cell: C1 var currentCell = selection.getCurrentCell(); // Active Range: C1:D4 var 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. var rangeList = SpreadsheetApp.getActiveSheet().getRanges(['D4', 'B2:C4']); SpreadsheetApp.setActiveRangeList(rangeList); var selection = SpreadsheetApp.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
rangeList | RangeList | নির্বাচন করার জন্য ব্যাপ্তির তালিকা। |
প্রত্যাবর্তন
RangeList
— নতুন নির্বাচিত রেঞ্জের তালিকা
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSheet(sheet)
একটি স্প্রেডশীটে সক্রিয় শীট সেট করে। Google শীট UI নির্বাচিত শীটটি প্রদর্শন করে যদি না শীটটি একটি ভিন্ন স্প্রেডশীটের অন্তর্গত হয়৷
// The code below makes the 2nd sheet active in the active spreadsheet. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); SpreadsheetApp.setActiveSheet(spreadsheet.getSheets()[1]);
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
sheet | Sheet | নতুন সক্রিয় শীট. |
প্রত্যাবর্তন
Sheet
- যে শীটটিকে নতুন সক্রিয় শীট করা হয়েছে
setActiveSheet(sheet, restoreSelection)
একটি স্প্রেডশীটে সক্রিয় শীট সেট করে, সেই শীটের মধ্যে সবচেয়ে সাম্প্রতিক নির্বাচন পুনরুদ্ধার করার বিকল্প সহ। Google শীট UI নির্বাচিত শীটটি প্রদর্শন করে যদি না শীটটি একটি ভিন্ন স্প্রেডশীটের অন্তর্গত হয়৷
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var firstSheet = spreadsheet.getSheets()[0]; var 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 var range = spreadsheet.getActiveSheet().getSelection().getActiveRange(); Logger.log(range.getA1Notation());
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
sheet | Sheet | নতুন সক্রিয় শীট. |
restoreSelection | 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 var ss = SpreadsheetApp.openById("1234567890"); SpreadsheetApp.setActiveSpreadsheet(ss);
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
newActiveSpreadsheet | Spreadsheet | যে স্প্রেডশীটটিকে সক্রিয় স্প্রেডশীট করা হবে। |
setCurrentCell(cell)
নির্দিষ্ট ঘরটিকে current cell
হিসাবে সেট করে।
যদি নির্দিষ্ট সেলটি ইতিমধ্যেই নির্বাচিত পরিসরে উপস্থিত থাকে, তাহলে সেই পরিসরটি বর্তমান সেল হিসাবে সেলের সাথে সক্রিয় পরিসরে পরিণত হয়।
যদি নির্দিষ্ট ঘরটি কোনো নির্বাচিত পরিসরে উপস্থিত না থাকে, তাহলে বিদ্যমান নির্বাচনটি সরানো হয় এবং সেলটি বর্তমান কোষ এবং সক্রিয় পরিসরে পরিণত হয়।
দ্রষ্টব্য: নির্দিষ্ট Range
অবশ্যই একটি ঘর থাকতে হবে, অন্যথায় এই পদ্ধতিটি একটি ব্যতিক্রম নিক্ষেপ করে।
// The code below sets the cell B5 in the first sheet as the current cell. var cell = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('B5'); SpreadsheetApp.setCurrentCell(cell); var selection = SpreadsheetApp.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
cell | Range | বর্তমান কক্ষ হিসাবে সেট করা ঘর। |
প্রত্যাবর্তন
Range
— নতুন সেট করা বর্তমান সেল
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets