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