Class Document

নথি

একটি ডকুমেন্ট, যাতে এক বা একাধিক Tab অবজেক্ট থাকে, এবং সেগুলোর প্রতিটিতে রিচ টেক্সট ও টেবিল এবং লিস্টের মতো এলিমেন্ট থাকে।

DocumentApp ব্যবহার করে নথি খোলা বা তৈরি করা যেতে পারে।

// Open a document by ID.
let doc = DocumentApp.openById('<my-id>');

// Create and open a document.
doc = DocumentApp.create('Document Title');

Document ক্লাসের যে মেথডগুলো সরাসরি টেক্সট কন্টেন্ট অ্যাক্সেস ও মডিফাই করে, সেগুলো হয় অ্যাক্টিভ ট্যাবে (কোনো নির্দিষ্ট ডকুমেন্টের সাথে যুক্ত স্ক্রিপ্টে) অথবা প্রথম ট্যাবে (যদি কোনো অ্যাক্টিভ ট্যাব না থাকে) কাজ করে। যে স্ক্রিপ্টগুলো এই মেথডগুলোর উপর নির্ভর করে (উদাহরণস্বরূপ, getBody() ), getTabs() এবং তারপর Tab.asDocumentTab() ব্যবহার করে ট্যাব সাপোর্ট করার জন্য মাইগ্রেট করা যেতে পারে।

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Bookmark(position) Bookmark প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে প্রদত্ত Position একটি Bookmark যোগ করে।
add Editor(emailAddress) Document প্রদত্ত ব্যবহারকারীকে Document সম্পাদকদের তালিকায় যুক্ত করে।
add Editor(user) Document প্রদত্ত ব্যবহারকারীকে Document সম্পাদকদের তালিকায় যুক্ত করে।
add Editors(emailAddresses) Document প্রদত্ত ব্যবহারকারীদের অ্যারেটিকে Document সম্পাদকদের তালিকায় যুক্ত করে।
add Footer() Footer Section যদি কোনো ফুটার সেকশন না থাকে, তবে প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে একটি ফুটার সেকশন যোগ করে।
add Header() Header Section যদি কোনো হেডার সেকশন না থাকে, তবে এটি প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে একটি হেডার সেকশন যোগ করে।
add Named Range(name, range) Named Range একটি Named Range যোগ করে, যা হলো এমন একটি Range যার একটি নাম এবং আইডি থাকে এবং যা পরবর্তীতে খুঁজে বের করার জন্য ব্যবহার করা যায়। এটি প্রথম ট্যাবে অথবা, কোনো ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে যুক্ত হয়।
add Viewer(emailAddress) Document প্রদত্ত ব্যবহারকারীকে Document দর্শক তালিকায় যুক্ত করে।
add Viewer(user) Document প্রদত্ত ব্যবহারকারীকে Document দর্শক তালিকায় যুক্ত করে।
add Viewers(emailAddresses) Document Document ভিউয়ারদের তালিকায় প্রদত্ত ব্যবহারকারীদের অ্যারে যুক্ত করে।
get Active Tab() Tab |null ডকুমেন্টে ব্যবহারকারীর বর্তমানে সক্রিয় Tab খুঁজে বের করে।
get As(contentType) Blob বর্তমান Document বিষয়বস্তুকে নির্দিষ্ট ধরনের একটি ব্লব হিসেবে পুনরুদ্ধার করে।
get Blob() Blob বর্তমান Document বিষয়বস্তু একটি ব্লব হিসেবে পুনরুদ্ধার করে।
get Body() Body প্রথম ট্যাবের Body অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবের Document Body Section পুনরুদ্ধার করে।
get Bookmark(id) Bookmark |null প্রদত্ত আইডি সহ Bookmark প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে খুঁজে পায়।
get Bookmarks() Bookmark[] প্রথম ট্যাবে থাকা সমস্ত Bookmark অবজেক্ট পায় অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাব থেকে পায়।
get Cursor() Position |null ব্যবহারকারীর কার্সারটি সক্রিয় ট্যাবে নিয়ে আসে।
get Editors() User[] এই Document সম্পাদকদের তালিকা পাওয়া যায়।
get Footer() Footer Section |null প্রথম ট্যাবের ফুটার সেকশন অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবের ফুটার সেকশন পুনরুদ্ধার করে।
get Footnotes() Footnote[] প্রথম ট্যাবের মূল অংশে থাকা সমস্ত Footnote উপাদান পুনরুদ্ধার করে অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবের মূল অংশ থেকে উপাদান পুনরুদ্ধার করে।
get Header() Header Section |null প্রথম ট্যাবের হেডার সেকশন অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবের হেডার সেকশন পুনরুদ্ধার করে।
get Id() String ডকুমেন্টটির অনন্য শনাক্তকারী পুনরুদ্ধার করে।
get Language() String|null ডকুমেন্টটির ভাষা কোড পাওয়া যায়।
get Name() String ডকুমেন্টটির শিরোনাম পুনরুদ্ধার করে।
get Named Range By Id(id) Named Range |null প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে প্রদত্ত আইডি সহ Named Range খুঁজে বের করে।
get Named Ranges() Named Range[] প্রথম ট্যাবে থাকা সমস্ত Named Range অবজেক্ট পায় অথবা, ডকুমেন্টের সাথে আবদ্ধ স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে থাকা অবজেক্টগুলো পায়।
get Named Ranges(name) Named Range[] প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে আবদ্ধ স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে প্রদত্ত নামের সমস্ত Named Range অবজেক্ট খুঁজে বের করে।
get Selection() Range |null সক্রিয় ট্যাবে ব্যবহারকারীর নির্বাচন গ্রহণ করে।
get Supported Language Codes() String[] গুগল ডক্স ফাইলে সমর্থিত সমস্ত ভাষা কোড খুঁজে বের করে।
get Tab(tabId) Tab |null নির্দিষ্ট আইডি সহ Tab পাওয়া যায়।
get Tabs() Tab[] ডকুমেন্টের অংশ এমন সমস্ত নেস্টেড নয় এমন Tab খুঁজে বের করে।
get Url() String বর্তমান ডকুমেন্টটি অ্যাক্সেস করার জন্য URL পুনরুদ্ধার করে।
get Viewers() User[] এই Document দর্শক ও মন্তব্যকারীদের তালিকা পাওয়া যায়।
new Position(element, offset) Position একটি নতুন Position তৈরি করে, যা ট্যাবের ভেতরের কোনো একটি অবস্থানের রেফারেন্স। এটি প্রথম ট্যাবের একটি নির্দিষ্ট এলিমেন্টের সাপেক্ষে অথবা, ডকুমেন্টের সাথে আবদ্ধ স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবের সাপেক্ষে নির্ধারিত হয়।
new Range() Range Builder একটি বিল্ডার তৈরি করে যা প্রথম ট্যাবের ট্যাব এলিমেন্টগুলো থেকে অথবা, ডকুমেন্টের সাথে আবদ্ধ স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাব থেকে Range অবজেক্ট তৈরি করতে ব্যবহৃত হয়।
remove Editor(emailAddress) Document Document সম্পাদকদের তালিকা থেকে প্রদত্ত ব্যবহারকারীকে সরিয়ে দেয়।
remove Editor(user) Document Document সম্পাদকদের তালিকা থেকে প্রদত্ত ব্যবহারকারীকে সরিয়ে দেয়।
remove Viewer(emailAddress) Document Document দর্শক ও মন্তব্যকারীদের তালিকা থেকে প্রদত্ত ব্যবহারকারীকে সরিয়ে দেয়।
remove Viewer(user) Document Document দর্শক ও মন্তব্যকারীদের তালিকা থেকে প্রদত্ত ব্যবহারকারীকে সরিয়ে দেয়।
save And Close() void বর্তমান Document সংরক্ষণ করে।
set Active Tab(tabId) void বর্তমান ডকুমেন্টে ব্যবহারকারীর নির্বাচিত Tab নির্দিষ্ট আইডিযুক্ত ট্যাবটিতে সেট করে।
set Cursor(position) Document একটি Position দেওয়া থাকলে, ব্যবহারকারীর কার্সার সেট করে।
set Language(languageCode) Document ডকুমেন্টের ভাষা কোড নির্ধারণ করে।
set Name(name) Document ডকুমেন্টের শিরোনাম নির্ধারণ করে।
set Selection(range) Document একটি নির্দিষ্ট Range মধ্যে ব্যবহারকারীর নির্বাচনকে সক্রিয় ট্যাবে সেট করে।

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

addBookmark(position)

প্রদত্ত Position প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে একটি Bookmark যোগ করে। যেকোনো ট্যাবে বুকমার্ক যোগ করতে DocumentTab.addBookmark(position) মেথডটি ব্যবহার করুন।

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the active or first tab's body and adds a paragraph.
const paragraph = doc.getBody().appendParagraph('My new paragraph.');

// Creates a position at the first character of the paragraph text.
const position = doc.newPosition(paragraph.getChild(0), 0);

// Adds a bookmark at the first character of the paragraph text.
const bookmark = doc.addBookmark(position);

// Logs the bookmark ID to the console.
console.log(bookmark.getId());

প্যারামিটার

নাম প্রকার বর্ণনা
position Position নতুন বুকমার্কটির অবস্থান।

ফেরত

Bookmark — নতুন বুকমার্ক।

অনুমোদন

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

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

addEditor(emailAddress)

প্রদত্ত ব্যবহারকারীকে Document সম্পাদকদের তালিকায় যুক্ত করে। যদি ব্যবহারকারী আগে থেকেই দর্শকদের তালিকায় থাকেন, তবে এই পদ্ধতিটি তাকে দর্শকদের তালিকা থেকে সরিয়ে দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
email Address String যোগ করার জন্য ব্যবহারকারীর ইমেল ঠিকানা।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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

addEditor(user)

প্রদত্ত ব্যবহারকারীকে Document সম্পাদকদের তালিকায় যুক্ত করে। যদি ব্যবহারকারী আগে থেকেই দর্শকদের তালিকায় থাকেন, তবে এই পদ্ধতিটি তাকে দর্শকদের তালিকা থেকে সরিয়ে দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
user User যোগ করার জন্য ব্যবহারকারীর একটি উপস্থাপনা।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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

addEditors(emailAddresses)

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

প্যারামিটার

নাম প্রকার বর্ণনা
email Addresses String[] যোগ করার জন্য ব্যবহারকারীদের ইমেল ঠিকানাগুলোর একটি অ্যারে।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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

addFooter()

যদি কোনো ফুটার সেকশন না থাকে, তবে এটি প্রথম ট্যাবে অথবা ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে সক্রিয় ট্যাবে একটি ফুটার সেকশন যোগ করে। যেকোনো ট্যাবে ফুটার সেকশন যোগ করতে DocumentTab.addFooter() মেথডটি ব্যবহার করুন।

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Adds a footer to the document's active or first tab.
const footer = doc.addFooter();

// Sets the footer text to 'This is a footer.'
footer.setText('This is a footer');

ফেরত

FooterSection — ট্যাব ফুটার।

অনুমোদন

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

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

addHeader()

যদি কোনো হেডার সেকশন না থাকে, তবে এটি প্রথম ট্যাবে অথবা ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে সক্রিয় ট্যাবে একটি হেডার সেকশন যোগ করে। যেকোনো ট্যাবে হেডার সেকশন যোগ করতে DocumentTab.addHeader() মেথডটি ব্যবহার করুন।

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Adds a header to the document's active or first tab.
const header = doc.addHeader();

// Sets the header text to 'This is a header.'
header.setText('This is a header');

ফেরত

HeaderSection — ট্যাব হেডার।

অনুমোদন

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

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

addNamedRange(name, range)

এটি প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে একটি NamedRange হলো এমন একটি Range যার একটি নাম এবং আইডি থাকে, যা পরবর্তীতে খুঁজে বের করার জন্য ব্যবহৃত হয়। যেকোনো ট্যাবে একটি NamedRange যোগ করতে, DocumentTab.addNamedRange(name, range) মেথডটি ব্যবহার করুন। নামগুলো সবসময় অনন্য হয় না; একই ডকুমেন্টের মধ্যে বিভিন্ন রেঞ্জের একই নাম থাকতে পারে, অনেকটা HTML-এর ক্লাসের মতো। এর বিপরীতে, আইডিগুলো ডকুমেন্টের মধ্যে অনন্য হয়, যেমনটা HTML-এর আইডির ক্ষেত্রে হয়। ডকুমেন্টে একবার NamedRange যোগ করার পর, আপনি এটি পরিবর্তন করতে পারবেন না, শুধুমাত্র মুছে ফেলতে পারবেন।

যে কোনো স্ক্রিপ্ট যা ডকুমেন্টটি অ্যাক্সেস করে, তা একটি NamedRange অ্যাক্সেস করতে পারে। স্ক্রিপ্টগুলোর মধ্যে অনাকাঙ্ক্ষিত দ্বন্দ্ব এড়াতে, রেঞ্জের নামগুলোর আগে একটি অনন্য স্ট্রিং যোগ করার কথা বিবেচনা করুন।

// Creates a named range that includes every table in the active tab.
const doc = DocumentApp.getActiveDocument();
const rangeBuilder = doc.newRange();
const tables = doc.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
// Adds the named range to the document's active tab.
doc.addNamedRange('Document tables', rangeBuilder.build());

প্যারামিটার

নাম প্রকার বর্ণনা
name String রেঞ্জের নামটি অনন্য হওয়ার প্রয়োজন নেই; রেঞ্জের নাম অবশ্যই ১ থেকে ২৫৬ অক্ষরের মধ্যে হতে হবে।
range Range নামের সাথে যুক্ত করার জন্য উপাদানগুলির পরিসর; এই পরিসরটি হতে পারে সক্রিয় নির্বাচন , একটি অনুসন্ধানের ফলাফল , অথবা new Range() ব্যবহার করে ম্যানুয়ালি তৈরি করা।

ফেরত

NamedRange — দ্য NamedRange ।

অনুমোদন

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

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

addViewer(emailAddress)

প্রদত্ত ব্যবহারকারীকে Document দর্শক তালিকায় যুক্ত করে। যদি ব্যবহারকারী আগে থেকেই সম্পাদকদের তালিকায় থাকেন, তবে এই পদ্ধতির কোনো প্রভাব পড়ে না।

প্যারামিটার

নাম প্রকার বর্ণনা
email Address String যোগ করার জন্য ব্যবহারকারীর ইমেল ঠিকানা।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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

addViewer(user)

প্রদত্ত ব্যবহারকারীকে Document দর্শক তালিকায় যুক্ত করে। যদি ব্যবহারকারী আগে থেকেই সম্পাদকদের তালিকায় থাকেন, তবে এই পদ্ধতির কোনো প্রভাব পড়ে না।

প্যারামিটার

নাম প্রকার বর্ণনা
user User যোগ করার জন্য ব্যবহারকারীর একটি উপস্থাপনা।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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

addViewers(emailAddresses)

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

প্যারামিটার

নাম প্রকার বর্ণনা
email Addresses String[] যোগ করার জন্য ব্যবহারকারীদের ইমেল ঠিকানাগুলোর একটি অ্যারে।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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

getActiveTab()

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

// Display a dialog box that shows the title of the tab that the
// user is currently viewing.
const tab = DocumentApp.getActiveDocument().getActiveTab();
DocumentApp.getUi().alert(`ID of selected tab: ${tab.getTitle()}`);

ফেরত

Tab |null — ব্যবহারকারীর বর্তমানে সক্রিয় Tab , অথবা স্ক্রিপ্টটি ডকুমেন্টের সাথে আবদ্ধ না থাকলে null ।

অনুমোদন

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

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

getAs(contentType)

বর্তমান Document বিষয়বস্তুকে নির্দিষ্ট ধরনের একটি ব্লব হিসেবে পুনরুদ্ধার করে।

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the document as a PDF.
const pdf = doc.getAs('application/pdf');

// Logs the name of the PDF to the console.
console.log(pdf.getName());

প্যারামিটার

নাম প্রকার বর্ণনা
content Type String যে MIME টাইপে রূপান্তর করতে হবে; 'application/pdf' এবং 'text/markdown' সমর্থিত।

ফেরত

Blob — বর্তমান ডকুমেন্টটি একটি ব্লব হিসেবে।

getBlob()

বর্তমান Document বিষয়বস্তু একটি ব্লব হিসেবে পুনরুদ্ধার করে।

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Retrieves the current document's contents as a blob and logs it to the
// console.
console.log(doc.getBlob().getContentType());

ফেরত

Blob — বর্তমান ডকুমেন্টটি একটি ব্লব হিসেবে।

getBody()

প্রথম ট্যাবের Body অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবের DocumentBodySection পুনরুদ্ধার করে। যেকোনো ট্যাবের DocumentBodySection পেতে, DocumentTab.getBody() মেথডটি ব্যবহার করুন।

ট্যাবে বিভিন্ন ধরনের সেকশন থাকতে পারে (যেমন, HeaderSection , FooterSection )। একটি ট্যাবের সক্রিয় সেকশন হলো তার Body ।

Document এর এলিমেন্ট মেথডগুলো সক্রিয় Body কে দায়িত্ব অর্পণ করে।

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the active or first tab's body.
const body = doc.getBody();

// Gets the body text and logs it to the console.
console.log(body.getText());

ফেরত

Body — ট্যাবের মূল অংশ।

অনুমোদন

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

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

getBookmark(id)

প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে প্রদত্ত আইডি সহ Bookmark পাওয়া যায়। যেকোনো ট্যাবে বুকমার্ক পেতে, DocumentTab.getBookmark(id) মেথডটি ব্যবহার করুন। ট্যাবের মধ্যে এই ধরনের কোনো Bookmark না থাকলে এই মেথডটি null রিটার্ন করে। 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the bookmark by its ID in the document's active or first tab.
const bookmark = doc.getBookmark('id.xyz654321');

// If the bookmark exists, logs the character offset of its position to the
// console. otherwise, logs 'No bookmark exists with the given ID.' to the
// console.
if (bookmark) {
  console.log(bookmark.getPosition().getOffset());
} else {
  console.log('No bookmark exists with the given ID.');
}

প্যারামিটার

নাম প্রকার বর্ণনা
id String Bookmark আইডি।

ফেরত

Bookmark |null — প্রদত্ত আইডি সহ Bookmark , অথবা ট্যাবের মধ্যে এই ধরনের কোনো Bookmark না থাকলে null ।

অনুমোদন

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

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

getBookmarks()

প্রথম ট্যাবে থাকা সমস্ত Bookmark অবজেক্ট পায় অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে থাকা বুকমার্ক অবজেক্ট পায়। যেকোনো ট্যাবের সমস্ত বুকমার্ক পেতে, DocumentTab.getBookmarks() মেথডটি ব্যবহার করুন। 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
const doc = DocumentApp.openById('123abc');

// Gets all of the bookmarks in the document's active or first tab.
const bookmarks = doc.getBookmarks();

// Logs the number of bookmarks in the tab to the console.
console.log(bookmarks.length);

ফেরত

Bookmark[] — ট্যাবে থাকা Bookmark অবজেক্টগুলোর একটি অ্যারে।

অনুমোদন

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

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

getCursor()

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

// Insert some text at the cursor position and make it bold.
const cursor = DocumentApp.getActiveDocument().getCursor();
if (cursor) {
  // Attempt to insert text at the cursor position. If the insertion returns
  // null, the cursor's containing element doesn't allow insertions, so show the
  // user an error message.
  const element = cursor.insertText('ಠ‿ಠ');
  if (element) {
    element.setBold(true);
  } else {
    DocumentApp.getUi().alert('Cannot insert text here.');
  }
} else {
  DocumentApp.getUi().alert('Cannot find a cursor.');
}

ফেরত

Position |null — ব্যবহারকারীর কার্সরের একটি উপস্থাপনা, অথবা null যদি ব্যবহারকারী ট্যাবে কোনো কার্সর না রাখেন বা স্ক্রিপ্টটি ডকুমেন্টের সাথে আবদ্ধ না থাকে।

অনুমোদন

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

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

getEditors()

এই Document সম্পাদকদের তালিকা পাওয়া যায়।

ফেরত

User[] — সম্পাদনার অনুমতি আছে এমন ব্যবহারকারীদের একটি অ্যারে।

অনুমোদন

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

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

getFooter()

প্রথম ট্যাবের ফুটার সেকশন অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবের ফুটার সেকশন পুনরুদ্ধার করে। যেকোনো ট্যাবের ফুটার সেকশন পেতে DocumentTab.getFooter() মেথডটি ব্যবহার করুন। 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the text of the active or first tab's footer and logs it to the console.
console.log(doc.getFooter().getText());

ফেরত

FooterSection |null — ট্যাবটির ফুটার।

অনুমোদন

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

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

getFootnotes()

প্রথম ট্যাবের মূল অংশে থাকা সমস্ত Footnote উপাদান পুনরুদ্ধার করে অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবের মূল অংশ থেকে এটি পুনরুদ্ধার করে। যেকোনো ট্যাবের সমস্ত ফুটনোট পেতে, DocumentTab.getFootnotes() মেথডটি ব্যবহার করুন।

getFootnotes কল করলে ট্যাবের উপাদানগুলোর উপর পুনরাবৃত্তি ঘটে। বড় ট্যাবের ক্ষেত্রে, এই মেথডটির অপ্রয়োজনীয় কল এড়িয়ে চলুন। 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the first footnote in the active or first tab's body.
const footnote = doc.getFootnotes()[0];

// Logs footnote contents to the console.
console.log(footnote.getFootnoteContents().getText());

ফেরত

Footnote[] — ট্যাবটির পাদটীকাসমূহ।

অনুমোদন

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

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

getHeader()

প্রথম ট্যাবের হেডার সেকশন অথবা, ডকুমেন্টের সাথে সংযুক্ত স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবের হেডার সেকশন পুনরুদ্ধার করে। যেকোনো ট্যাবের হেডার সেকশন পেতে DocumentTab.getHeader() মেথডটি ব্যবহার করুন। 

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the text of the active or first tab's header and logs it to the console.
console.log(doc.getHeader().getText());

ফেরত

HeaderSection |null — ট্যাবটির হেডার।

অনুমোদন

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

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

getId()

ডকুমেন্টটির অনন্য শনাক্তকারী পুনরুদ্ধার করে। একটি নির্দিষ্ট ডকুমেন্ট ইনস্ট্যান্স খোলার জন্য DocumentApp.openById() এর সাথে ডকুমেন্ট আইডি ব্যবহার করা হয়।

ফেরত

String — ডকুমেন্টটির আইডি।

অনুমোদন

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

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

getLanguage()

ডকুমেন্টের ভাষা কোডটি পাওয়া যায়। এটি হলো সেই ভাষা যা ডকুমেন্ট এডিটরের ফাইল > ভাষা (File > Language) অংশে দেখানো হয়, যা ডকুমেন্টের প্রকৃত ভাষা নাও হতে পারে।

ফেরত

String|null — ডকুমেন্টের ভাষা, অথবা সংজ্ঞায়িত না থাকলে null ।

অনুমোদন

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

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

getName()

ডকুমেন্টটির শিরোনাম পুনরুদ্ধার করে।

ফেরত

String — ডকুমেন্টের শিরোনাম।

অনুমোদন

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

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

getNamedRangeById(id)

প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে আবদ্ধ স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে প্রদত্ত ID সহ NamedRange পাওয়া যায়। যেকোনো ট্যাবে প্রদত্ত ID সহ NamedRange পেতে, DocumentTab.getNamedRangeById(id) মেথডটি ব্যবহার করুন। ট্যাবে এই ধরনের কোনো NamedRange না থাকলে এই মেথডটি null রিটার্ন করে। নামগুলো সবসময় অনন্য হয় না, এমনকি একাধিক ট্যাবের মধ্যেও; একই ট্যাবের বিভিন্ন রেঞ্জের নাম একই হতে পারে, অনেকটা HTML-এর ক্লাসের মতো। এর বিপরীতে, ID-গুলো ট্যাবের মধ্যে অনন্য হয়, যেমনটা HTML-এর ID হয়ে থাকে।

প্যারামিটার

নাম প্রকার বর্ণনা
id String রেঞ্জের আইডি, যা ট্যাবের মধ্যে অনন্য।

ফেরত

NamedRange |null — প্রদত্ত আইডি-সহ NamedRange , অথবা ট্যাবে এই ধরনের কোনো রেঞ্জ না থাকলে null ।

অনুমোদন

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

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

getNamedRanges()

প্রথম ট্যাবে থাকা সমস্ত NamedRange অবজেক্ট পায় অথবা, ডকুমেন্টের সাথে আবদ্ধ স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে থাকা অবজেক্টগুলো পায়। যেকোনো ট্যাবের সমস্ত NamedRange অবজেক্ট পেতে, DocumentTab.getNamedRanges() মেথডটি ব্যবহার করুন।

যে কোনো স্ক্রিপ্ট যা ট্যাব অ্যাক্সেস করে, তা একটি NamedRange অ্যাক্সেস করতে পারে। স্ক্রিপ্টগুলোর মধ্যে অনাকাঙ্ক্ষিত দ্বন্দ্ব এড়াতে, রেঞ্জের নামের আগে একটি অনন্য স্ট্রিং যুক্ত করার কথা বিবেচনা করুন।

ফেরত

NamedRange[] — ট্যাবে থাকা NamedRange অবজেক্টগুলোর একটি অ্যারে, যেখানে একই নামের একাধিক রেঞ্জ অন্তর্ভুক্ত থাকতে পারে।

অনুমোদন

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

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

getNamedRanges(name)

প্রথম ট্যাবে অথবা, ডকুমেন্টের সাথে আবদ্ধ স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবে প্রদত্ত নামের সমস্ত NamedRange অবজেক্ট পাওয়া যায়। যেকোনো ট্যাবের সমস্ত NamedRange অবজেক্ট পেতে, DocumentTab.getNamedRanges(name) মেথডটি ব্যবহার করুন। নামগুলো সবসময় অনন্য হয় না, এমনকি একাধিক ট্যাবের মধ্যেও; একই ট্যাবের বিভিন্ন রেঞ্জের নাম একই হতে পারে, অনেকটা HTML-এর ক্লাসের মতো। এর বিপরীতে, ID-গুলো ট্যাবের মধ্যে অনন্য হয়, যেমনটা HTML-এর ID-এর ক্ষেত্রে হয়।

যে কোনো স্ক্রিপ্ট যা ডকুমেন্টটি অ্যাক্সেস করে, তা একটি NamedRange অ্যাক্সেস করতে পারে। স্ক্রিপ্টগুলোর মধ্যে অনাকাঙ্ক্ষিত দ্বন্দ্ব এড়াতে, রেঞ্জের নামের আগে একটি অনন্য স্ট্রিং যুক্ত করার কথা বিবেচনা করুন।

প্যারামিটার

নাম প্রকার বর্ণনা
name String রেঞ্জটির নাম, যা অগত্যা অনন্য নয়।

ফেরত

NamedRange[] — প্রদত্ত নামের ট্যাবে থাকা NamedRange অবজেক্টগুলোর একটি অ্যারে।

অনুমোদন

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

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

getSelection()

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

// Display a dialog box that tells the user how many elements are included in
// the selection.
const selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  const elements = selection.getRangeElements();
  DocumentApp.getUi().alert(`Number of selected elements: ${elements.length}`);
} else {
  DocumentApp.getUi().alert('Nothing is selected.');
}

ফেরত

Range |null — ব্যবহারকারীর পছন্দের একটি উপস্থাপনা, অথবা null যদি ব্যবহারকারী ট্যাবে কিছু নির্বাচন না করে থাকেন, যদি শুধুমাত্র একটি অনুচ্ছেদের শেষ অংশ নির্বাচিত থাকে, যদি শুধুমাত্র একটি অনুচ্ছেদের শেষ অংশ এবং একটি নতুন লাইন নির্বাচিত থাকে, অথবা যদি স্ক্রিপ্টটি ডকুমেন্টের সাথে আবদ্ধ না থাকে।

অনুমোদন

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

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

getSupportedLanguageCodes()

গুগল ডক্স ফাইলে সমর্থিত সমস্ত ভাষা কোড খুঁজে বের করে।

ফেরত

String[] — ভাষা কোডগুলোর একটি অ্যারে।

অনুমোদন

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

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

getTab(tabId)

নির্দিষ্ট আইডি সহ Tab পাওয়া যায়। যদি সেরকম কোনো Tab না থাকে, তবে এই মেথডটি null রিটার্ন করে। যেকোনো নেস্টিং লেভেলের ট্যাব অ্যাক্সেস করা যায়।

প্যারামিটার

নাম প্রকার বর্ণনা
tab Id String যে ট্যাবটি পেতে হবে তার আইডি।

ফেরত

Tab |null — নির্দিষ্ট আইডিযুক্ত Tab , অথবা সেরকম কোনো Tab না থাকলে null ।

অনুমোদন

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

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

getTabs()

ডকুমেন্টের অংশ এমন সমস্ত নেস্টেড নয় এমন Tab খুঁজে বের করে।

একটি ট্যাবের মধ্যে চাইল্ড ট্যাব থাকতে পারে, অর্থাৎ একটি ট্যাবের ভেতরে আরেকটি ট্যাব থাকতে পারে। Tab.getChildTabs() ব্যবহার করে চাইল্ড ট্যাবগুলো অ্যাক্সেস করা যায়।

ফেরত

Tab[] — ডকুমেন্টের অন্তর্ভুক্ত সকল Tab তালিকা।

অনুমোদন

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

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

getUrl()

বর্তমান ডকুমেন্টটি অ্যাক্সেস করার জন্য URL পুনরুদ্ধার করে। 

const doc = DocumentApp.getActiveDocument();

// Send out the link to open the document.
MailApp.sendEmail('<email-address>', doc.getName(), doc.getUrl());

ফেরত

String — বর্তমান ডকুমেন্টটি অ্যাক্সেস করার জন্য URL।

অনুমোদন

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

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

getViewers()

এই Document দর্শক ও মন্তব্যকারীদের তালিকা পাওয়া যায়।

ফেরত

User[] — দেখার বা মন্তব্য করার অনুমতি আছে এমন ব্যবহারকারীদের একটি অ্যারে।

অনুমোদন

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

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

newPosition(element, offset)

একটি নতুন Position তৈরি করে, যা প্রথম ট্যাবের একটি নির্দিষ্ট এলিমেন্টের সাপেক্ষে অথবা, ডকুমেন্টের সাথে আবদ্ধ স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাবের সাপেক্ষে ট্যাবের একটি অবস্থানের রেফারেন্স। যেকোনো ট্যাবের কোনো অবস্থানের সাপেক্ষে একটি Position তৈরি করতে, DocumentTab.newPosition(element, offset) মেথডটি ব্যবহার করুন। অন্যান্য ব্যবহারের পাশাপাশি, ব্যবহারকারীর কার্সারও একটি Position হিসাবে উপস্থাপিত হয়। 

// Append a paragraph to the active tab, then place the user's cursor after the
// first word of the new paragraph.
const doc = DocumentApp.getActiveDocument();
const paragraph = doc.getBody().appendParagraph('My new paragraph.');
const position = doc.newPosition(paragraph.getChild(0), 2);
doc.setCursor(position);

প্যারামিটার

নাম প্রকার বর্ণনা
element Element যে এলিমেন্টটিতে নতুন Position থাকবে; সেটি অবশ্যই একটি Text এলিমেন্ট অথবা Paragraph মতো একটি কন্টেইনার এলিমেন্ট হতে হবে।
offset Integer Text এলিমেন্টের ক্ষেত্রে, Position এর আগের অক্ষর সংখ্যা; অন্যান্য এলিমেন্টের ক্ষেত্রে, একই কন্টেইনার এলিমেন্টের মধ্যে Position এর আগের চাইল্ড এলিমেন্টের সংখ্যা।

ফেরত

Position — নতুন Position ।

অনুমোদন

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

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

newRange()

প্রথম ট্যাবের ট্যাব এলিমেন্টগুলো থেকে অথবা, ডকুমেন্টের সাথে আবদ্ধ স্ক্রিপ্টের ক্ষেত্রে, সক্রিয় ট্যাব থেকে Range অবজেক্ট তৈরি করার জন্য একটি বিল্ডার তৈরি করে। যেকোনো ট্যাবের ট্যাব এলিমেন্টগুলো থেকে DocumentRange অবজেক্ট তৈরি করার জন্য একটি বিল্ডার তৈরি করতে, DocumentTab.newRange() মেথডটি ব্যবহার করুন। 

// Change the user's selection to a range that includes every table in the
// active tab.
const doc = DocumentApp.getActiveDocument();
const rangeBuilder = doc.newRange();
const tables = doc.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

ফেরত

RangeBuilder — নতুন নির্মাতা।

অনুমোদন

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

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

removeEditor(emailAddress)

Document সম্পাদকদের তালিকা থেকে প্রদত্ত ব্যবহারকারীকে সরিয়ে দেয়। এই পদ্ধতিটি ব্যবহারকারীদের Document অ্যাক্সেস করা থেকে বিরত রাখে না, যদি তারা এমন কোনো শ্রেণীর ব্যবহারকারী হন যাদের সাধারণ অ্যাক্সেস রয়েছে—উদাহরণস্বরূপ, যদি Document ব্যবহারকারীর সম্পূর্ণ ডোমেনের সাথে শেয়ার করা থাকে, অথবা যদি Document এমন কোনো শেয়ার্ড ড্রাইভে থাকে যেখানে ব্যবহারকারী প্রবেশ করতে পারেন।

ড্রাইভ ফাইলের ক্ষেত্রে, এটি ব্যবহারকারীকে দর্শকদের তালিকা থেকেও সরিয়ে দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
email Address String অপসারণ করার জন্য ব্যবহারকারীর ইমেইল ঠিকানা।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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

removeEditor(user)

Document সম্পাদকদের তালিকা থেকে প্রদত্ত ব্যবহারকারীকে সরিয়ে দেয়। এই পদ্ধতিটি ব্যবহারকারীদের Document অ্যাক্সেস করা থেকে বিরত রাখে না, যদি তারা এমন কোনো শ্রেণীর ব্যবহারকারী হন যাদের সাধারণ অ্যাক্সেস রয়েছে—উদাহরণস্বরূপ, যদি Document ব্যবহারকারীর সম্পূর্ণ ডোমেনের সাথে শেয়ার করা থাকে, অথবা যদি Document এমন কোনো শেয়ার্ড ড্রাইভে থাকে যেখানে ব্যবহারকারী প্রবেশ করতে পারেন।

ড্রাইভ ফাইলের ক্ষেত্রে, এটি ব্যবহারকারীকে দর্শকদের তালিকা থেকেও সরিয়ে দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
user User ব্যবহারকারীকে অপসারণ করার একটি উপস্থাপনা।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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

removeViewer(emailAddress)

Document দর্শক এবং মন্তব্যকারীদের তালিকা থেকে প্রদত্ত ব্যবহারকারীকে সরিয়ে দেয়। ব্যবহারকারী যদি দর্শক বা মন্তব্যকারী না হয়ে একজন সম্পাদক হন, তবে এই পদ্ধতির কোনো প্রভাব পড়ে না। এই পদ্ধতিটি ব্যবহারকারীদের Document অ্যাক্সেস করা থেকেও বাধা দেয় না, যদি তারা এমন কোনো শ্রেণীর ব্যবহারকারী হন যাদের সাধারণ অ্যাক্সেস রয়েছে—উদাহরণস্বরূপ, যদি Document ব্যবহারকারীর সম্পূর্ণ ডোমেইনের সাথে শেয়ার করা থাকে, অথবা যদি Document এমন কোনো শেয়ার্ড ড্রাইভে থাকে যেখানে ব্যবহারকারীর অ্যাক্সেস আছে।

ড্রাইভ ফাইলের ক্ষেত্রে, এটি ব্যবহারকারীকে সম্পাদকদের তালিকা থেকেও সরিয়ে দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
email Address String অপসারণ করার জন্য ব্যবহারকারীর ইমেইল ঠিকানা।

ফেরত

Document — শৃঙ্খলবদ্ধকরণের জন্য এই Document ।

অনুমোদন

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

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

removeViewer(user)

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

ড্রাইভ ফাইলের ক্ষেত্রে, এটি ব্যবহারকারীকে সম্পাদকদের তালিকা থেকেও সরিয়ে দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
user User ব্যবহারকারীকে অপসারণ করার একটি উপস্থাপনা।

ফেরত

Document — শৃঙ্খলবদ্ধকরণের জন্য এই Document ।

অনুমোদন

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

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

saveAndClose()

বর্তমান Document সংরক্ষণ করে। অপেক্ষাধীন আপডেটগুলো মুছে ফেলে এবং প্রয়োগ করে।

প্রতিটি খোলা সম্পাদনাযোগ্য Document জন্য স্ক্রিপ্ট নির্বাহের শেষে saveAndClose() মেথডটি স্বয়ংক্রিয়ভাবে কল করা হয়।

বন্ধ করা Document সম্পাদনা করা যায় না। সম্পাদনার জন্য নির্দিষ্ট কোনো ডকুমেন্ট পুনরায় খুলতে DocumentApp.openById() ব্যবহার করুন।

অনুমোদন

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

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

setActiveTab(tabId)

বর্তমান ডকুমেন্টে ব্যবহারকারীর নির্বাচিত Tab নির্দিষ্ট আইডিযুক্ত ট্যাবটিতে সেট করে। 

const doc = DocumentApp.getActiveDocument();

// Sets the user's selected tab by its ID.
// TODO(developer): Replace the ID with your own.
const tab = doc.setActiveTab('123abc');

প্যারামিটার

নাম প্রকার বর্ণনা
tab Id String যে ট্যাবটিকে সক্রিয় করতে চান, তার আইডি।

অনুমোদন

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

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

setCursor(position)

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

একটি নিষ্ক্রিয় Tab থেকে কোনো Position প্রদান করলে ব্যবহারকারীর সক্রিয় ট্যাব পরিবর্তিত হয়। 

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();

// Append a paragraph, then place the user's cursor after the first word of the
// new paragraph.
const paragraph = documentTab.getBody().appendParagraph('My new paragraph.');
const position = documentTab.newPosition(paragraph.getChild(0), 2);
doc.setCursor(position);

প্যারামিটার

নাম প্রকার বর্ণনা
position Position কার্সরের নতুন অবস্থান।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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

setLanguage(languageCode)

ডকুমেন্টের ভাষা কোড নির্ধারণ করে। এটি হলো সেই ভাষা যা ডকুমেন্ট এডিটরের ফাইল > ভাষা (File > Language) অংশে দেখানো হয়, যা ডকুমেন্টের প্রকৃত ভাষা নাও হতে পারে। সমস্ত বৈধ ভাষা কোড পেতে getSupportedLanguageCodes() ব্যবহার করুন।

প্যারামিটার

নাম প্রকার বর্ণনা
language Code String ভাষা কোড।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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

setName(name)

ডকুমেন্টের শিরোনাম নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
name String নতুন নথির শিরোনাম।

ফেরত

Document — বর্তমান নথি।

অনুমোদন

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

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

setSelection(range)

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

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();

// Change the user's selection to a range that includes every table in the
// document.
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

প্যারামিটার

নাম প্রকার বর্ণনা
range Range বাছাই করার জন্য নতুন উপাদানসমূহ।

ফেরত

Document — এই Document , শৃঙ্খলবদ্ধ করার জন্য।

অনুমোদন

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

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