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