อนุญาตให้สคริปต์จัดเก็บข้อมูลแบบง่ายในคู่คีย์-ค่าที่กําหนดขอบเขตไว้เป็นสคริปต์ 1 รายการ ผู้ใช้ 1 รายของสคริปต์ หรือ 1 เอกสารที่ใช้ส่วนเสริม แชร์พร็อพเพอร์ตี้ระหว่างสคริปต์ไม่ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับกรณีที่ควรใช้พร็อพเพอร์ตี้แต่ละประเภทได้ที่คู่มือบริการพร็อพเพอร์ตี้
// Sets three properties of different types. var documentProperties = PropertiesService.getDocumentProperties(); var scriptProperties = PropertiesService.getScriptProperties(); var userProperties = PropertiesService.getUserProperties(); documentProperties.setProperty('DAYS_TO_FETCH', '5'); scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/MyWeatherService/'); userProperties.setProperty('DISPLAY_UNITS', 'metric');
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
getDocumentProperties() | Properties | รับที่เก็บพร็อพเพอร์ตี้ (สําหรับสคริปต์นี้เท่านั้น) ที่ผู้ใช้เข้าถึงได้ทั้งหมดในเอกสารที่เปิดอยู่ สเปรดชีต หรือแบบฟอร์ม |
getScriptProperties() | Properties | รับที่เก็บพร็อพเพอร์ตี้ที่ผู้ใช้ทั้งหมดเข้าถึงได้ แต่เฉพาะในสคริปต์นี้เท่านั้น |
getUserProperties() | Properties | รับที่เก็บพร็อพเพอร์ตี้ที่มีเฉพาะผู้ใช้ปัจจุบันเท่านั้นที่สามารถเข้าถึงได้ และภายในสคริปต์นี้เท่านั้น |
เอกสารประกอบโดยละเอียด
getDocumentProperties()
รับที่เก็บพร็อพเพอร์ตี้ (สําหรับสคริปต์นี้เท่านั้น) ที่ผู้ใช้เข้าถึงได้ทั้งหมดในเอกสารที่เปิดอยู่ สเปรดชีต หรือแบบฟอร์ม และจะพร้อมใช้งานต่อเมื่อสคริปต์ได้รับการเผยแพร่และแสดงเป็นส่วนเสริมหรือหากเชื่อมโยงกับประเภทไฟล์ Google เท่านั้น เมื่อไม่มีพร็อพเพอร์ตี้เอกสาร เมธอดนี้จะส่งคืน null
พร็อพเพอร์ตี้เอกสารที่สร้างโดยสคริปต์จะเข้าถึงไม่ได้นอกสคริปต์นั้น แม้แต่สคริปต์อื่นๆ ที่เข้าถึงเอกสารเดียวกัน
ไปกลับ
Properties
— ที่เก็บพร็อพเพอร์ตี้สําหรับสคริปต์นี้เฉพาะที่ผู้ใช้เอกสารปัจจุบันทุกคนเข้าถึงได้ หรือ null
หากสคริปต์ไม่ใช่ส่วนเสริมหรือเชื่อมโยงกับไฟล์ Google Workspace
getScriptProperties()
รับที่เก็บพร็อพเพอร์ตี้ที่ผู้ใช้ทั้งหมดเข้าถึงได้ แต่เฉพาะในสคริปต์นี้เท่านั้น
ไปกลับ
Properties
— ที่เก็บพร็อพเพอร์ตี้ที่ผู้ใช้สคริปต์ทุกคนเข้าถึงได้
getUserProperties()
รับที่เก็บพร็อพเพอร์ตี้ที่มีเฉพาะผู้ใช้ปัจจุบันเท่านั้นที่สามารถเข้าถึงได้ และภายในสคริปต์นี้เท่านั้น
ไปกลับ
Properties
— ที่เก็บพร็อพเพอร์ตี้ที่มีเฉพาะผู้ใช้ปัจจุบันของสคริปต์เท่านั้นที่เข้าถึงได้