این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class Paragraph

عنصری که نمایانگر یک پاراگراف است. یک Paragraph ممکن است شامل عناصر Equation ، Footnote ، Horizontal Rule ، Inline Drawing ، Inline Image ، Page Break و Text باشد. برای اطلاعات بیشتر در مورد ساختار سند، به راهنمای توسعه Google Docs مراجعه کنید.

Paragraphs نمی‌توانند شامل کاراکترهای خط جدید باشند. کاراکترهای خط جدید ("\n") به کاراکترهای خط جدید ("\r") تبدیل می‌شوند.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Append a tab header paragraph.
const header = body.appendParagraph('A Document');
header.setHeading(DocumentApp.ParagraphHeading.HEADING1);

// Append a section header paragraph.
const section = body.appendParagraph('Section 1');
section.setHeading(DocumentApp.ParagraphHeading.HEADING2);

// Append a regular paragraph.
body.appendParagraph('This is a typical paragraph.');

روش‌ها

روش	نوع بازگشتی	شرح مختصر
`add Positioned Image(image)`	`Positioned Image`	یک `Positioned Image` جدید از بلوک تصویر مشخص‌شده ایجاد و درج می‌کند.
`append Horizontal Rule()`	`Horizontal Rule`	یک `Horizontal Rule` جدید ایجاد و اضافه می‌کند.
`append Inline Image(image)`	`Inline Image`	یک `Inline Image` جدید از بلوک تصویر مشخص‌شده ایجاد و اضافه می‌کند.
`append Inline Image(image)`	`Inline Image`	`Inline Image` داده شده را اضافه می‌کند.
`append Page Break()`	`Page Break`	یک `Page Break` جدید ایجاد و اضافه می‌کند.
`append Page Break(pageBreak)`	`Page Break`	`Page Break` داده شده را اضافه می‌کند.
`append Text(text)`	`Text`	یک عنصر `Text` جدید با محتوای مشخص شده ایجاد و اضافه می‌کند.
`append Text(text)`	`Text`	عنصر `Text` داده شده را اضافه می‌کند.
`clear()`	`Paragraph`	محتویات عنصر را پاک می‌کند.
`copy()`	`Paragraph`	یک کپی جدا و عمیق از عنصر فعلی را برمی‌گرداند.
`edit As Text()`	`Text`	یک نسخه `Text` از عنصر فعلی را برای ویرایش دریافت می‌کند.
`find Element(elementType)`	`Range Element \|null`	محتویات عنصر را برای یافتن نسلی از نوع مشخص شده جستجو می‌کند.
`find Element(elementType, from)`	`Range Element \|null`	محتویات عنصر را برای یافتن نسلی از نوع مشخص شده، با شروع از `Range Element` مشخص شده، جستجو می‌کند.
`find Text(searchPattern)`	`Range Element \|null`	با استفاده از عبارات منظم، محتوای عنصر را برای الگوی متنی مشخص شده جستجو می‌کند.
`find Text(searchPattern, from)`	`Range Element \|null`	با شروع از یک نتیجه جستجوی داده شده، محتویات عنصر را برای الگوی متنی مشخص شده جستجو می‌کند.
`get Alignment()`	`Horizontal Alignment \|null`	`Horizontal Alignment` بازیابی می‌کند.
`get Attributes()`	`Object`	ویژگی‌های عنصر را بازیابی می‌کند.
`get Child(childIndex)`	`Element`	عنصر فرزند را در اندیس فرزند مشخص شده بازیابی می‌کند.
`get Child Index(child)`	`Integer`	اندیس فرزند را برای عنصر فرزند مشخص شده بازیابی می‌کند.
`get Heading()`	`Paragraph Heading \|null`	`Paragraph Heading` بازیابی می‌کند.
`get Indent End()`	`Number\|null`	تورفتگی انتهایی را بر حسب نقطه بازیابی می‌کند.
`get Indent First Line()`	`Number\|null`	میزان تورفتگی خط اول را بر حسب نقطه برمی‌گرداند.
`get Indent Start()`	`Number\|null`	تورفتگی شروع را بازیابی می‌کند.
`get Line Spacing()`	`Number\|null`	فاصله بین خطوط را بر حسب نقطه بازیابی می‌کند.
`get Link Url()`	`String\|null`	آدرس لینک را بازیابی می‌کند.
`get Next Sibling()`	`Element \|null`	عنصر خواهر یا برادر بعدی عنصر را بازیابی می‌کند.
`get Num Children()`	`Integer`	تعداد فرزندان را بازیابی می‌کند.
`get Parent()`	`Container Element \|null`	عنصر والد عنصر را بازیابی می‌کند.
`get Positioned Image(id)`	`Positioned Image`	یک `Positioned Image` بر اساس شناسه تصویر دریافت می‌کند.
`get Positioned Images()`	`Positioned Image[]`	تمام اشیاء `Positioned Image` که به پاراگراف متصل شده‌اند، دریافت می‌کند.
`get Previous Sibling()`	`Element \|null`	عنصر خواهر و برادر قبلی عنصر را بازیابی می‌کند.
`get Spacing After()`	`Number\|null`	فاصله بعد از عنصر را بر حسب نقطه بازیابی می‌کند.
`get Spacing Before()`	`Number\|null`	فاصله قبل از عنصر را بر حسب نقطه بازیابی می‌کند.
`get Text()`	`String`	محتوای عنصر را به صورت یک رشته متنی بازیابی می‌کند.
`get Text Alignment()`	`Text Alignment \|null`	ترازبندی متن را دریافت می‌کند.
`get Type()`	`Element Type`	`Element Type` را بازیابی می‌کند.
`insert Horizontal Rule(childIndex)`	`Horizontal Rule`	یک `Horizontal Rule` در اندیس مشخص شده ایجاد و درج می‌کند.
`insert Inline Image(childIndex, image)`	`Inline Image`	یک `Inline Image` جدید را از بلوک تصویر مشخص‌شده، در اندیس مشخص‌شده ایجاد و درج می‌کند.
`insert Inline Image(childIndex, image)`	`Inline Image`	`Inline Image` داده شده را در اندیس مشخص شده درج می‌کند.
`insert Page Break(childIndex)`	`Page Break`	یک `Page Break` جدید در اندیس مشخص شده ایجاد و درج می‌کند.
`insert Page Break(childIndex, pageBreak)`	`Page Break`	`Page Break` داده شده را در فهرست مشخص شده وارد می‌کند.
`insert Text(childIndex, text)`	`Text`	یک عنصر متنی جدید را در اندیس مشخص شده ایجاد و درج می‌کند.
`insert Text(childIndex, text)`	`Text`	عنصر `Text` داده شده را در اندیس مشخص شده، با محتوای متن مشخص شده، درج می‌کند.
`is At Document End()`	`Boolean`	تعیین می‌کند که آیا عنصر در انتهای `Document` قرار دارد یا خیر.
`is Left To Right()`	`Boolean\|null`	تنظیمات چپ به راست را بازیابی می‌کند.
`merge()`	`Paragraph \|null`	عنصر را با عنصر خواهر یا برادر قبلی از همان نوع ادغام می‌کند.
`remove Child(child)`	`Paragraph`	عنصر فرزند مشخص شده را حذف می‌کند.
`remove From Parent()`	`Paragraph \|null`	عنصر را از والدش حذف می‌کند.
`remove Positioned Image(id)`	`Boolean`	یک `Positioned Image` بر اساس شناسه تصویر حذف می‌کند.
`replace Text(searchPattern, replacement)`	`Element`	با استفاده از عبارات منظم، تمام موارد تکرار یک الگوی متنی مشخص را با یک رشته جایگزین مشخص جایگزین می‌کند.
`set Alignment(alignment)`	`Paragraph`	`Horizontal Alignment` را تنظیم می‌کند.
`set Attributes(attributes)`	`Paragraph`	ویژگی‌های عنصر را تنظیم می‌کند.
`set Heading(heading)`	`Paragraph`	`Paragraph Heading` تنظیم می‌کند.
`set Indent End(indentEnd)`	`Paragraph`	تورفتگی انتهایی را بر حسب نقطه تنظیم می‌کند.
`set Indent First Line(indentFirstLine)`	`Paragraph`	میزان تورفتگی خط اول را بر حسب نقطه تنظیم می‌کند.
`set Indent Start(indentStart)`	`Paragraph`	تورفتگی شروع را بر حسب نقطه تنظیم می‌کند.
`set Left To Right(leftToRight)`	`Paragraph`	تنظیم چپ به راست را تنظیم می‌کند.
`set Line Spacing(multiplier)`	`Paragraph`	فاصله خطوط را به عنوان کمیتی که تعداد خطوط مورد استفاده برای فاصله‌گذاری را نشان می‌دهد، تنظیم می‌کند.
`set Link Url(url)`	`Paragraph`	آدرس لینک را تنظیم می‌کند.
`set Spacing After(spacingAfter)`	`Paragraph`	فاصله بعد از عنصر را بر حسب نقطه تنظیم می‌کند.
`set Spacing Before(spacingBefore)`	`Paragraph`	فاصله قبل از عنصر را بر حسب نقطه تنظیم می‌کند.
`set Text(text)`	`void`	محتوای پاراگراف را به عنوان متن تنظیم می‌کند.
`set Text Alignment(textAlignment)`	`Paragraph`	ترازبندی متن را تنظیم می‌کند.

مستندات دقیق

`add Positioned Image(image)`

یک Positioned Image جدید از بلوک تصویر مشخص‌شده ایجاد و درج می‌کند.

// 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 body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab('123abc').asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Fetches the specified image URL.
const image = UrlFetchApp.fetch(
    'https://fonts.gstatic.com/s/i/productlogos/apps_script/v10/web-24dp/logo_apps_script_color_1x_web_24dp.png',
);

// Adds the image to the tab, anchored to the first paragraph.
paragraph.addPositionedImage(image);

پارامترها

نام	نوع	توضیحات
`image`	`Blob Source`	داده‌های تصویر.

بازگشت

Positioned Image — تصویر موقعیت‌یابی شده جدید.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`append Horizontal Rule()`

یک Horizontal Rule جدید ایجاد و اضافه می‌کند.

// 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 body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab('123abc').asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Adds a horizontal line under the first paragraph.
paragraph.appendHorizontalRule();

بازگشت

Horizontal Rule — خط‌کش افقی جدید.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`append Inline Image(image)`

یک Inline Image جدید از بلوک تصویر مشخص‌شده ایجاد و اضافه می‌کند.

// 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 body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab('123abc').asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Fetches the image from the specified image URL.
const image = UrlFetchApp.fetch(
    'https://fonts.gstatic.com/s/i/productlogos/apps_script/v10/web-96dp/logo_apps_script_color_1x_web_96dp.png',
);

// Adds the image to the first paragraph.
paragraph.appendInlineImage(image);

پارامترها

نام	نوع	توضیحات
`image`	`Blob Source`	داده‌های تصویر.

بازگشت

Inline Image - تصویر پیوست‌شده.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`append Inline Image(image)`

Inline Image داده شده را اضافه می‌کند.

// 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 body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab('123abc').asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Makes a copy of the first image in the body.
const image = body.getImages()[0].copy();

// Adds the image to the first paragraph.
paragraph.appendInlineImage(image);

پارامترها

نام	نوع	توضیحات
`image`	`Inline Image`	داده‌های تصویر.

بازگشت

Inline Image - تصویر پیوست‌شده.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`append Page Break()`

یک Page Break جدید ایجاد و اضافه می‌کند.

نکته: Page Breaks نمی‌توانند درون Table Cells قرار بگیرند. اگر عنصر فعلی درون یک سلول جدول قرار داشته باشد، یک استثنا ایجاد می‌شود.

// 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 body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab('123abc').asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Adds a page break after the first paragraph.
paragraph.appendPageBreak();

بازگشت

Page Break - عنصر جدید شکستن صفحه.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`append Page Break(pageBreak)`

Page Break داده شده را اضافه می‌کند.

نکته: Page Breaks نمی‌توانند درون Table Cells قرار بگیرند. اگر عنصر فعلی در یک سلول جدول وجود داشته باشد، اسکریپت یک استثنا ایجاد می‌کند.

// 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 body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab('123abc').asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Adds a page break after the first paragraph.
const pageBreak = paragraph.appendPageBreak();

// Makes a copy of the page break.
const newPageBreak = pageBreak.copy();

// Adds the copied page break to the paragraph.
paragraph.appendPageBreak(newPageBreak);

پارامترها

نام	نوع	توضیحات
`page Break`	`Page Break`	شکستن صفحه برای اضافه کردن.

بازگشت

Page Break - عنصر شکستن صفحه اضافه شده.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`append Text(text)`

یک عنصر Text جدید با محتوای مشخص شده ایجاد و اضافه می‌کند.

// 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 body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab('123abc').asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Adds a string to the paragraph.
paragraph.appendText('This is a new sentence.');

پارامترها

نام	نوع	توضیحات
`text`	`String`	محتویات متن.

بازگشت

Text - عنصر متن جدید.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`append Text(text)`

عنصر Text داده شده را اضافه می‌کند.

// 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 body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab('123abc').asDocumentTab().getBody();

// Gets the text from the first paragraph in the body.
const paragraph1 = body.getParagraphs()[0];
const text = paragraph1.getText();

// Gets the third paragraph in the body.
const paragraph3 = body.getParagraphs()[2];

// Adds the text from the first paragraph to the third paragraph.
paragraph3.appendText(text);

پارامترها

نام	نوع	توضیحات
`text`	`Text`	عنصر متنی که قرار است اضافه شود.

بازگشت

Text - عنصر متن پیوست شده.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`clear()`

محتویات عنصر را پاک می‌کند.

بازگشت

Paragraph - عنصر فعلی.

`copy()`

یک کپی جدا و عمیق از عنصر فعلی را برمی‌گرداند.

هر عنصر فرزندی که در عنصر وجود داشته باشد نیز کپی می‌شود. عنصر جدید والد ندارد.

بازگشت

Paragraph - نسخه جدید.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`edit As Text()`

یک نسخه Text از عنصر فعلی را برای ویرایش دریافت می‌کند.

edit As Text برای دستکاری محتوای عناصر به عنوان متن غنی استفاده کنید. حالت edit As Text عناصر غیر متنی (مانند Inline Image و Horizontal Rule ) را نادیده می‌گیرد.

عناصر فرزندی که کاملاً در محدوده متن حذف شده قرار دارند، از عنصر حذف می‌شوند.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Insert two paragraphs separated by a paragraph containing an
// horizontal rule.
body.insertParagraph(0, 'An editAsText sample.');
body.insertHorizontalRule(0);
body.insertParagraph(0, 'An example.');

// Delete " sample.\n\n An" removing the horizontal rule in the process.
body.editAsText().deleteText(14, 25);

بازگشت

Text - نسخه متنی عنصر فعلی

`find Element(elementType)`

محتویات عنصر را برای یافتن نسلی از نوع مشخص شده جستجو می‌کند.

پارامترها

نام	نوع	توضیحات
`element Type`	`Element Type`	نوع عنصری که باید جستجو شود.

بازگشت

Range Element |null — نتیجه جستجو که موقعیت عنصر جستجو را نشان می‌دهد.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`find Element(elementType, from)`

محتویات عنصر را برای یافتن نسلی از نوع مشخص شده، با شروع از Range Element مشخص شده، جستجو می‌کند.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Define the search parameters.

let searchResult = null;

// Search until the paragraph is found.
while (
    (searchResult = body.findElement(
         DocumentApp.ElementType.PARAGRAPH,
         searchResult,
         ))) {
  const par = searchResult.getElement().asParagraph();
  if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    break;
  }
}

پارامترها

نام	نوع	توضیحات
`element Type`	`Element Type`	نوع عنصری که باید جستجو شود.
`from`	`Range Element`	نتیجه جستجو برای جستجو از.

بازگشت

Range Element |null — نتیجه جستجو که موقعیت بعدی عنصر جستجو را نشان می‌دهد.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`find Text(searchPattern)`

با استفاده از عبارات منظم، محتوای عنصر را برای الگوی متنی مشخص شده جستجو می‌کند.

زیرمجموعه‌ای از ویژگی‌های عبارات منظم جاوا اسکریپت به طور کامل پشتیبانی نمی‌شوند، مانند گروه‌های ضبط و اصلاح‌کننده‌های حالت.

الگوی عبارت منظم ارائه شده به طور مستقل با هر بلوک متنی موجود در عنصر فعلی مطابقت داده می‌شود.

پارامترها

نام	نوع	توضیحات
`search Pattern`	`String`	الگویی که باید جستجو شود

بازگشت

Range Element |null — نتیجه جستجو که موقعیت متن جستجو را نشان می‌دهد، یا در صورت عدم تطابق، null

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`find Text(searchPattern, from)`

با شروع از یک نتیجه جستجوی داده شده، محتویات عنصر را برای الگوی متنی مشخص شده جستجو می‌کند.

الگوی عبارت منظم ارائه شده به طور مستقل با هر بلوک متنی موجود در عنصر فعلی مطابقت داده می‌شود.

پارامترها

نام	نوع	توضیحات
`search Pattern`	`String`	الگویی که باید جستجو شود
`from`	`Range Element`	نتیجه جستجو برای جستجو از

بازگشت

Range Element |null — نتیجه جستجو که موقعیت بعدی متن جستجو را نشان می‌دهد، یا در صورت عدم تطابق، null است.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Alignment()`

Horizontal Alignment بازیابی می‌کند.

// 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 body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab('123abc').asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Sets the horizontal alignment to left for the first paragraph.
paragraph.setAlignment(DocumentApp.HorizontalAlignment.LEFT);

// Gets the horizontal alignment of the first paragraph and logs it to the
// console.
console.log(paragraph.getAlignment().toString());

بازگشت

Horizontal Alignment |null — ترازبندی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Attributes()`

ویژگی‌های عنصر را بازیابی می‌کند.

نتیجه، یک شیء حاوی یک ویژگی برای هر ویژگی عنصر معتبر است که در آن هر نام ویژگی با یک آیتم در شمارش Document App.Attribute مطابقت دارد.

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

// Append a styled paragraph.
const par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
const atts = par.getAttributes();

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

بازگشت

Object - ویژگی‌های عنصر.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Child(childIndex)`

عنصر فرزند را در اندیس فرزند مشخص شده بازیابی می‌کند.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Obtain the first element in the tab.
const firstChild = body.getChild(0);

// If it's a paragraph, set its contents.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  firstChild.asParagraph().setText('This is the first paragraph.');
}

پارامترها

نام	نوع	توضیحات
`child Index`	`Integer`	اندیس عنصر فرزندی که قرار است بازیابی شود.

بازگشت

Element - عنصر فرزند در اندیس مشخص شده.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Child Index(child)`

اندیس فرزند را برای عنصر فرزند مشخص شده بازیابی می‌کند.

پارامترها

نام	نوع	توضیحات
`child`	`Element`	عنصر فرزندی که اندیس آن بازیابی می‌شود.

بازگشت

Integer - اندیس فرزند.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Heading()`

Paragraph Heading بازیابی می‌کند.

// 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 body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab('123abc').asDocumentTab().getBody();

// Adds a paragraph to the body.
const paragraph = body.appendParagraph('Title heading');

// Sets the paragraph heading style to 'Title.'
paragraph.setHeading(DocumentApp.ParagraphHeading.TITLE);

// Gets the heading style and logs it to the console.
console.log(paragraph.getHeading().toString());

بازگشت

Paragraph Heading |null — عنوان.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Indent End()`

تورفتگی انتهایی را بر حسب نقطه بازیابی می‌کند.

بازگشت

Number|null — تورفتگی انتهایی، بر حسب نقطه

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Indent First Line()`

میزان تورفتگی خط اول را بر حسب نقطه برمی‌گرداند.

بازگشت

Number|null — میزان تورفتگی خط اول، بر حسب نقطه

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Indent Start()`

تورفتگی شروع را بازیابی می‌کند.

بازگشت

Number|null — شروع تورفتگی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Line Spacing()`

فاصله بین خطوط را بر حسب نقطه بازیابی می‌کند.

بازگشت

Number|null — فاصله خطوط، بر حسب نقطه

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Link Url()`

آدرس لینک را بازیابی می‌کند.

بازگشت

String|null — آدرس اینترنتی لینک، یا اگر عنصر شامل چندین مقدار برای این ویژگی باشد، null.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Next Sibling()`

عنصر خواهر یا برادر بعدی عنصر را بازیابی می‌کند.

خواهر یا برادر بعدی، والد یکسانی دارد و عنصر فعلی را دنبال می‌کند.

بازگشت

Element |null — عنصر خواهر یا برادر بعدی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Num Children()`

تعداد فرزندان را بازیابی می‌کند.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Log the number of elements in the tab.
Logger.log(`There are ${body.getNumChildren()} elements in the tab's body.`);

بازگشت

Integer - تعداد فرزندان.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Parent()`

عنصر والد عنصر را بازیابی می‌کند.

عنصر والد شامل عنصر فعلی است.

بازگشت

Container Element |null — عنصر والد.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Positioned Image(id)`

یک Positioned Image بر اساس شناسه تصویر دریافت می‌کند.

پارامترها

نام	نوع	توضیحات
`id`	`String`	شناسه تصویر

بازگشت

Positioned Image - تصویر موقعیت‌یابی شده

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Positioned Images()`

تمام اشیاء Positioned Image که به پاراگراف متصل شده‌اند، دریافت می‌کند.

بازگشت

Positioned Image[] — فهرستی از تصاویر موقعیت‌یابی‌شده

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Previous Sibling()`

عنصر خواهر و برادر قبلی عنصر را بازیابی می‌کند.

عنصر خواهر یا برادر قبلی، والد یکسانی دارد و قبل از عنصر فعلی قرار می‌گیرد.

بازگشت

Element |null — عنصر خواهر یا برادر قبلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Spacing After()`

فاصله بعد از عنصر را بر حسب نقطه بازیابی می‌کند.

بازگشت

Number|null — فاصله بعد از عنصر، بر حسب نقطه

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Spacing Before()`

فاصله قبل از عنصر را بر حسب نقطه بازیابی می‌کند.

بازگشت

Number|null — فاصله قبل از عنصر، بر حسب نقطه

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Text()`

محتوای عنصر را به صورت یک رشته متنی بازیابی می‌کند.

بازگشت

String - محتویات عنصر به صورت رشته متنی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Text Alignment()`

ترازبندی متن را دریافت می‌کند. انواع ترازبندی موجود عبارتند از Document App.TextAlignment.NORMAL ، Document App.TextAlignment.SUBSCRIPT و Document App.TextAlignment.SUPERSCRIPT .

بازگشت

Text Alignment |null — نوع ترازبندی متن، یا اگر متن شامل چندین نوع ترازبندی متن باشد یا ترازبندی متن هرگز تنظیم نشده باشد، null

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`get Type()`

Element Type را بازیابی می‌کند.

برای تعیین نوع دقیق یک عنصر داده شده، get Type() استفاده کنید.

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

// Obtain the first element in the active tab's body.

const firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

بازگشت

Element Type - نوع عنصر.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`insert Horizontal Rule(childIndex)`

یک Horizontal Rule در اندیس مشخص شده ایجاد و درج می‌کند.

پارامترها

نام	نوع	توضیحات
`child Index`	`Integer`	اندیسی که عنصر در آن قرار می‌گیرد

بازگشت

Horizontal Rule - عنصر جدید خط‌کش افقی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`insert Inline Image(childIndex, image)`

یک Inline Image جدید را از بلوک تصویر مشخص‌شده، در اندیس مشخص‌شده ایجاد و درج می‌کند.

پارامترها

نام	نوع	توضیحات
`child Index`	`Integer`	اندیسی که عنصر در آن قرار می‌گیرد
`image`	`Blob Source`	داده‌های تصویر

بازگشت

Inline Image - عنصر تصویر درون‌خطی درج شده

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`insert Inline Image(childIndex, image)`

Inline Image داده شده را در اندیس مشخص شده درج می‌کند.

پارامترها

نام	نوع	توضیحات
`child Index`	`Integer`	اندیسی که عنصر در آن قرار می‌گیرد
`image`	`Inline Image`	داده‌های تصویر

بازگشت

Inline Image - عنصر تصویر درون‌خطی درج شده

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`insert Page Break(childIndex)`

یک Page Break جدید در اندیس مشخص شده ایجاد و درج می‌کند.

پارامترها

نام	نوع	توضیحات
`child Index`	`Integer`	اندیسی که عنصر در آن قرار می‌گیرد

بازگشت

Page Break - عنصر جدید شکستن صفحه

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`insert Page Break(childIndex, pageBreak)`

Page Break داده شده را در فهرست مشخص شده وارد می‌کند.

پارامترها

نام	نوع	توضیحات
`child Index`	`Integer`	اندیسی که عنصر در آن قرار می‌گیرد
`page Break`	`Page Break`	صفحه[page break برای درج

بازگشت

Page Break - عنصر شکست صفحه درج شده

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`insert Text(childIndex, text)`

یک عنصر متنی جدید را در اندیس مشخص شده ایجاد و درج می‌کند.

پارامترها

نام	نوع	توضیحات
`child Index`	`Integer`	اندیسی که عنصر در آن قرار می‌گیرد
`text`	`String`	محتوای متن

بازگشت

Text - عنصر متن جدید

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`insert Text(childIndex, text)`

عنصر Text داده شده را در اندیس مشخص شده، با محتوای متن مشخص شده، درج می‌کند.

پارامترها

نام	نوع	توضیحات
`child Index`	`Integer`	اندیسی که عنصر در آن قرار می‌گیرد
`text`	`Text`	عنصر متنی که قرار است درج شود

بازگشت

Text - عنصر متن درج شده

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`is At Document End()`

تعیین می‌کند که آیا عنصر در انتهای Document قرار دارد یا خیر.

بازگشت

Boolean - اینکه آیا عنصر در انتهای تب قرار دارد یا خیر.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`is Left To Right()`

تنظیمات چپ به راست را بازیابی می‌کند.

بازگشت

Boolean|null — تنظیم از چپ به راست

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`merge()`

عنصر را با عنصر خواهر یا برادر قبلی از همان نوع ادغام می‌کند.

فقط عناصری که از Element Type یکسانی هستند می‌توانند ادغام شوند. هر عنصر فرزندی که در عنصر فعلی قرار داشته باشد، به عنصر خواهر و برادر قبلی منتقل می‌شود.

عنصر فعلی از سند حذف می‌شود.

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

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

بازگشت

Paragraph |null — عنصر ادغام‌شده.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`remove Child(child)`

عنصر فرزند مشخص شده را حذف می‌کند.

پارامترها

نام	نوع	توضیحات
`child`	`Element`	عنصر فرزندی که قرار است حذف شود

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`remove From Parent()`

عنصر را از والدش حذف می‌کند.

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

// Remove all images in the active tab's body.
const imgs = body.getImages();
for (let i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

بازگشت

Paragraph |null — عنصر حذف شده.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`remove Positioned Image(id)`

یک Positioned Image بر اساس شناسه تصویر حذف می‌کند.

پارامترها

نام	نوع	توضیحات
`id`	`String`	شناسه تصویر

بازگشت

Boolean - آیا تصویر مشخص شده حذف شده است یا خیر

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`replace Text(searchPattern, replacement)`

با استفاده از عبارات منظم، تمام موارد تکرار یک الگوی متنی مشخص را با یک رشته جایگزین مشخص جایگزین می‌کند.

الگوی جستجو به صورت یک رشته ارسال می‌شود، نه یک شیء عبارت منظم جاوا اسکریپت. به همین دلیل، باید هرگونه بک‌اسلش را در الگو escape کنید.

این روش از کتابخانه عبارات منظم RE2 گوگل استفاده می‌کند که سینتکس‌های پشتیبانی‌شده را محدود می‌کند.

الگوی عبارت منظم ارائه شده به طور مستقل با هر بلوک متنی موجود در عنصر فعلی مطابقت داده می‌شود.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText('^.*Apps ?Script.*$', 'Apps Script');

پارامترها

نام	نوع	توضیحات
`search Pattern`	`String`	الگوی regex برای جستجو
`replacement`	`String`	متنی که قرار است به عنوان جایگزین استفاده شود

بازگشت

Element - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Alignment(alignment)`

Horizontal Alignment را تنظیم می‌کند.

پارامترها

نام	نوع	توضیحات
`alignment`	`Horizontal Alignment`	تراز افقی

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Attributes(attributes)`

ویژگی‌های عنصر را تنظیم می‌کند.

پارامتر ویژگی‌های مشخص‌شده باید یک شیء باشد که در آن نام هر ویژگی، یک آیتم در شمارش Document App.Attribute است و مقدار هر ویژگی، مقدار جدیدی است که باید اعمال شود.

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

// Define a custom paragraph style.
const style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
const par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

پارامترها

نام	نوع	توضیحات
`attributes`	`Object`	ویژگی‌های عنصر.

بازگشت

Paragraph - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Heading(heading)`

Paragraph Heading تنظیم می‌کند.

پارامترها

نام	نوع	توضیحات
`heading`	`Paragraph Heading`	عنوان

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Indent End(indentEnd)`

تورفتگی انتهایی را بر حسب نقطه تنظیم می‌کند.

پارامترها

نام	نوع	توضیحات
`indent End`	`Number`	فرورفتگی انتهایی، بر حسب نقطه

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Indent First Line(indentFirstLine)`

میزان تورفتگی خط اول را بر حسب نقطه تنظیم می‌کند.

پارامترها

نام	نوع	توضیحات
`indent First Line`	`Number`	تورفتگی خط اول، بر حسب نقطه

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Indent Start(indentStart)`

تورفتگی شروع را بر حسب نقطه تنظیم می‌کند.

پارامترها

نام	نوع	توضیحات
`indent Start`	`Number`	تورفتگی شروع، بر حسب نقطه

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Left To Right(leftToRight)`

تنظیم چپ به راست را تنظیم می‌کند.

پارامترها

نام	نوع	توضیحات
`left To Right`	`Boolean`	تنظیم چپ به راست

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Line Spacing(multiplier)`

فاصله خطوط را به عنوان کمیتی که تعداد خطوط مورد استفاده برای فاصله‌گذاری را نشان می‌دهد، تنظیم می‌کند.

پارامترها

نام	نوع	توضیحات
`multiplier`	`Number`	تعداد خطوط

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Link Url(url)`

آدرس لینک را تنظیم می‌کند.

پارامترها

نام	نوع	توضیحات
`url`	`String`	آدرس لینک

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Spacing After(spacingAfter)`

فاصله بعد از عنصر را بر حسب نقطه تنظیم می‌کند.

پارامترها

نام	نوع	توضیحات
`spacing After`	`Number`	فاصله بعد از عنصر، بر حسب نقطه

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Spacing Before(spacingBefore)`

فاصله قبل از عنصر را بر حسب نقطه تنظیم می‌کند.

پارامترها

نام	نوع	توضیحات
`spacing Before`	`Number`	فاصله قبل از عنصر، بر حسب نقطه

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Text(text)`

محتوای پاراگراف را به عنوان متن تنظیم می‌کند.

توجه: محتویات موجود پاک می‌شوند.

پارامترها

نام	نوع	توضیحات
`text`	`String`	محتوای متن جدید

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

`set Text Alignment(textAlignment)`

ترازبندی متن را تنظیم می‌کند. انواع ترازبندی موجود عبارتند از Document App.TextAlignment.NORMAL ، Document App.TextAlignment.SUBSCRIPT و Document App.TextAlignment.SUPERSCRIPT .

// Make the entire first paragraph in the active tab be superscript.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

پارامترها

نام	نوع	توضیحات
`text Alignment`	`Text Alignment`	نوع ترازبندی متن که باید اعمال شود

بازگشت

Paragraph - عنصر فعلی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

Class Paragraph با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

روش‌ها

مستندات دقیق

add Positioned Image(image)

پارامترها

بازگشت

مجوز

append Horizontal Rule()

بازگشت

مجوز

append Inline Image(image)

پارامترها

بازگشت

مجوز

append Inline Image(image)

پارامترها

بازگشت

مجوز

append Page Break()

بازگشت

مجوز

append Page Break(pageBreak)

پارامترها

بازگشت

مجوز

append Text(text)

پارامترها

بازگشت

مجوز

append Text(text)

پارامترها

بازگشت

مجوز

clear()

بازگشت

copy()

بازگشت

مجوز

edit As Text()

بازگشت

find Element(elementType)

پارامترها

بازگشت

مجوز

find Element(elementType, from)

پارامترها

بازگشت

مجوز

find Text(searchPattern)

پارامترها

بازگشت

مجوز

find Text(searchPattern, from)

پارامترها

بازگشت

مجوز

get Alignment()

بازگشت

مجوز

get Attributes()

بازگشت

مجوز

get Child(childIndex)

پارامترها

بازگشت

مجوز

get Child Index(child)

پارامترها

بازگشت

مجوز

get Heading()

بازگشت

مجوز

get Indent End()

بازگشت

مجوز

get Indent First Line()

بازگشت

مجوز

get Indent Start()

Class Paragraph

`add Positioned Image(image)`

`append Horizontal Rule()`

`append Inline Image(image)`

`append Inline Image(image)`

`append Page Break()`

`append Page Break(pageBreak)`

`append Text(text)`

`append Text(text)`

`clear()`

`copy()`

`edit As Text()`

`find Element(elementType)`

`find Element(elementType, from)`

`find Text(searchPattern)`

`find Text(searchPattern, from)`

`get Alignment()`

`get Attributes()`

`get Child(childIndex)`

`get Child Index(child)`

`get Heading()`

`get Indent End()`

`get Indent First Line()`

`get Indent Start()`

`get Line Spacing()`

`get Link Url()`

`get Next Sibling()`

`get Num Children()`

`get Parent()`

`get Positioned Image(id)`

`get Positioned Images()`

`get Previous Sibling()`

`get Spacing After()`

`get Spacing Before()`

`get Text()`

`get Text Alignment()`

`get Type()`

`insert Horizontal Rule(childIndex)`

`insert Inline Image(childIndex, image)`

`insert Inline Image(childIndex, image)`

`insert Page Break(childIndex)`

`insert Page Break(childIndex, pageBreak)`

`insert Text(childIndex, text)`

`insert Text(childIndex, text)`