ออบเจ็กต์พร็อพเพอร์ตี้ทำหน้าที่เป็นอินเทอร์เฟซสำหรับเข้าถึงพร็อพเพอร์ตี้ผู้ใช้ เอกสาร หรือสคริปต์
ประเภทพร็อพเพอร์ตี้เฉพาะขึ้นอยู่กับ 3 วิธีของ PropertiesService
สคริปต์ชื่อ: PropertiesService.getDocumentProperties()
, PropertiesService.getUserProperties()
หรือ PropertiesService.getScriptProperties()
แชร์พร็อพเพอร์ตี้ระหว่างสคริปต์ไม่ได้ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับประเภทพร็อพเพอร์ตี้ โปรดดู
เกี่ยวกับบริการพร็อพเพอร์ตี้
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
deleteAllProperties() | Properties | ลบพร็อพเพอร์ตี้ทั้งหมดใน Store Properties ปัจจุบัน |
deleteProperty(key) | Properties | ลบพร็อพเพอร์ตี้ที่มีคีย์ที่ระบุใน Store ปัจจุบัน Properties |
getKeys() | String[] | รับคีย์ทั้งหมดในร้านค้า Properties ปัจจุบัน |
getProperties() | Object | รับสำเนาคู่คีย์-ค่าทั้งหมดในร้านค้า Properties ปัจจุบัน |
getProperty(key) | String | รับค่าที่เชื่อมโยงกับคีย์ที่ระบุในที่เก็บ Properties ปัจจุบัน หรือ null หากไม่มีคีย์ดังกล่าวอยู่ |
setProperties(properties) | Properties | ตั้งค่าคู่คีย์-ค่าทั้งหมดจากออบเจ็กต์ที่ระบุใน Store Properties ปัจจุบัน |
setProperties(properties, deleteAllOthers) | Properties | ตั้งค่าคู่คีย์-ค่าทั้งหมดจากออบเจ็กต์ที่ระบุในสโตร์ Properties ปัจจุบัน
คุณสามารถเลือกลบพร็อพเพอร์ตี้อื่นๆ ทั้งหมดใน Store ได้ด้วย |
setProperty(key, value) | Properties | ตั้งค่าคู่คีย์-ค่าที่ระบุใน Store ปัจจุบัน Properties |
เอกสารโดยละเอียด
deleteAllProperties()
ลบพร็อพเพอร์ตี้ทั้งหมดใน Store Properties
ปัจจุบัน
// Deletes all user properties. var userProperties = PropertiesService.getUserProperties(); userProperties.deleteAllProperties();
รีเทิร์น
Properties
— ร้านค้า Properties
นี้สำหรับเครือธุรกิจ
deleteProperty(key)
ลบพร็อพเพอร์ตี้ที่มีคีย์ที่ระบุใน Store ปัจจุบัน Properties
// Deletes the user property 'nickname'. var userProperties = PropertiesService.getUserProperties(); userProperties.deleteProperty('nickname');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์ของพร็อพเพอร์ตี้ที่จะลบ |
รีเทิร์น
Properties
— ร้านค้า Properties
นี้สำหรับเครือธุรกิจ
getKeys()
รับคีย์ทั้งหมดในร้านค้า Properties
ปัจจุบัน
// Sets several properties, then logs the value of each key. var scriptProperties = PropertiesService.getScriptProperties(); scriptProperties.setProperties({ 'cow': 'moo', 'sheep': 'baa', 'chicken': 'cluck' }); var keys = scriptProperties.getKeys(); Logger.log('Animals known:'); for (var i = 0; i < keys.length; i++) { Logger.log(keys[i]); }
รีเทิร์น
String[]
— อาร์เรย์ของคีย์ทั้งหมดในร้านค้า Properties
ปัจจุบัน
getProperties()
รับสำเนาคู่คีย์-ค่าทั้งหมดในร้านค้า Properties
ปัจจุบัน โปรดทราบว่า
ออบเจ็กต์ที่แสดงผลไม่ใช่มุมมองแบบเรียลไทม์ของร้านค้า ดังนั้น การเปลี่ยนคุณสมบัติในส่วน
ออบเจ็กต์ที่ส่งคืนจะไม่อัปเดตออบเจ็กต์ในพื้นที่เก็บข้อมูลโดยอัตโนมัติ หรือในทางกลับกัน
// Sets several script properties, then retrieves them and logs them. var scriptProperties = PropertiesService.getScriptProperties(); scriptProperties.setProperties({ 'cow': 'moo', 'sheep': 'baa', 'chicken': 'cluck' }); var animalSounds = scriptProperties.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
— สำเนาคู่คีย์-ค่าทั้งหมดใน Store Properties
ปัจจุบัน
getProperty(key)
รับค่าที่เชื่อมโยงกับคีย์ที่ระบุในที่เก็บ Properties
ปัจจุบัน หรือ null
หากไม่มีคีย์ดังกล่าวอยู่
// Gets the user property 'nickname'. var userProperties = PropertiesService.getUserProperties(); var nickname = userProperties.getProperty('nickname'); Logger.log(nickname);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์ของค่าพร็อพเพอร์ตี้ที่จะดึง |
รีเทิร์น
String
— ค่าที่เชื่อมโยงกับคีย์ที่ระบุในร้านค้า Properties
ปัจจุบัน
setProperties(properties)
ตั้งค่าคู่คีย์-ค่าทั้งหมดจากออบเจ็กต์ที่ระบุใน Store Properties
ปัจจุบัน
// Sets multiple user properties at once. var userProperties = PropertiesService.getUserProperties(); var newProperties = {nickname: 'Bob', region: 'US', language: 'EN'}; userProperties.setProperties(newProperties);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
properties | Object | ออบเจ็กต์ที่มีคู่คีย์-ค่าที่จะตั้งค่า |
รีเทิร์น
Properties
— ร้านค้า Properties
นี้สำหรับเครือธุรกิจ
setProperties(properties, deleteAllOthers)
ตั้งค่าคู่คีย์-ค่าทั้งหมดจากออบเจ็กต์ที่ระบุในสโตร์ Properties
ปัจจุบัน
คุณสามารถเลือกลบพร็อพเพอร์ตี้อื่นๆ ทั้งหมดใน Store ได้ด้วย
// Sets multiple user properties at once while deleting all other user properties. var userProperties = PropertiesService.getUserProperties(); var newProperties = {nickname: 'Bob', region: 'US', language: 'EN'}; userProperties.setProperties(newProperties, true);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
properties | Object | ออบเจ็กต์ที่มีคู่คีย์-ค่าที่จะตั้งค่า |
deleteAllOthers | Boolean | true เพื่อลบคู่คีย์-ค่าอื่นๆ ทั้งหมดในพร็อพเพอร์ตี้
object; false ถึง "ไม่" |
รีเทิร์น
Properties
— ร้านค้า Properties
นี้สำหรับเครือธุรกิจ
setProperty(key, value)
ตั้งค่าคู่คีย์-ค่าที่ระบุใน Store ปัจจุบัน Properties
// Sets the user property 'nickname' to 'Bobby'. var userProperties = PropertiesService.getUserProperties(); userProperties.setProperty('nickname', 'Bobby');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์ของพร็อพเพอร์ตี้ |
value | String | ค่าที่จะเชื่อมโยงกับคีย์ |
รีเทิร์น
Properties
— ร้านค้า Properties
นี้สำหรับเครือธุรกิจ