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
const sheet = SpreadsheetApp.getActiveSheet();
const 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
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
const isProtected = permissions.isProtected();

戻る

Boolean - シートでシートの保護が有効になっているかどうか。

関連情報

• setProtected(protection)

---

removeUser(user)

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

シートを編集できるユーザーのリストからユーザーを削除します。

// Remove the "[e-mail]" user to the list of users who can edit this
// sheet
const sheet = SpreadsheetApp.getActiveSheet();
const 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
const sheet = SpreadsheetApp.getActiveSheet();
const permissions = sheet.getSheetProtection();
permissions.setProtected(true);
sheet.setSheetProtection(permissions);

パラメータ

名前	型	説明
protection	Boolean	シートの保護を有効にする場合は true、シートの保護を無効にする場合は false。

関連情報

• isProtected()