หน้านี้ได้รับการแปลโดย Cloud Translation API

Class PageProtection

เลิกใช้งานแล้ว สำหรับสเปรดชีตที่สร้างใน Google ชีตเวอร์ชันใหม่กว่า ให้ใช้คลาส Protection ที่มีประสิทธิภาพมากกว่าแทน แม้ว่าชั้นเรียนนี้จะเลิกใช้งานไปแล้ว แต่ชั้นเรียนนี้ยังคงพร้อมใช้งานร่วมกับชีตเวอร์ชันเก่าได้

เข้าถึงและแก้ไขชีตที่มีการป้องกันใน Google ชีตเวอร์ชันเก่า

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

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`addUser(email)`	`void`	เพิ่มผู้ใช้ไปยังรายชื่อผู้ใช้ที่มีสิทธิ์แก้ไขชีตได้ หากมีการป้องกันไว้
`getUsers()`	`String[]`	แสดงรายการอีเมลของผู้ใช้ที่สามารถแก้ไขชีตนี้ได้
`isProtected()`	`Boolean`	ระบุว่าแผ่นงานได้เปิดใช้การป้องกันแผ่นงานไว้หรือไม่
`removeUser(user)`	`void`	นำผู้ใช้ออกจากรายชื่อผู้ใช้ที่มีสิทธิ์แก้ไขชีตได้
`setProtected(protection)`	`void`	ตั้งสถานะการป้องกันชีต

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

`addUser(email)`

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

เพิ่มผู้ใช้ไปยังรายชื่อผู้ใช้ที่มีสิทธิ์แก้ไขชีตได้ หากมีการป้องกันไว้

// Add the "user@example.com" user to the list of users who can edit this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.addUser('user@example.com');
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`email`	`String`	อีเมลของผู้ใช้ที่จะเพิ่ม

ดูเพิ่มเติม

removeUser(user)

`getUsers()`

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

แสดงรายการอีเมลของผู้ใช้ที่สามารถแก้ไขชีตนี้ได้

หากปิดใช้การป้องกันแผ่นงาน ค่าที่เรียกกลับมาจากการเรียกนี้จะไม่มีความหมาย

รีเทิร์น

String[] — อาร์เรย์อีเมลของผู้ใช้ที่แก้ไขชีตนี้ได้

`isProtected()`

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

ระบุว่าแผ่นงานได้เปิดใช้การป้องกันแผ่นงานไว้หรือไม่

// Determine whether or not sheet protection is enabled
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
var isProtected = permissions.isProtected();

รีเทิร์น

Boolean — แผ่นงานจะมีการเปิดใช้การป้องกันแผ่นงานหรือไม่

ดูเพิ่มเติม

setProtected(protection)

`removeUser(user)`

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

นำผู้ใช้ออกจากรายชื่อผู้ใช้ที่มีสิทธิ์แก้ไขชีตได้

// Remove the "user@example.com" user to the list of users who can edit this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.removeUser('user@example.com');
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`user`	`String`	อีเมลของผู้ใช้ที่จะนำออก

ดูเพิ่มเติม

addUser(email)

`setProtected(protection)`

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

ตั้งสถานะการป้องกันชีต

// Enables sheet protection for  this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`protection`	`Boolean`	`true` เพื่อเปิดใช้การป้องกันชีต `false` เพื่อปิดใช้การป้องกันชีต

ดูเพิ่มเติม

isProtected()