PageProtection
非推奨。新しいバージョンの Google スプレッドシートで作成されたスプレッドシートでは、代わりにより強力な Protection
クラスを使用してください。このクラスは非推奨ですが、スプレッドシートの旧バージョンとの互換性を維持するために引き続き使用できます。
以前のバージョンの Google スプレッドシートで、保護されているシートへのアクセスと変更を行います。
サポート終了のメソッド
メソッド | 戻り値の型 | 概要 |
---|---|---|
| void | シートが保護されている場合、編集できるユーザーのリストにユーザーを追加します。 |
| String[] | このシートを編集できるユーザーのメールアドレスのリストを返します。 |
| Boolean | シートでシートの保護が有効になっているかどうかを示します。 |
| void | シートを編集できるユーザーリストから、ユーザーを削除します。 |
| void | シートの保護ステータスを設定します。 |
サポート終了のメソッド
addUser(email)
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 | 追加するユーザーのメールアドレス。 |
関連ドキュメント
getUsers()
getUsers()
非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。
このシートを編集できるユーザーのメールアドレスのリストを返します。
シートの保護が無効になっている場合、この呼び出しによって返される値は無意味です。
リターン
String[]
- このシートを編集できるユーザーのメールアドレスの配列
isProtected()
isProtected()
非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。
シートでシートの保護が有効になっているかどうかを示します。
// Determine whether or not sheet protection is enabled var sheet = SpreadsheetApp.getActiveSheet(); var permissions = sheet.getSheetProtection(); var isProtected = permissions.isProtected();
リターン
Boolean
- シートでシートの保護が有効かどうか
関連ドキュメント
removeUser(user)
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 | 削除するユーザーのメールアドレス。 |
関連ドキュメント
setProtected(protection)
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 でシートの保護を無効にします。 |