Class UserProperties

UserProperties

เลิกใช้งานแล้ว คลาสนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

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

วิธีการที่เลิกใช้งานแล้ว

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
deleteAllProperties()	UserProperties	ลบพร็อพเพอร์ตี้ทั้งหมด
deleteProperty(key)	UserProperties	ลบพร็อพเพอร์ตี้ที่มีคีย์ที่ระบุ
getKeys()	String[]	ดาวน์โหลดคีย์ทั้งหมดที่มีอยู่
getProperties()	Object	ดาวน์โหลดพร็อพเพอร์ตี้ที่มีทั้งหมดพร้อมกัน
getProperty(key)	String	แสดงผลค่าที่เชื่อมโยงกับคีย์ที่ระบุหรือค่าว่างหากไม่มีค่าดังกล่าว
setProperties(properties)	UserProperties	ตั้งค่ากลุ่มพร็อพเพอร์ตี้ทั้งหมดที่มาจากออบเจ็กต์ที่ระบุ
setProperties(properties, deleteAllOthers)	UserProperties	ตั้งค่ากลุ่มพร็อพเพอร์ตี้ทั้งหมดที่มาจากออบเจ็กต์ที่ระบุ
setProperty(key, value)	UserProperties	คงค่าที่ระบุในค่าด้วยคีย์ที่ระบุ

วิธีการที่เลิกใช้งานแล้ว

deleteAllProperties()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

ลบพร็อพเพอร์ตี้ทั้งหมด

UserProperties.deleteAllProperties();

รีเทิร์น

UserProperties — ออบเจ็กต์นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม

• deleteProperty(key)

---

deleteProperty(key)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

ลบพร็อพเพอร์ตี้ที่มีคีย์ที่ระบุ

UserProperties.deleteProperty('special');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
key	String	คีย์สำหรับพร็อพเพอร์ตี้ที่จะลบ

รีเทิร์น

UserProperties — ออบเจ็กต์นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม

• deleteAllProperties()

---

getKeys()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

ดาวน์โหลดคีย์ทั้งหมดที่มีอยู่

รีเทิร์น

String[]

---

getProperties()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

ดาวน์โหลดพร็อพเพอร์ตี้ที่มีทั้งหมดพร้อมกัน

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

UserProperties.setProperties({
  "cow"     : "moo",
  "sheep"   : "baa",
  "chicken" : "cluck"
});

// Logs "A cow goes: moo"
Logger.log("A cow goes: %s", UserProperties.getProperty("cow"));

// This makes a copy. Any changes that happen here will not
// be written back to properties.
var animalSounds = UserProperties.getProperties();

// Logs:
// A chicken goes cluck!
// A cow goes moo!
// A sheep goes baa!
for(var kind in animalSounds) {
  Logger.log("A %s goes %s!", kind, animalSounds[kind]);
}

รีเทิร์น

Object — สำเนาของพร็อพเพอร์ตี้ที่มีคู่คีย์-ค่า

---

getProperty(key)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

แสดงผลค่าที่เชื่อมโยงกับคีย์ที่ระบุหรือค่าว่างหากไม่มีค่าดังกล่าว

var specialValue = UserProperties.getProperty('special');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
key	String	คีย์ของค่าที่จะดึง

รีเทิร์น

String — ค่าที่เชื่อมโยงกับคีย์

ดูเพิ่มเติม

• setProperty(key, value)

---

setProperties(properties)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

ตั้งค่ากลุ่มพร็อพเพอร์ตี้ทั้งหมดที่มาจากออบเจ็กต์ที่ระบุ

UserProperties.setProperties({special: 'sauce', 'meaning': 42});

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
properties	Object	ออบเจ็กต์ที่มีพร็อพเพอร์ตี้ที่จะต้องตั้งค่า

รีเทิร์น

UserProperties — ออบเจ็กต์นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม

• setProperty(key, value)

---

setProperties(properties, deleteAllOthers)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

ตั้งค่ากลุ่มพร็อพเพอร์ตี้ทั้งหมดที่มาจากออบเจ็กต์ที่ระบุ

// This deletes all other properties
UserProperties.setProperties({special: 'sauce', 'meaning': 42}, true);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
properties	Object	ออบเจ็กต์ที่มีพร็อพเพอร์ตี้ที่จะต้องตั้งค่า
deleteAllOthers	Boolean	ว่าจะลบพร็อพเพอร์ตี้ที่มีอยู่ทั้งหมดหรือไม่

รีเทิร์น

UserProperties — ออบเจ็กต์นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม

• setProperty(key, value)

---

setProperty(key, value)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรใช้ในสคริปต์ใหม่

คงค่าที่ระบุในค่าด้วยคีย์ที่ระบุ ค่าที่มีอยู่ซึ่งเชื่อมโยงกับ จะถูกเขียนทับ

UserProperties.setProperty('special', 'sauce');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
key	String	คีย์สำหรับพร็อพเพอร์ตี้
value	String	ที่จะเชื่อมโยงกับคีย์

รีเทิร์น

UserProperties — ออบเจ็กต์นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม

• getProperty(key)