บริการพร็อพเพอร์ตี้ช่วยให้คุณเก็บข้อมูลแบบง่ายในคู่คีย์-ค่าที่มีขอบเขตอยู่ที่สคริปต์ 1 รายการ ผู้ใช้สคริปต์ 1 ราย หรือเอกสาร 1 ฉบับที่ใช้ส่วนเสริม โดยปกติมักใช้เพื่อจัดเก็บการกำหนดค่าของนักพัฒนาซอฟต์แวร์หรือค่ากำหนดของผู้ใช้ โดยจะไม่มีการแชร์พร็อพเพอร์ตี้ระหว่างสคริปต์ต่างๆ
หากต้องการดูโควต้ารายวันและขีดจำกัดพื้นที่เก็บข้อมูลสำหรับบริการพร็อพเพอร์ตี้ โปรดดูโควต้าสำหรับบริการของ Google
การเปรียบเทียบร้านค้าอสังหาริมทรัพย์
ออบเจ็กต์ส่วนกลาง PropertiesService
มี 3 วิธี ซึ่งแต่ละวิธีจะแสดงผลออบเจ็กต์ Properties
ที่คล้ายกันแต่มีสิทธิ์การเข้าถึงแตกต่างกัน ดังที่แสดงในตารางต่อไปนี้
คุณสมบัติของสคริปต์ | พร็อพเพอร์ตี้ผู้ใช้ | คุณสมบัติของเอกสาร | |
---|---|---|---|
วิธีเข้าถึง | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
ข้อมูลที่แชร์ระหว่าง | ผู้ใช้ทั้งหมดของสคริปต์ ส่วนเสริม หรือเว็บแอป | ผู้ใช้ปัจจุบันของสคริปต์ ส่วนเสริม หรือเว็บแอป | ผู้ใช้ทั้งหมดของส่วนเสริมในเอกสารที่เปิดอยู่ |
ปกติแล้วใช้สำหรับ | ข้อมูลการกำหนดค่าทั่วทั้งแอป เช่น ชื่อผู้ใช้และรหัสผ่านสำหรับฐานข้อมูลภายนอกของนักพัฒนาซอฟต์แวร์ | การตั้งค่าเฉพาะผู้ใช้ เช่น หน่วยเมตริกหรือหน่วยอิมพีเรียล | ข้อมูลเฉพาะเอกสาร เช่น URL แหล่งที่มาของแผนภูมิที่ฝัง |
รูปแบบข้อมูล
บริการพร็อพเพอร์ตี้จะเก็บข้อมูลทั้งหมดเป็นสตริงในคู่คีย์-ค่า ระบบจะแปลงประเภทข้อมูลที่ไม่ใช่สตริงเป็นสตริงโดยอัตโนมัติ ซึ่งรวมถึงวิธีการที่มีอยู่ในออบเจ็กต์ที่บันทึกไว้
กำลังบันทึกข้อมูล
หากต้องการบันทึกค่าเดียว ให้เรียกเมธอด Properties.setProperty(key,
value)
ของ Store ที่เหมาะสม ดังที่แสดงในตัวอย่างต่อไปนี้
หากต้องการบันทึกข้อมูลจำนวนมาก ให้ส่งการแมปคู่คีย์-ค่าไปยัง Properties.setProperties(properties)
คู่คีย์-ค่าแต่ละคู่ของออบเจ็กต์ในพารามิเตอร์จะจัดเก็บเป็นพร็อพเพอร์ตี้แยกกัน
กำลังอ่านข้อมูล
หากต้องการดึงค่าเดียวที่คุณบันทึกไว้ก่อนหน้านี้ ให้เรียกใช้ Properties.getProperty(key)
ดังนี้
หากต้องการดึงข้อมูลค่าทั้งหมดในพื้นที่เก็บข้อมูลพร็อพเพอร์ตี้ปัจจุบัน ให้เรียกใช้ Properties.getProperties()
ดังนี้
การแก้ไขข้อมูล
เมธอด getProperty()
และ getProperties()
จะแสดงสำเนาของข้อมูลที่จัดเก็บไว้ ไม่ใช่มุมมองจริง ดังนั้นการเปลี่ยนออบเจ็กต์ที่แสดงผลจะไม่อัปเดตค่าในที่เก็บพร็อพเพอร์ตี้ หากต้องการอัปเดตข้อมูลในสโตร์ ให้บันทึกอีกครั้ง:
การลบข้อมูล
หากต้องการลบค่าเดียว ให้เรียกใช้
Properties.deleteProperty(key)
โดยทำดังนี้
หากต้องการลบพร็อพเพอร์ตี้ทั้งหมดใน Store ปัจจุบัน ให้เรียกใช้ Properties.deleteAllProperties()
โดยทำดังนี้
จัดการพร็อพเพอร์ตี้ของสคริปต์ด้วยตนเอง
คุณเพิ่มพร็อพเพอร์ตี้ที่กำหนดเองเป็นสตริงในคู่คีย์-ค่าด้วยตนเองได้สูงสุด 50 รายการจากหน้าการตั้งค่าโปรเจ็กต์ หากต้องการเพิ่มมากกว่า 50 พร็อพเพอร์ตี้ คุณจะต้องเพิ่มพร็อพเพอร์ตี้แบบเป็นโปรแกรมโดยใช้วิธีการที่อธิบายไว้ข้างต้นในการบันทึกข้อมูล เมื่อตั้งค่าพร็อพเพอร์ตี้สคริปต์จากหน้าการตั้งค่าโปรเจ็กต์ คุณจะอ้างอิงตัวแปรสคริปต์ไม่ได้
เพิ่มพร็อพเพอร์ตี้ของสคริปต์
- เปิดโปรเจ็กต์ Apps Script
- คลิกการตั้งค่าโปรเจ็กต์
ทางด้านซ้าย
- หากต้องการเพิ่มพร็อพเพอร์ตี้แรก ให้คลิกเพิ่มพร็อพเพอร์ตี้ของสคริปต์ในส่วนคุณสมบัติของสคริปต์
- หากต้องการเพิ่มพร็อพเพอร์ตี้ที่ 2 และพร็อพเพอร์ตี้ต่อมา ใต้คุณสมบัติของสคริปต์ ให้คลิกแก้ไขพร็อพเพอร์ตี้ของสคริปต์ > เพิ่มพร็อพเพอร์ตี้ของสคริปต์
- สําหรับพร็อพเพอร์ตี้ ให้ป้อนชื่อคีย์
- สำหรับค่า ให้ป้อนค่าของคีย์
- (ไม่บังคับ) หากต้องการเพิ่มพร็อพเพอร์ตี้อีก ให้คลิกเพิ่มพร็อพเพอร์ตี้ของสคริปต์
- คลิกบันทึกคุณสมบัติของสคริปต์
แก้ไขพร็อพเพอร์ตี้ของสคริปต์
- เปิดโปรเจ็กต์ Apps Script
- คลิกการตั้งค่าโปรเจ็กต์
ทางด้านซ้าย
- ในส่วนคุณสมบัติของสคริปต์ ให้คลิกแก้ไขคุณสมบัติของสคริปต์
- เปลี่ยนชื่อคีย์และคีย์-ค่าสำหรับแต่ละพร็อพเพอร์ตี้ที่ต้องการเปลี่ยนแปลง
- คลิกบันทึกคุณสมบัติของสคริปต์
ลบพร็อพเพอร์ตี้ของสคริปต์
- เปิดโปรเจ็กต์ Apps Script
- คลิกการตั้งค่าโปรเจ็กต์
ทางด้านซ้าย
- ในส่วนคุณสมบัติของสคริปต์ ให้คลิกแก้ไขคุณสมบัติของสคริปต์
- คลิก "นำออก" ข้างพร็อพเพอร์ตี้ที่คุณต้องการลบ
- คลิกบันทึกคุณสมบัติของสคริปต์