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