Class PropertiesService

PropertiesService

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