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