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