Class PropertiesService

พร็อพเพอร์ตี้บริการ

อนุญาตให้สคริปต์จัดเก็บข้อมูลทั่วไปในคู่คีย์-ค่าที่มีขอบเขตเป็นสคริปต์เดียว ผู้ใช้สคริปต์รายเดียว หรือเอกสารเดียวที่ใช้ส่วนเสริม คุณจะแชร์พร็อพเพอร์ตี้ระหว่างสคริปต์ไม่ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับกรณีที่ควรใช้พร็อพเพอร์ตี้แต่ละประเภทได้ที่คู่มือบริการพร็อพเพอร์ตี้ 

// 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');

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getDocumentProperties()Propertiesรับที่เก็บพร็อพเพอร์ตี้ (สำหรับสคริปต์นี้เท่านั้น) ที่ผู้ใช้ทุกคนเข้าถึงได้ภายในเอกสาร สเปรดชีต หรือแบบฟอร์มที่เปิดอยู่
getScriptProperties()Propertiesรับที่เก็บพร็อพเพอร์ตี้ที่ผู้ใช้ทุกคนเข้าถึงได้ แต่ภายในสคริปต์นี้เท่านั้น
getUserProperties()Propertiesรับที่เก็บพร็อพเพอร์ตี้ที่มีเพียงผู้ใช้ปัจจุบันเท่านั้นที่เข้าถึงได้ และภายในสคริปต์นี้เท่านั้น

เอกสารประกอบโดยละเอียด

getDocumentProperties()

รับที่เก็บพร็อพเพอร์ตี้ (สำหรับสคริปต์นี้เท่านั้น) ที่ผู้ใช้ทุกคนเข้าถึงได้ภายในเอกสาร สเปรดชีต หรือแบบฟอร์มที่เปิดอยู่ ตัวเลือกนี้จะใช้ได้ก็ต่อเมื่อสคริปต์ได้รับการเผยแพร่และใช้งานเป็นส่วนเสริม หรือเชื่อมโยงกับประเภทไฟล์ Google เมื่อพร็อพเพอร์ตี้เอกสารไม่พร้อมใช้งาน วิธีการนี้จะแสดงผลเป็น null พร็อพเพอร์ตี้เอกสารที่สร้างโดยสคริปต์จะเข้าถึงไม่ได้นอกสคริปต์นั้น แม้ว่าสคริปต์อื่นๆ จะเข้าถึงเอกสารเดียวกันก็ตาม

รีเทิร์น

Properties — พื้นที่เก็บข้อมูลพร็อพเพอร์ตี้สำหรับสคริปต์นี้เท่านั้นที่ผู้ใช้เอกสารปัจจุบันทุกคนเข้าถึงได้ หรือ null หากสคริปต์ไม่ใช่ส่วนเสริมหรือเชื่อมโยงกับไฟล์ Google Workspace

getScriptProperties()

รับที่เก็บพร็อพเพอร์ตี้ที่ผู้ใช้ทุกคนเข้าถึงได้ แต่ภายในสคริปต์นี้เท่านั้น

รีเทิร์น

Properties — พื้นที่เก็บข้อมูลพร็อพเพอร์ตี้ที่ผู้ใช้สคริปต์ทุกคนเข้าถึงได้

getUserProperties()

รับที่เก็บพร็อพเพอร์ตี้ที่มีเพียงผู้ใช้ปัจจุบันเท่านั้นที่เข้าถึงได้ และภายในสคริปต์นี้เท่านั้น

รีเทิร์น

Properties — พื้นที่เก็บข้อมูลพร็อพเพอร์ตี้ที่มีเพียงผู้ใช้ปัจจุบันของสคริปต์เท่านั้นที่เข้าถึงได้