บริการเอกสารจะสร้างและเปิด Documents
ที่แก้ไขได้
// Open a document by ID. // TODO(developer): Replace the ID with your own. let doc = DocumentApp.openById('DOCUMENT_ID'); // Create and open a document. doc = DocumentApp.create('Document Name');
พร็อพเพอร์ตี้
พร็อพเพอร์ตี้ | ประเภท | คำอธิบาย |
---|---|---|
Attribute | Attribute | การแจงนับ Attribute |
ElementType | ElementType | การแจงนับ ElementType |
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. const doc = DocumentApp.create('Document Name');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อของเอกสารใหม่ |
รีเทิร์น
Document
— อินสแตนซ์เอกสารใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents
getActiveDocument()
แสดงผลเอกสารที่สคริปต์เชื่อมโยงกับคอนเทนเนอร์ หากต้องการโต้ตอบกับเอกสารที่ไม่ได้เชื่อมโยงสคริปต์กับคอนเทนเนอร์ ให้ใช้ openById(id)
หรือ openByUrl(url)
แทน
// Get the document to which this script is bound. const doc = DocumentApp.getActiveDocument();
รีเทิร์น
Document
— อินสแตนซ์เอกสาร
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getUi()
แสดงอินสแตนซ์ของสภาพแวดล้อมอินเทอร์เฟซผู้ใช้ของเอกสาร ซึ่งช่วยให้สคริปต์เพิ่มฟีเจอร์ต่างๆ เช่น เมนู กล่องโต้ตอบ และแถบด้านข้างได้ สคริปต์จะโต้ตอบกับ UI ของอินสแตนซ์ปัจจุบันของเอกสารที่เปิดอยู่ได้ก็ต่อเมื่อสคริปต์เชื่อมโยงกับเอกสารเท่านั้น ดูข้อมูลเพิ่มเติมได้ที่คู่มือเมนูและกล่องโต้ตอบและแถบด้านข้าง
// 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. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('DOCUMENT_ID');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
id | String | รหัสของเอกสารที่จะเปิด |
รีเทิร์น
Document
— อินสแตนซ์เอกสาร
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents
openByUrl(url)
เปิดและแสดงเอกสารที่มี URL ที่ระบุ หากสคริปต์เชื่อมโยงกับคอนเทนเนอร์ของเอกสาร ให้ใช้ getActiveDocument()
แทน
// Open a document by URL. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit', );
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
url | String | URL ของเอกสารที่จะเปิด |
รีเทิร์น
Document
— อินสแตนซ์เอกสาร
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents