สคริปต์จะเชื่อมโยงกับไฟล์ Google ชีต เอกสาร สไลด์ หรือฟอร์ม หากสร้างขึ้นจากเอกสารนั้นแทนที่จะเป็นสคริปต์แบบสแตนด์อโลน ไฟล์ที่สคริปต์เชื่อมโยงอยู่นี้เรียกว่า "คอนเทนเนอร์" โดยทั่วไปแล้ว สคริปต์ที่ผูกไว้จะทำงานเหมือนสคริปต์แบบสแตนด์อโลน แต่จะไม่ปรากฏใน Google ไดรฟ์ แยกออกจากไฟล์ไม่ได้ และจะได้รับสิทธิพิเศษบางอย่างเหนือไฟล์หลัก
โปรดทราบว่าสคริปต์เชื่อมโยงกับ Google Sites ได้ด้วย แต่สคริปต์เหล่านี้มักจะใช้งานเป็นเว็บแอปเกือบทุกครั้ง สคริปต์ที่ผูกกับ Google ชีต, เอกสาร, สไลด์ หรือฟอร์มอาจกลายเป็นเว็บแอปได้เช่นกัน แต่ไม่ใช่เรื่องปกติ
สร้างสคริปต์ที่เชื่อมโยง
Google เอกสาร ชีต หรือสไลด์
หากต้องการสร้างสคริปต์ที่เชื่อมโยงใน Google เอกสาร ชีต หรือสไลด์ ให้เปิดเอกสารในเอกสาร สเปรดชีตในชีต หรืองานนำเสนอในสไลด์ แล้วคลิกส่วนขยาย > สคริปต์ Apps หากต้องการเปิดสคริปต์อีกครั้งในอนาคต ให้ทำแบบเดียวกันนี้หรือเปิดสคริปต์จากหน้าแดชบอร์ดของ Apps Script
Google ฟอร์ม
หากต้องการสร้างสคริปต์ที่เชื่อมโยงใน Google ฟอร์ม ให้เปิดแบบฟอร์มและคลิกเพิ่มเติม > โปรแกรมแก้ไขสคริปต์ หากต้องการเปิดสคริปต์อีกครั้งในอนาคต ให้ทำแบบเดียวกันนี้หรือเปิดสคริปต์จากหน้าแดชบอร์ดของ Apps Script
วิธีการพิเศษ
สคริปต์ที่กำหนดขอบเขตจะเรียกเมธอดบางอย่างที่สคริปต์แบบสแตนด์อโลนทำไม่ได้ ดังนี้
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 ไดรฟ์