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