Class DocumentApp

DocumentApp

سرویس اسناد Documents قابل ویرایش را ایجاد و باز می کند.

// Open a document by ID.
var doc = DocumentApp.openById('DOCUMENT_ID_GOES_HERE');

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

خواص

ویژگی تایپ کنید شرح
Attribute Attribute شمارش Attribute
ElementType ElementType شمارش ElementType
FontFamily FontFamily شمارش FontFamily .
GlyphType GlyphType شمارش GlyphType .
HorizontalAlignment HorizontalAlignment شمارش HorizontalAlignment .
ParagraphHeading ParagraphHeading شمارش ParagraphHeading .
PositionedLayout PositionedLayout شمارش PositionedLayout .
TextAlignment TextAlignment شمارش TextAlignment .
VerticalAlignment VerticalAlignment شمارش VerticalAlignment .

مواد و روش ها

روش نوع برگشت توضیح مختصر
create(name) Document یک سند جدید ایجاد و برمی گرداند.
getActiveDocument() Document سندی را که اسکریپت به آن محدود شده است برمی‌گرداند.
getUi() Ui نمونه‌ای از محیط رابط کاربری سند را برمی‌گرداند که به اسکریپت اجازه می‌دهد ویژگی‌هایی مانند منوها، گفتگوها و نوارهای جانبی را اضافه کند.
openById(id) Document سند را با شناسه مشخص شده برمی گرداند.
openByUrl(url) Document سند را با URL مشخص شده باز می کند و برمی گرداند.

مستندات دقیق

create(name)

یک سند جدید ایجاد و برمی گرداند.

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

مولفه های

نام تایپ کنید شرح
name String نام سند جدید

برگشت

Document - نمونه سند جدید

مجوز

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

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

getActiveDocument()

سندی را که اسکریپت به آن محدود شده است برمی‌گرداند. برای تعامل با سندی که اسکریپت به آن محدود نشده است، به جای آن از openById(id) یا openByUrl(url) استفاده کنید.

// Get the document to which this script is bound.
var doc = DocumentApp.getActiveDocument();

برگشت

Document - نمونه سند

مجوز

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

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

getUi()

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

// Add a custom menu to the active document, including a separator and a sub-menu.
function onOpen(e) {
  DocumentApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(DocumentApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

برگشت

Ui - نمونه ای از محیط رابط کاربری این سند

openById(id)

سند را با شناسه مشخص شده برمی گرداند. اگر اسکریپت به سند متصل است، به جای آن از getActiveDocument() استفاده کنید.

// Open a document by ID.
var doc = DocumentApp.openById('DOCUMENT_ID_GOES_HERE');

مولفه های

نام تایپ کنید شرح
id String شناسه سند برای باز کردن

برگشت

Document - نمونه سند

مجوز

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

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

openByUrl(url)

سند را با URL مشخص شده باز می کند و برمی گرداند. اگر اسکریپت به سند متصل است، به جای آن از getActiveDocument() استفاده کنید.

// Open a document by URL.
var doc = DocumentApp.openByUrl(
    'https://docs.google.com/document/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit');

مولفه های

نام تایپ کنید شرح
url String نشانی اینترنتی سند برای باز کردن

برگشت

Document - نمونه سند

مجوز

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

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