หน้านี้ได้รับการแปลโดย 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`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);

พารามิเตอร์

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

ดูเพิ่มเติม

isProtected()