สคริปต์จะผูกกับไฟล์ Google ชีต, เอกสาร, สไลด์ หรือฟอร์ม หากสร้างจากเอกสารนั้นไม่ใช่สคริปต์แบบสแตนด์อโลน ไฟล์ที่สคริปต์ที่เชื่อมโยงแนบอยู่จะเรียกว่า "คอนเทนเนอร์" โดยทั่วไปสคริปต์ที่ผูกไว้จะทำงานเหมือนกับสคริปต์แบบสแตนด์อโลน เว้นแต่ว่าจะไม่ปรากฏใน Google ไดรฟ์ ซึ่งไม่สามารถแยกออกจากไฟล์ที่เชื่อมโยงกับไฟล์หลักได้ รวมทั้งจะได้รับสิทธิพิเศษบางอย่างเหนือไฟล์หลักด้วย
โปรดทราบว่าสคริปต์ยังเชื่อมโยงกับ Google Sites ได้ด้วย แต่สคริปต์เหล่านี้มักจะใช้งานเป็นเว็บแอปเสมอ สคริปต์ที่เชื่อมโยงกับ Google ชีต เอกสาร สไลด์ หรือฟอร์มอาจกลายเป็นเว็บแอปได้เช่นกัน แต่ไม่เกิดขึ้นบ่อยนัก
สร้างสคริปต์ที่เชื่อมโยง
Google เอกสาร, ชีต หรือสไลด์
ในการสร้างสคริปต์ที่เชื่อมโยงใน Google เอกสาร, ชีต หรือสไลด์ ให้เปิดเอกสารใน Google เอกสาร สเปรดชีตในชีต หรืองานนำเสนอในสไลด์ และคลิกส่วนขยาย > สคริปต์ Apps หากต้องการเปิดสคริปต์อีกครั้งในอนาคต ให้ทำตามขั้นตอนเดิมหรือเปิดสคริปต์จากหน้าแดชบอร์ด Apps Script
Google ฟอร์ม
หากต้องการสร้างสคริปต์ที่เชื่อมโยงใน Google ฟอร์ม ให้เปิดแบบฟอร์มแล้วคลิกเพิ่มเติม > ตัวแก้ไขสคริปต์ หากต้องการเปิดสคริปต์อีกครั้งในอนาคต ให้ทำแบบเดียวกันหรือเปิดสคริปต์จากหน้าแดชบอร์ด Apps Script
วิธีการพิเศษ
สคริปต์ที่ผูกกับสคริปต์อาจเรียกใช้เมธอด 2-3 วิธีที่สคริปต์แบบสแตนด์อโลนจะทำสิ่งต่อไปนี้ไม่ได้
getActiveSpreadsheet()
,getActiveDocument()
,getActivePresentation()
และgetActiveForm()
อนุญาตให้สคริปต์ที่เชื่อมโยงอ้างอิงไฟล์หลักโดยไม่ต้องอ้างอิงรหัสของไฟล์getUi
อนุญาตให้สคริปต์ที่เชื่อมโยงเข้าถึงอินเทอร์เฟซผู้ใช้ของไฟล์หลักเพื่อเพิ่มเมนู กล่องโต้ตอบ และแถบด้านข้างที่กำหนดเอง- ใน Google ชีต
getActiveSheet()
,getActiveRange()
และgetActiveCell()
อนุญาตให้สคริปต์ระบุชีตปัจจุบันของผู้ใช้ ช่วงของเซลล์ที่เลือก หรือเลือกแต่ละเซลล์setActiveSheet(sheet)
และsetActiveRange(range)
อนุญาตให้สคริปต์เปลี่ยนตัวเลือกเหล่านั้น - ใน Google เอกสาร
getCursor()
และgetSelection()
อนุญาตให้สคริปต์กำหนดตำแหน่งเคอร์เซอร์หรือข้อความที่เลือกของผู้ใช้setCursor(position)
และsetSelection(range)
อนุญาตให้สคริปต์เปลี่ยนตำแหน่งเหล่านั้น
สำหรับข้อมูลเพิ่มเติม โปรดดูคำแนะนำในการขยาย Google ชีต หรือคู่มือการขยาย Google เอกสาร
เมนูที่กำหนดเอง กล่องโต้ตอบ และแถบด้านข้าง
สคริปต์ที่ผูกกับสคริปต์จะปรับแต่ง Google ชีต เอกสาร และฟอร์มได้โดยการเพิ่มเมนูที่กำหนดเองและกล่องโต้ตอบหรือแถบด้านข้าง อย่างไรก็ตาม โปรดทราบว่าสคริปต์จะโต้ตอบกับอินเทอร์เฟซผู้ใช้สำหรับอินสแตนซ์ปัจจุบันของไฟล์ที่เปิดอยู่เท่านั้น กล่าวคือ สคริปต์ที่ผูกกับเอกสารหนึ่งจะไม่มีผลกับอินเทอร์เฟซผู้ใช้ของเอกสารอีกฉบับหนึ่ง
ส่วนเสริม
ส่วนเสริมจะทำงานภายใน Gmail, Google ชีต, เอกสาร, สไลด์ และฟอร์ม หากคุณได้พัฒนาสคริปต์แบบผูกขาดหรือแบบสแตนด์อโลนไว้และต้องการแชร์กับผู้คนทั่วโลก Apps Script จะช่วยให้คุณpublishสคริปต์เป็นส่วนเสริมเพื่อให้ผู้ใช้รายอื่นติดตั้งจากสโตร์ของส่วนเสริมได้
ทริกเกอร์
สคริปต์ที่ผูกกับสคริปต์สามารถใช้ทริกเกอร์แบบง่าย เช่น ฟังก์ชัน onOpen()
พิเศษ ซึ่งจะทำงานโดยอัตโนมัติเมื่อผู้ใช้ที่มีสิทธิ์แก้ไขเปิดไฟล์ โดยใช้ทริกเกอร์ที่ติดตั้งได้ เช่นเดียวกับสคริปต์ทุกประเภท
ฟังก์ชันที่กำหนดเอง
ฟังก์ชันที่กำหนดเองคือฟังก์ชันในสคริปต์ที่เชื่อมโยงกับ Google ชีต ซึ่งคุณจะเรียกใช้ได้โดยตรงจากเซลล์โดยใช้ไวยากรณ์ =myFunctionName()
ดังนั้นฟังก์ชันที่กำหนดเองจะคล้ายกับฟังก์ชันในตัวหลายร้อยรายการในชีต เช่น AVERAGE
หรือ SUM
แต่ต่างกันตรงที่คุณเป็นผู้กำหนดลักษณะของฟังก์ชันที่กำหนดเอง
เข้าถึงสคริปต์ที่เชื่อมโยง
เฉพาะผู้ใช้ที่มีสิทธิ์แก้ไขคอนเทนเนอร์เท่านั้นที่จะเรียกใช้สคริปต์ที่เชื่อมโยงได้ ผู้ทำงานร่วมกันที่มีสิทธิ์ดูอย่างเดียวจะเปิดเครื่องมือแก้ไขสคริปต์ไม่ได้ แม้ว่าจะทำสำเนาไฟล์คอนเทนเนอร์ไว้ ผู้ทำงานร่วมกันจะกลายเป็นเจ้าของสำเนา และดูและเรียกใช้สำเนาของสคริปต์ได้
หากต้องการดูวิธีแชร์ไฟล์คอนเทนเนอร์ของสคริปต์ โปรดดูแชร์ไฟล์จาก Google ไดรฟ์