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');

प्रॉपर्टी

प्रॉपर्टीTypeब्यौरा
AttributeAttributeAttribute की गिनती.
ElementTypeElementTypeElementType की गिनती.
FontFamilyFontFamilyFontFamily की गिनती.
GlyphTypeGlyphTypeGlyphType की गिनती.
HorizontalAlignmentHorizontalAlignmentHorizontalAlignment की गिनती.
ParagraphHeadingParagraphHeadingParagraphHeading की गिनती.
PositionedLayoutPositionedLayoutPositionedLayout की गिनती.
TextAlignmentTextAlignmentTextAlignment की गिनती.
VerticalAlignmentVerticalAlignmentVerticalAlignment की गिनती.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
create(name)Documentनया दस्तावेज़ बनाता है और उसे दिखाता है.
getActiveDocument()Documentवह दस्तावेज़ लौटाता है जिसकी स्क्रिप्ट कंटेनर-बाउंड है.
getUi()Uiदस्तावेज़ के यूज़र-इंटरफ़ेस एनवायरमेंट का इंस्टेंस दिखाता है. इससे स्क्रिप्ट, मेन्यू, डायलॉग, और साइडबार जैसी सुविधाएं जोड़ पाता है.
openById(id)Documentदिए गए आईडी वाला दस्तावेज़ दिखाता है.
openByUrl(url)Documentबताए गए यूआरएल वाले दस्तावेज़ को खोलता है और उसे दिखाता है.

ज़्यादा जानकारी के साथ दस्तावेज़

create(name)

नया दस्तावेज़ बनाता है और उसे दिखाता है.

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

पैरामीटर

नामTypeब्यौरा
nameStringनए दस्तावेज़ का नाम

रिटर्न

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');

पैरामीटर

नामTypeब्यौरा
idStringउस दस्तावेज़ का आईडी जिसे आपको खोलना है

रिटर्न

Document — दस्तावेज़ इंस्टेंस

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

openByUrl(url)

बताए गए यूआरएल वाले दस्तावेज़ को खोलता है और उसे दिखाता है. अगर स्क्रिप्ट, दस्तावेज़ के अंदर कंटेनर के तौर पर लिखी होती है, तो इसके बजाय getActiveDocument() का इस्तेमाल करें.

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

पैरामीटर

नामTypeब्यौरा
urlStringउस दस्तावेज़ का यूआरएल डालें जिसे आपको खोलना है

रिटर्न

Document — दस्तावेज़ इंस्टेंस

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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