Class DataSourceSheet

ডেটা উৎস শীট

বিদ্যমান ডেটা সোর্স শীট অ্যাক্সেস এবং পরিবর্তন করুন। নতুন ডেটা সোর্স শীট তৈরি করতে, Spreadsheet.insertDataSourceSheet(spec) ব্যবহার করুন।

এই ক্লাসটি শুধুমাত্র ডাটাবেসের সাথে সংযুক্ত ডেটার ক্ষেত্রেই ব্যবহার করুন।

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Filter(columnName, filterCriteria) Data Source Sheet ডেটা সোর্স শীটে একটি ফিল্টার প্রয়োগ করে।
as Sheet() Sheet ডেটা সোর্স শীটটিকে একটি সাধারণ শীট অবজেক্ট হিসেবে ফেরত দেয়।
auto Resize Column(columnName) Data Source Sheet নির্দিষ্ট কলামের প্রস্থ স্বয়ংক্রিয়ভাবে পরিবর্তন করে।
auto Resize Columns(columnNames) Data Source Sheet নির্দিষ্ট কলামগুলোর প্রস্থ স্বয়ংক্রিয়ভাবে পরিবর্তন করে।
cancel Data Refresh() Data Source Sheet এই অবজেক্টের সাথে যুক্ত ডেটা রিফ্রেশটি বর্তমানে চালু থাকলে তা বাতিল করে।
force Refresh Data() Data Source Sheet বর্তমান অবস্থা নির্বিশেষে এই অবজেক্টের ডেটা রিফ্রেশ করে।
get Column Width(columnName) Integer|null নির্দিষ্ট কলামের প্রস্থ ফেরত দেয়।
get Data Source() Data Source অবজেক্টটি যে ডেটা সোর্সের সাথে লিঙ্ক করা আছে, তা পাওয়া যায়।
get Filters() Data Source Sheet Filter[] ডেটা সোর্স শীটে প্রয়োগ করা সমস্ত ফিল্টার ফেরত দেয়।
get Sheet Values(columnName) Object[] প্রদত্ত কলাম নামের জন্য ডেটা সোর্স শীটের সমস্ত মান ফেরত দেয়।
get Sheet Values(columnName, startRow, numRows) Object[] প্রদত্ত কলাম নামের জন্য, প্রদত্ত শুরুর সারি (ভিত্তিক-১) থেকে শুরু করে প্রদত্ত num Rows পর্যন্ত ডেটা সোর্স শীটের সমস্ত মান ফেরত দেয়।
get Sort Specs() Sort Spec[] ডেটা সোর্স শীট থেকে সমস্ত সর্ট স্পেসিফিকেশন সংগ্রহ করে।
get Status() Data Execution Status অবজেক্টটির ডেটা এক্সিকিউশন স্ট্যাটাস পাওয়া যায়।
refresh Data() Data Source Sheet অবজেক্টটির ডেটা রিফ্রেশ করে।
remove Filters(columnName) Data Source Sheet ডেটা সোর্স শীটের কলামে প্রয়োগ করা সমস্ত ফিল্টার মুছে দেয়।
remove Sort Spec(columnName) Data Source Sheet ডেটা সোর্স শীটের কোনো একটি কলাম থেকে সর্ট স্পেক মুছে দেয়।
set Column Width(columnName, width) Data Source Sheet নির্দিষ্ট কলামের প্রস্থ নির্ধারণ করে।
set Column Widths(columnNames, width) Data Source Sheet নির্দিষ্ট কলামগুলোর প্রস্থ নির্ধারণ করে।
set Sort Spec(columnName, ascending) Data Source Sheet ডেটা সোর্স শীটের কোনো একটি কলামের সর্ট স্পেক নির্ধারণ করে।
set Sort Spec(columnName, sortOrder) Data Source Sheet ডেটা সোর্স শীটের কোনো একটি কলামের সর্ট স্পেক নির্ধারণ করে।
wait For Completion(timeoutInSeconds) Data Execution Status বর্তমান কার্য সম্পাদন সম্পূর্ণ হওয়া পর্যন্ত অপেক্ষা করে এবং নির্দিষ্ট সংখ্যক সেকেন্ড পর সময়সীমা শেষ হয়ে যায়।

বিস্তারিত ডকুমেন্টেশন

addFilter(columnName, filterCriteria)

ডেটা সোর্স শীটে একটি ফিল্টার প্রয়োগ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String যে কলামে এই ফিল্টারটি প্রয়োগ করা হবে, তার নাম।
filter Criteria Filter Criteria প্রয়োগ করার জন্য ফিল্টার মানদণ্ড।

ফেরত

DataSourceSheet — মেথড চেইনিং-এর জন্য ডেটা সোর্স শিট।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

asSheet()

ডেটা সোর্স শীটটিকে একটি সাধারণ শীট অবজেক্ট হিসেবে ফেরত দেয়।

ফেরত

Sheet — সাধারণ চাদর।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

autoResizeColumn(columnName)

নির্দিষ্ট কলামের প্রস্থ স্বয়ংক্রিয়ভাবে পরিবর্তন করে।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String কলামের নাম।

ফেরত

DataSourceSheet — এটি ডেটা সোর্স শিট, যা চেইনিং-এর জন্য ব্যবহৃত হয়।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

autoResizeColumns(columnNames)

নির্দিষ্ট কলামগুলোর প্রস্থ স্বয়ংক্রিয়ভাবে পরিবর্তন করে।

প্যারামিটার

নাম প্রকার বর্ণনা
column Names String[] আপডেট করার জন্য কলামের নামগুলোর তালিকা।

ফেরত

DataSourceSheet — এটি ডেটা সোর্স শিট, যা চেইনিং-এর জন্য ব্যবহৃত হয়।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

cancelDataRefresh()

এই অবজেক্টের সাথে যুক্ত ডেটা রিফ্রেশটি বর্তমানে চালু থাকলে তা বাতিল করে।

এই উদাহরণটি দেখায় কিভাবে একটি ফর্মুলা রিফ্রেশ বাতিল করতে হয়।

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

ডেটা সোর্স টাইপটি সক্রিয় না থাকলে একটি এক্সেপশন থ্রো করে। নির্দিষ্ট ডেটা সোর্স টাইপের জন্য ডেটা এক্সিকিউশন সক্রিয় করতে SpreadsheetApp#enable...Execution() মেথড ব্যবহার করুন।

ফেরত

DataSourceSheet — ডেটা অবজেক্ট।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

forceRefreshData()

বর্তমান অবস্থা নির্বিশেষে এই অবজেক্টের ডেটা রিফ্রেশ করে। আরও বিস্তারিত জানতে refreshData() দেখুন। আপনি যদি এই অবজেক্টের বর্তমানে চলমান কোনো রিফ্রেশ বাতিল করতে চান, তাহলে cancelDataRefresh() দেখুন।

ডেটা সোর্স টাইপটি সক্রিয় না থাকলে একটি এক্সেপশন থ্রো করে। নির্দিষ্ট ডেটা সোর্স টাইপের জন্য ডেটা এক্সিকিউশন সক্রিয় করতে SpreadsheetApp#enable...Execution() মেথড ব্যবহার করুন।

ফেরত

DataSourceSheet — ডেটা অবজেক্ট।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

getColumnWidth(columnName)

নির্দিষ্ট কলামের প্রস্থ ফেরত দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String কলামের নাম।

ফেরত

Integer|null — কলামের প্রস্থ, অথবা কলামটি ডিফল্ট প্রস্থ ব্যবহার করলে null ।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

getDataSource()

অবজেক্টটি যে ডেটা সোর্সের সাথে লিঙ্ক করা আছে, তা পাওয়া যায়।

ফেরত

DataSource — তথ্যের উৎস।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

getFilters()

ডেটা সোর্স শীটে প্রয়োগ করা সমস্ত ফিল্টার ফেরত দেয়।

ফেরত

DataSourceSheetFilter[] — ডেটা সোর্স শীটে প্রয়োগ করা সমস্ত ফিল্টারের একটি অ্যারে।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

getSheetValues(columnName)

প্রদত্ত কলাম নামের জন্য ডেটা সোর্স শীটের সমস্ত মান ফেরত দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String যে ডেটা সোর্স কলামের জন্য মানগুলি আনা হবে তার নাম।

ফেরত

Object[] — মানসমূহের একটি একমাত্রিক অ্যারে।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

getSheetValues(columnName, startRow, numRows)

প্রদত্ত কলাম নামের জন্য, প্রদত্ত শুরুর সারি (ভিত্তিক-১) থেকে প্রদত্ত numRows পর্যন্ত ডেটা সোর্স শীটের সমস্ত মান ফেরত দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String যে ডেটা সোর্স কলামের জন্য মানগুলি আনা হবে তার নাম।
start Row Integer যে সারি থেকে মান আনা শুরু করতে হবে তার অবস্থান।
num Rows Integer আনার জন্য সারির সংখ্যা।

ফেরত

Object[] — মানসমূহের একটি একমাত্রিক অ্যারে।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

getSortSpecs()

ডেটা সোর্স শীট থেকে সমস্ত সর্ট স্পেসিফিকেশন সংগ্রহ করে।

ফেরত

SortSpec[] — সর্ট স্পেকসমূহের একটি তালিকা।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

getStatus()

অবজেক্টটির ডেটা এক্সিকিউশন স্ট্যাটাস পাওয়া যায়।

ফেরত

DataExecutionStatus — ডেটা সম্পাদনের অবস্থা।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

refreshData()

অবজেক্টটির ডেটা রিফ্রেশ করে।

বর্তমানে error অবস্থায় থাকলে একটি এক্সেপশন থ্রো করে। স্পেসিফিকেশন আপডেট করতে DataSource#updateSpec() ব্যবহার করুন। ডেটা সোর্সে অপ্রত্যাশিত পরিবর্তন রোধ করতে forceRefreshData() এর পরিবর্তে এই মেথডটি বেশি পছন্দনীয়।

ডেটা সোর্স টাইপটি সক্রিয় না থাকলে একটি এক্সেপশন থ্রো করে। নির্দিষ্ট ডেটা সোর্স টাইপের জন্য ডেটা এক্সিকিউশন সক্রিয় করতে SpreadsheetApp#enable...Execution() মেথড ব্যবহার করুন।

ফেরত

DataSourceSheet — ডেটা অবজেক্ট।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

removeFilters(columnName)

ডেটা সোর্স শীটের কলামে প্রয়োগ করা সমস্ত ফিল্টার মুছে দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String যে কলাম থেকে ফিল্টারগুলো সরানো হবে, তার নাম।

ফেরত

DataSourceSheet — মেথড চেইনিং-এর জন্য ডেটা সোর্স শিট।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

removeSortSpec(columnName)

ডেটা সোর্স শীটের কোনো একটি কলাম থেকে সর্ট স্পেক মুছে দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String কলামটির নাম।

ফেরত

DataSourceSheet — ডেটা সোর্স শিট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

setColumnWidth(columnName, width)

নির্দিষ্ট কলামের প্রস্থ নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String কলামের নাম।
width Integer কলামটির নতুন প্রস্থ।

ফেরত

DataSourceSheet — এটি ডেটা সোর্স শিট, যা চেইনিং-এর জন্য ব্যবহৃত হয়।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

setColumnWidths(columnNames, width)

নির্দিষ্ট কলামগুলোর প্রস্থ নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
column Names String[] আপডেট করার জন্য কলামের নামগুলোর তালিকা।
width Integer কলামগুলোর নতুন প্রস্থ।

ফেরত

DataSourceSheet — এটি ডেটা সোর্স শিট, যা চেইনিং-এর জন্য ব্যবহৃত হয়।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

setSortSpec(columnName, ascending)

ডেটা সোর্স শীটের কোনো একটি কলামের সর্ট স্পেক নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String যে কলামটি সর্ট করতে হবে তার নাম।
ascending Boolean যদি true , তাহলে কলামটি আরোহী ক্রমে সাজান; যদি false , তাহলে কলামটি অবরোহী ক্রমে সাজান।

ফেরত

DataSourceSheet — ডেটা সোর্স শিট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

setSortSpec(columnName, sortOrder)

ডেটা সোর্স শীটের কোনো একটি কলামের সর্ট স্পেক নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
column Name String যে কলামটি সর্ট করতে হবে তার নাম।
sort Order Sort Order সাজানোর ক্রম।

ফেরত

DataSourceSheet — ডেটা সোর্স শিট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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

waitForCompletion(timeoutInSeconds)

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

প্যারামিটার

নাম প্রকার বর্ণনা
timeout In Seconds Integer ডেটা সম্পাদনের জন্য অপেক্ষার সময়, সেকেন্ডে। সর্বোচ্চ সীমা হলো ৩০০ সেকেন্ড।

ফেরত

DataExecutionStatus — ডেটা সম্পাদনের অবস্থা।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

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