Class PageProtection

ページ保護

非推奨。新しいバージョンの Google スプレッドシートで作成されたスプレッドシートの場合は、代わりにより強力な Protection クラスを使用します。このクラスは非推奨ですが、古いバージョンのスプレッドシートとの互換性を確保するために引き続き使用できます。

古いバージョンの Google スプレッドシートで保護されたシートにアクセスして変更する。

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

サポート終了のメソッド

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

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

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

パラメータ

名前型説明
emailString追加するユーザーのメールアドレス。

関連情報

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

このシートを編集できるユーザーのメールアドレスのリストを返します。

シート保護が無効になっている場合、この呼び出しによって返される値は無意味です。

戻る

String[] - このシートを編集できるユーザーのメールアドレスの配列

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

シートでシート保護が有効になっているかどうかを示します。 

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

戻る

Boolean - シートの保護が有効かどうか

関連情報

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

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

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

パラメータ

名前型説明
userString削除するユーザーのメールアドレス。

関連情報

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

シートの保護ステータスを設定します。

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

パラメータ

名前型説明
protectionBooleantrue: シート保護を有効にします。false: シート保護を無効にします。

関連情報