อนุญาตให้สคริปต์จัดเก็บข้อมูลแบบง่ายในคู่คีย์-ค่าที่กำหนดขอบเขตไว้เป็นสคริปต์เดียว หรือเอกสารหนึ่งฉบับที่ใช้ส่วนเสริม แชร์พร็อพเพอร์ตี้ระหว่างสคริปต์ไม่ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับกรณีที่ควรใช้พร็อพเพอร์ตี้แต่ละประเภทได้ที่คำแนะนำเกี่ยวกับบริการพร็อพเพอร์ตี้
// 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
— ที่จัดเก็บพร็อพเพอร์ตี้ที่เฉพาะผู้ใช้ปัจจุบันของสคริปต์ที่เข้าถึงได้