Diese Seite wurde von der Cloud Translation API übersetzt.

Class Protection

Auf geschützte Bereiche und Tabellenblätter zugreifen und diese ändern. Ein geschützter Bereich kann entweder einen statischen eines Zellenbereichs oder eines benannten Bereichs. Ein geschütztes Tabellenblatt kann ungeschützte Bereiche enthalten. Für Tabellen, die mit der älteren Version von Google Tabellen erstellt wurden, verwenden Sie die PageProtection .

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

// Remove all range protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Protect the active sheet, then remove all other users from the list of editors.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.protect().setDescription('Sample protected sheet');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`addEditor(emailAddress)`	`Protection`	Fügt den angegebenen Nutzer zur Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu.
`addEditor(user)`	`Protection`	Fügt den angegebenen Nutzer zur Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu.
`addEditors(emailAddresses)`	`Protection`	Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu.
`addTargetAudience(audienceId)`	`Protection`	Fügt die angegebene Zielgruppe als Bearbeiter des geschützten Bereichs hinzu.
`canDomainEdit()`	`Boolean`	Legt fest, ob alle Nutzer in der Domain, zu der die Tabelle gehört, zum Bearbeiten berechtigt sind den geschützten Bereich oder das geschützte Tabellenblatt.
`canEdit()`	`Boolean`	Legt fest, ob der Nutzer berechtigt ist, den geschützten Bereich oder das geschützte Tabellenblatt zu bearbeiten.
`getDescription()`	`String`	Ruft die Beschreibung des geschützten Bereichs oder Tabellenblatts ab.
`getEditors()`	`User[]`	Ruft die Liste der Bearbeiter für den geschützten Bereich oder das geschützte Tabellenblatt ab.
`getProtectionType()`	`ProtectionType`	Ruft den Typ des geschützten Gebiets ab, entweder `RANGE` oder `SHEET`.
`getRange()`	`Range`	Ruft den Bereich ab, der geschützt wird.
`getRangeName()`	`String`	Ruft den Namen des geschützten Bereichs ab, wenn er einem benannten Bereich zugeordnet ist
`getTargetAudiences()`	`TargetAudience[]`	Gibt die IDs der Zielgruppen zurück, die den geschützten Bereich bearbeiten können
`getUnprotectedRanges()`	`Range[]`	Ruft ein Array ungeschützter Bereiche in einem geschützten Tabellenblatt ab.
`isWarningOnly()`	`Boolean`	Legt fest, ob für das Schutzgebiet „warnungsbasiert“ verwendet wird zu schützen.
`remove()`	`void`	Hebt den Schutz des Bereichs oder Tabellenblatts auf.
`removeEditor(emailAddress)`	`Protection`	Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich.
`removeEditor(user)`	`Protection`	Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich.
`removeEditors(emailAddresses)`	`Protection`	Entfernt das angegebene Nutzerarray aus der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich.
`removeTargetAudience(audienceId)`	`Protection`	Entfernt die angegebene Zielgruppe als Bearbeiter des geschützten Bereichs.
`setDescription(description)`	`Protection`	Legt die Beschreibung des geschützten Bereichs oder Tabellenblatts fest.
`setDomainEdit(editable)`	`Protection`	Legt fest, ob alle Nutzer in der Domain, zu der die Tabelle gehört, zum Bearbeiten des geschützten Bereich oder geschütztes Tabellenblatt.
`setNamedRange(namedRange)`	`Protection`	Verknüpft den geschützten Bereich mit einem vorhandenen benannten Bereich.
`setRange(range)`	`Protection`	Passt den Bereich an, der geschützt wird.
`setRangeName(rangeName)`	`Protection`	Verknüpft den geschützten Bereich mit einem vorhandenen benannten Bereich.
`setUnprotectedRanges(ranges)`	`Protection`	Hebt den Schutz des angegebenen Bereichs in einem geschützten Tabellenblatt auf
`setWarningOnly(warningOnly)`	`Protection`	Legt fest, ob für diesen geschützten Bereich „warnungsbasiert“ verwendet wird zu schützen.

Detaillierte Dokumentation

`addEditor(emailAddress)`

Fügt den angegebenen Nutzer zur Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu. Diese Methode Sie erteilen dem Nutzer nicht automatisch die Berechtigung, die Tabelle selbst zu bearbeiten. das in einer Rufen Sie Spreadsheet.addEditor(emailAddress) auf.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds an editor to the spreadsheet using an email address.
// TODO(developer): Replace the email address with a valid email.
ss.addEditor('cloudysanfrancisco@gmail.com');

// Gets a sheet by its name and protects it.
const sheet = ss.getSheetByName('Sheet1');
const sampleProtectedSheet = sheet.protect();

// Adds an editor of the protected sheet using an email address.
// TODO(developer): Replace the email address with a valid email.
sampleProtectedSheet.addEditor('cloudysanfrancisco@gmail.com');

// Gets the editors of the protected sheet.
const editors = sampleProtectedSheet.getEditors();

// Logs the editors' email addresses to the console.
for (const editor of editors) {
  console.log(editor.getEmail());
}

Parameter

Name	Typ	Beschreibung
`emailAddress`	`String`	Die E-Mail-Adresse des hinzuzufügenden Nutzers.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditor(user)`

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Adds the active user as an editor of the protected sheet.
sampleProtectedSheet.addEditor(Session.getActiveUser());

// Gets the editors of the protected sheet.
const editors = sampleProtectedSheet.getEditors();

// Logs the editors' email addresses to the console.
for (const editor of editors) {
  console.log(editor.getEmail());
}

Parameter

Name	Typ	Beschreibung
`user`	`User`	Darstellung des hinzuzufügenden Nutzers.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditors(emailAddresses)`

Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu. Dieses -Methode gibt den Nutzenden nicht automatisch die Berechtigung, die Tabelle selbst zu bearbeiten. Aufgaben auch Spreadsheet.addEditors(emailAddresses) aufrufen.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Creates variables for the email addresses to add as editors.
// TODO(developer): Replace the email addresses with valid ones.
const TEST_EMAIL_1 = 'cloudysanfrancisco@gmail.com';
const TEST_EMAIL_2 = 'baklavainthebalkans@gmail.com';

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Adds editors to the protected sheet using the email address variables.
sampleProtectedSheet.addEditors([TEST_EMAIL_1, TEST_EMAIL_2]);

// Gets the editors of the protected sheet.
const editors = sampleProtectedSheet.getEditors();

// Logs the editors' email addresses to the console.
for (const editor of editors) {
  console.log(editor.getEmail());
}

Parameter

Name	Typ	Beschreibung
`emailAddresses`	`String[]`	Ein Array mit E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addTargetAudience(audienceId)`

Fügt die angegebene Zielgruppe als Bearbeiter des geschützten Bereichs hinzu.

Parameter

Name	Typ	Beschreibung
`audienceId`	`String`	Die ID der hinzuzufügenden Zielgruppe.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`canDomainEdit()`

Legt fest, ob alle Nutzer in der Domain, zu der die Tabelle gehört, zum Bearbeiten berechtigt sind den geschützten Bereich oder das geschützte Tabellenblatt. Löst eine Ausnahme aus, wenn der Nutzer keine Bearbeitungsberechtigung hat den geschützten Bereich oder das geschützte Tabellenblatt.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Logs whether domain users have permission to edit the protected sheet to the console.
console.log(sampleProtectedSheet.canDomainEdit());

Rückflug

Boolean: true, wenn alle Nutzer in der Domain, zu der die Tabelle gehört, diese Berechtigung haben Geschützten Bereich oder geschütztes Tabellenblatt bearbeiten false, wenn dies nicht der Fall ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`canEdit()`

Legt fest, ob der Nutzer berechtigt ist, den geschützten Bereich oder das geschützte Tabellenblatt zu bearbeiten. Die Der Eigentümer einer Tabelle kann jederzeit geschützte Bereiche und Tabellenblätter bearbeiten.

// Remove all range protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

Rückflug

Boolean: true, wenn der Nutzer berechtigt ist, den geschützten Bereich oder das geschützte Tabellenblatt zu bearbeiten false wenn nicht

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDescription()`

Ruft die Beschreibung des geschützten Bereichs oder Tabellenblatts ab. Wenn keine Beschreibung festgelegt ist, gibt einen leeren String zurück.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet and sets the description.
const sampleProtectedSheet = sheet.protect().setDescription('Sample sheet is protected');

// Gets the description of the protected sheet and logs it to the console.
const sampleProtectedSheetDescription = sampleProtectedSheet.getDescription();
console.log(sampleProtectedSheetDescription);

Rückflug

String: Beschreibung des geschützten Bereichs oder Tabellenblatts oder ein leerer String, wenn keine Beschreibung vorhanden ist festgelegt ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getEditors()`

Ruft die Liste der Bearbeiter für den geschützten Bereich oder das geschützte Tabellenblatt ab. Löst eine Ausnahme aus, wenn der Nutzer nicht berechtigt sind, den geschützten Bereich oder das geschützte Tabellenblatt zu bearbeiten.

// Protect the active sheet, then remove all other users from the list of editors.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.protect().setDescription('Sample protected sheet');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Rückflug

User[]: Array von Nutzern, die berechtigt sind, den geschützten Bereich oder das geschützte Tabellenblatt zu bearbeiten

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getProtectionType()`

Ruft den Typ des geschützten Gebiets ab, entweder RANGE oder SHEET.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Gets the type of the protected area.
const protectionType = sampleProtectedSheet.getProtectionType();

// Logs 'SHEET'to the console since the type of the protected area is a sheet.
console.log(protectionType.toString());

Rückflug

ProtectionType: Die Art des Schutzgebiets, entweder RANGE oder SHEET.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRange()`

Ruft den Bereich ab, der geschützt wird. Wenn der Schutz für das Tabellenblatt statt für ein Bereich enthält, gibt diese Methode einen Bereich zurück, der das gesamte Tabellenblatt umfasst.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range 'A1:B10' of Sheet1.
const range = sheet.getRange('A1:B10');

// Makes cells A1:B10 a protected range.
const sampleProtectedRange = range.protect();

// Gets the protected ranges on the sheet.
const protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE);

// Logs the A1 notation of the first protected range on the sheet.
console.log(protections[0].getRange().getA1Notation());

Rückflug

Range: Der Bereich, der geschützt wird.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRangeName()`

Ruft den Namen des geschützten Bereichs ab, wenn er einem benannten Bereich zugeordnet ist Gibt null zurück, wenn der Schutz nicht mit einem benannten Bereich verknüpft ist. Skripts müssen explizit setRangeName(rangeName) aufrufen, um einen geschützten Bereich mit einem benannten Bereich zu verknüpfen. Anrufen Range.protect(), um eine Schutzmaßnahme aus einer Range zu erstellen, die benannten Bereich ohne das Aufrufen von setRangeName(rangeName) reicht nicht aus, . Wenn Sie jedoch in der Google Tabellen-Benutzeroberfläche einen geschützten Bereich aus einem benannten Bereich erstellen, automatisch erstellen.

// Protect a named range in a spreadsheet and log the name of the protected range.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect();
ss.setNamedRange('Test', range);       // Create a named range.
protection.setRangeName('Test');       // Associate the protection with the named range.
Logger.log(protection.getRangeName()); // Verify the name of the protected range.

Rückflug

String – Der Name des geschützten benannten Bereichs oder null, wenn der geschützte Bereich nicht die mit einem benannten Bereich verknüpft sind,

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTargetAudiences()`

Gibt die IDs der Zielgruppen zurück, die den geschützten Bereich bearbeiten können

Rückflug

TargetAudience[]: Ein Array der IDs der Zielgruppen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getUnprotectedRanges()`

Ruft ein Array ungeschützter Bereiche in einem geschützten Tabellenblatt ab. Wenn das Protection-Objekt einem geschützten Bereich statt einem geschützten Tabellenblatt entspricht, gibt diese Methode ein leeres Array. Zum Ändern der nicht geschützten Bereiche verwenden Sie setUnprotectedRanges(ranges), um einen ein neues Bereichs-Array; Um das gesamte Tabellenblatt erneut zu schützen, legen Sie ein leeres Array fest.

// Unprotect cells E2:F5 in addition to any other unprotected ranges in the protected sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.protect();
var unprotected = protection.getUnprotectedRanges();
unprotected.push(sheet.getRange('E2:F5'));
protection.setUnprotectedRanges(unprotected);

Rückflug

Range[]: ein Array von ungeschützten Bereichen in einem geschützten Tabellenblatt

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isWarningOnly()`

Legt fest, ob für das Schutzgebiet „warnungsbasiert“ verwendet wird zu schützen. Warnungsbasierter Schutz Jeder Nutzer kann Daten in diesem Bereich bearbeiten. Beim Bearbeiten wird jedoch eine Warnung um die Änderung zu bestätigen. Standardmäßig werden bei geschützten Bereichen oder Tabellenblättern keine Warnungen angezeigt. Bis in den Warnstatus ändern, verwenden Sie setWarningOnly(warningOnly).

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit')

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Sets the warning status for the protected sheet as true.
sampleProtectedSheet.setWarningOnly(true);

const protectedSheetWarningStatus = sampleProtectedSheet.isWarningOnly();

// Logs the warning status of the protected sheet to the console.
console.log(protectedSheetWarningStatus);

Rückflug

Boolean: true, wenn der geschützte Bereich oder das geschützte Tabellenblatt nur warnungsbasiert geschützt ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`remove()`

Hebt den Schutz des Bereichs oder Tabellenblatts auf.

// Remove all range protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Remove sheet protection from the active sheet, if the user has permission to edit it.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0];
if (protection && protection.canEdit()) {
  protection.remove();
}

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeEditor(emailAddress)`

Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich. Wenn Der Nutzer ist Mitglied einer Google-Gruppe mit Bearbeitungsberechtigung oder wenn alle Nutzer in der Domain Bearbeitungsberechtigung hat, kann der Nutzer das geschützte Gebiet weiterhin bearbeiten. Weder der Inhaber oder der aktuelle Nutzer entfernt werden.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Creates a variable for an email address.
// TODO(developer): Replace the email address with a valid one.
const TEST_EMAIL = 'baklavainthebalkans@gmail.com';

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Adds an editor to the protected sheet using the email address variable.
sampleProtectedSheet.addEditor(TEST_EMAIL);

// Removes the editor from the protected sheet using the email address variable.
sampleProtectedSheet.removeEditor(TEST_EMAIL);

// Gets the editors of the protected sheet.
const editors = sampleProtectedSheet.getEditors();

// Logs the editors' email addresses to the console.
for (const editor of editors) {
  console.log(editor.getEmail());
}

Parameter

Name	Typ	Beschreibung
`emailAddress`	`String`	Die E-Mail-Adresse des zu entfernenden Nutzers.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeEditor(user)`

Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich. Wenn Der Nutzer ist Mitglied einer Google-Gruppe mit Bearbeitungsberechtigung oder wenn alle Nutzer in der Domain Bearbeitungsberechtigung hat, kann der Nutzer auch den geschützten Bereich bearbeiten. Weder die oder der aktuelle Nutzer entfernt werden.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Removes the active user from the editors of the protected sheet.
sampleProtectedSheet.removeEditor(Session.getActiveUser());

// Gets the editors of the protected sheet.
const editors = sampleProtectedSheet.getEditors();

// Logs the editors' email addresses to the console.
for (const editor of editors) {
  console.log(editor.getEmail());
}

Parameter

Name	Typ	Beschreibung
`user`	`User`	Eine Darstellung des zu entfernenden Nutzers.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeEditors(emailAddresses)`

Entfernt das angegebene Nutzerarray aus der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich. Wenn einer der Nutzer Mitglied einer Google-Gruppe ist, die über die Bearbeitungsberechtigung verfügt, oder wenn alle Nutzer in der Domain eine Bearbeitungsberechtigung haben, können diese Nutzer weiterhin die geschützten Bereich. Weder der Eigentümer der Tabelle noch der aktuelle Nutzer kann entfernt werden.

// Protect the active sheet, then remove all other users from the list of editors.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.protect().setDescription('Sample protected sheet');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Parameter

Name	Typ	Beschreibung
`emailAddresses`	`String[]`	Ein Array mit E-Mail-Adressen der Nutzer, die entfernt werden sollen.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeTargetAudience(audienceId)`

Entfernt die angegebene Zielgruppe als Bearbeiter des geschützten Bereichs.

Parameter

Name	Typ	Beschreibung
`audienceId`	`String`	Die ID der zu entfernenden Zielgruppe.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setDescription(description)`

Legt die Beschreibung des geschützten Bereichs oder Tabellenblatts fest.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the sheet 'Sheet1' by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Sets the sheet description to 'Sheet1 is protected.'
sampleProtectedSheet.setDescription('Sheet1 is protected');

// Gets the description of the protected sheet.
const sampleProtectedSheetDescription = sampleProtectedSheet.getDescription();

// Logs the description of the protected sheet to the console.
console.log(sampleProtectedSheetDescription);

Parameter

Name	Typ	Beschreibung
`description`	`String`	Die Beschreibung des geschützten Bereichs oder Tabellenblatts.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setDomainEdit(editable)`

Legt fest, ob alle Nutzer in der Domain, zu der die Tabelle gehört, zum Bearbeiten des geschützten Bereich oder geschütztes Tabellenblatt. Beachten Sie, dass alle Nutzer mit ausdrücklicher Bearbeitungsberechtigung Folgendes können: den geschützten Bereich unabhängig von dieser Einstellung bearbeiten zu können. Löst eine Ausnahme aus, wenn die Tabelle Folgendes enthält: nicht zu einer Google Workspace-Domain gehören (d. h., sie gehört zu einem gmail.com-Konto).

Parameter

Name	Typ	Beschreibung
`editable`	`Boolean`	`true`, wenn alle Nutzer in der Domain, zu der die Tabelle gehört, Folgendes haben sollen: Berechtigung zum Bearbeiten des geschützten Bereichs oder Tabellenblatts `false`, wenn nicht.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setNamedRange(namedRange)`

Verknüpft den geschützten Bereich mit einem vorhandenen benannten Bereich. Wenn der benannte Bereich Bereich befindet, wird die Schutzmaßnahme mit dieser Methode so verschoben, dass sie den gesamten in den benannten Bereich. Der benannte Bereich muss sich auf demselben Tabellenblatt wie der aktuell geschützte Bereich befinden Bereich. Beachten Sie, dass Skripts diese Methode explizit aufrufen müssen, um einen geschützten Bereich mit einem benannten Bereich; Range.protect() wird aufgerufen, um eine Schutzmaßnahme aus einem Range zu erstellen der ein benannter Bereich ist, ohne setRangeName(rangeName) aufzurufen, um sie zu verknüpfen. Das Erstellen eines geschützten Bereichs aus einem benannten Bereich in der Über die Google Tabellen-Benutzeroberfläche werden sie automatisch verknüpft.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Protects cells A1:D10 on Sheet1.
const sheet = ss.getSheetByName('Sheet1');
const protectedRange = sheet.getRange('A1:D10').protect();

// Logs the current protected range, A1:D10.
console.log(protectedRange.getRange().getA1Notation());

// Creates a named range for cells E1:J10 called 'NewRange.'
const newRange = sheet.getRange('E1:J10');
ss.setNamedRange('NewRange', newRange);
const namedRange = ss.getNamedRanges()[0];

// Updates the protected range to the named range, 'NewRange.'
// This updates the protected range on Sheet1 from A1:D10 to E1:J10.
protectedRange.setNamedRange(namedRange);

// Logs the updated protected range to the console.
console.log(protectedRange.getRange().getA1Notation());

Parameter

Name	Typ	Beschreibung
`namedRange`	`NamedRange`	Der vorhandene benannte Bereich, der mit dem geschützten Bereich verknüpft werden soll.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRange(range)`

Passt den Bereich an, der geschützt wird. Wenn der angegebene Bereich einen anderen Bereich abdeckt Bereich geschützt ist, wird die Schutzmaßnahme mit dieser Methode auf den neuen Bereich verschoben.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Protects cells A1:D10 on Sheet1 of the spreadsheet.
const sheet = ss.getSheetByName('Sheet1');
const protectedRange = sheet.getRange('A1:D10').protect();

// Logs the original protected range, A1:D10, to the console.
console.log(protectedRange.getRange().getA1Notation());

// Gets the range E1:J10.
const newRange = sheet.getRange('E1:J10');

// Updates the protected range to E1:J10.
protectedRange.setRange(newRange);

// Logs the updated protected range to the console.
console.log(protectedRange.getRange().getA1Notation());

Parameter

Name	Typ	Beschreibung
`range`	`Range`	Der neue Bereich, der vor Änderungen geschützt werden soll.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRangeName(rangeName)`

Verknüpft den geschützten Bereich mit einem vorhandenen benannten Bereich. Wenn der benannte Bereich Bereich befindet, wird die Schutzmaßnahme mit dieser Methode so verschoben, dass sie den gesamten benannten Bereich. Der benannte Bereich muss sich auf demselben Tabellenblatt wie der aktuell geschützte Bereich befinden Bereich. Beachten Sie, dass Skripts diese Methode explizit aufrufen müssen, um einen geschützten Bereich mit einem benannten Bereich; Range.protect() wird aufgerufen, um eine Schutzmaßnahme aus einem Range zu erstellen der ein benannter Bereich ist, ohne setRangeName(rangeName) aufzurufen, um sie zu verknüpfen. Das Erstellen eines geschützten Bereichs aus einem benannten Bereich in der Über die Google Tabellen-Benutzeroberfläche werden sie automatisch verknüpft.

// Protect a named range in a spreadsheet and log the name of the protected range.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect();
ss.setNamedRange('Test', range);       // Create a named range.
protection.setRangeName('Test');       // Associate the protection with the named range.
Logger.log(protection.getRangeName()); // Verify the name of the protected range.

Parameter

Name	Typ	Beschreibung
`rangeName`	`String`	Der Name des benannten Bereichs, der geschützt werden soll.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setUnprotectedRanges(ranges)`

Hebt den Schutz des angegebenen Bereichs in einem geschützten Tabellenblatt auf Löst eine Ausnahme aus, wenn das Das Protection-Objekt entspricht einem geschützten Bereich anstelle eines geschützten Tabellenblatts. Einer der Bereiche befindet sich nicht auf dem geschützten Tabellenblatt. Legen Sie zum Ändern der nicht geschützten Bereiche einen neuen Array von Bereichen Um das gesamte Tabellenblatt erneut zu schützen, legen Sie ein leeres Array fest.

// Protect the active sheet except B2:C5, then remove all other users from the list of editors.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.protect().setDescription('Sample protected sheet');
var unprotected = sheet.getRange('B2:C5');
protection.setUnprotectedRanges([unprotected]);

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Parameter

Name	Typ	Beschreibung
`ranges`	`Range[]`	Das Array der Bereiche, die in einem geschützten Tabellenblatt ungeschützt bleiben sollen.

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWarningOnly(warningOnly)`

Legt fest, ob für diesen geschützten Bereich „warnungsbasiert“ verwendet wird zu schützen. Auf der Grundlage von Warnungen dass jeder Nutzer Daten in diesem Bereich bearbeiten kann, außer dass beim Bearbeiten eine Warnung angezeigt wird. um die Änderung zu bestätigen. Standardmäßig werden geschützte Bereiche oder Tabellenblätter je nach Warnung. Verwenden Sie isWarningOnly(), um den Warnstatus zu prüfen.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the sheet 'Sheet1' by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet and sets the protection to warning-based.
const sampleProtectedSheet = sheet.protect().setWarningOnly(true);

// Logs whether the protected sheet is warning-based to the console.
console.log(sampleProtectedSheet.isWarningOnly());

Parameter

Name	Typ	Beschreibung
`warningOnly`	`Boolean`

Rückflug

Protection: Das Objekt, das die Schutzeinstellungen für die Verkettung darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets