Class PropertiesService

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

อนุญาตให้สคริปต์จัดเก็บข้อมูลอย่างง่ายในคู่คีย์-ค่าที่กำหนดขอบเขตไว้สำหรับสคริปต์ 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');

เมธอด

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

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

getDocumentProperties()

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

รีเทิร์น

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

getScriptProperties()

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

รีเทิร์น

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

getUserProperties()

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

รีเทิร์น

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