Class PageProtection

PageProtection

非推奨。Google スプレッドシートの新しいバージョンで作成したスプレッドシートでは、 Protection クラスを使用してください。このクラスは非推奨となりましたが、引き続き利用できます。 古いバージョンのスプレッドシートとの互換性も確認されています。

旧バージョンの Google スプレッドシートで、保護されているシートへのアクセスと変更を行えます。

サポート終了のメソッド

メソッド	戻り値の型	概要
addUser(email)	void	シートが保護されている場合は、シートを編集できるユーザーのリストにユーザーを追加します。
getUsers()	String[]	このシートを編集できるユーザーのメールアドレスのリストを返します。
isProtected()	Boolean	シートでシート保護が有効になっているかどうかを示します。
removeUser(user)	void	シートを編集できるユーザーの一覧からユーザーを削除します。
setProtected(protection)	void	シートの保護ステータスを設定します。

サポート終了のメソッド

addUser(email)

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

シートが保護されている場合は、シートを編集できるユーザーのリストにユーザーを追加します。

// Add the "[e-mail]" user to the list of users who can edit this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.addUser('[e-mail]');
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 "[e-mail]" user to the list of users who can edit this sheet
var sheet = SpreadsheetApp.getActiveSheet();
var permissions = sheet.getSheetProtection();
permissions.removeUser('[e-mail]');
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()