Class Protection

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Schutz

Auf geschützte Bereiche und Tabellenblätter zugreifen und sie ändern Ein geschützter Bereich kann entweder einen statischen Zellenbereich oder einen benannten Bereich schützen. Ein geschütztes Tabellenblatt kann ungeschützte Bereiche enthalten. Verwenden Sie für Tabellen, die mit der älteren Version von Google Tabellen erstellt wurden, stattdessen die Klasse 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

MethodeRückgabetypKurzbeschreibung
addEditor(emailAddress)ProtectionFügt den angegebenen Nutzer der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu.
addEditor(user)ProtectionFügt den angegebenen Nutzer der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu.
addEditors(emailAddresses)ProtectionFügt das angegebene Array von Nutzern der Liste der Mitbearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu.
addTargetAudience(audienceId)ProtectionDie angegebene Zielgruppe wird als Bearbeiter des geschützten Bereichs hinzugefügt.
canDomainEdit()BooleanLegt fest, ob alle Nutzer in der Domain, zu der die Tabelle gehört, die Berechtigung zum Bearbeiten des geschützten Bereichs oder des geschützten Tabellenblatts haben.
canEdit()BooleanLegt fest, ob der Nutzer berechtigt ist, den geschützten Bereich oder das geschützte Tabellenblatt zu bearbeiten.
getDescription()StringRuft die Beschreibung des geschützten Bereichs oder Tabellenblatts ab.
getEditors()User[]Ruft die Liste der Mitbearbeiter für den geschützten Bereich oder das geschützte Tabellenblatt ab.
getProtectionType()ProtectionTypeRuft den Typ des geschützten Bereichs ab, entweder RANGE oder SHEET.
getRange()RangeRuft den Bereich ab, der geschützt wird.
getRangeName()StringRuft den Namen des geschützten Bereichs ab, wenn er mit einem benannten Bereich verknüpft 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()BooleanLegt fest, ob im geschützten Bereich der schutzbasierte Schutz verwendet wird.
remove()voidSchutz des Bereichs oder Tabellenblatts wird aufgehoben.
removeEditor(emailAddress)ProtectionDer Nutzer wird aus der Liste der Mitbearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich entfernt.
removeEditor(user)ProtectionDer Nutzer wird aus der Liste der Mitbearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich entfernt.
removeEditors(emailAddresses)ProtectionDas angegebene Array von Nutzern wird aus der Liste der Mitbearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich entfernt.
removeTargetAudience(audienceId)ProtectionDie angegebene Zielgruppe wird als Bearbeiter des geschützten Bereichs entfernt.
setDescription(description)ProtectionLegt die Beschreibung des geschützten Bereichs oder Tabellenblatts fest.
setDomainEdit(editable)ProtectionLegt fest, ob alle Nutzer in der Domain, zu der die Tabelle gehört, die Berechtigung zum Bearbeiten des geschützten Bereichs oder des geschützten Tabellenblatts haben.
setNamedRange(namedRange)ProtectionOrdnet den geschützten Bereich einem vorhandenen benannten Bereich zu.
setRange(range)ProtectionPasst den Bereich an, der geschützt wird.
setRangeName(rangeName)ProtectionOrdnet den geschützten Bereich einem vorhandenen benannten Bereich zu.
setUnprotectedRanges(ranges)ProtectionHebt den Schutz des angegebenen Arrays von Bereichen in einem geschützten Tabellenblatt auf
setWarningOnly(warningOnly)ProtectionMit dieser Einstellung legen Sie fest, ob für diesen geschützten Bereich der Schutz auf Warnungen verwendet werden soll.

Detaillierte Dokumentation

addEditor(emailAddress)

Fügt den angegebenen Nutzer der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu. Mit dieser Methode erhält der Nutzer nicht automatisch die Berechtigung zum Bearbeiten der Tabelle selbst. Rufen Sie dazu Spreadsheet.addEditor(emailAddress) auf.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der hinzugefügt werden soll.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

addEditor(user)

Fügt den angegebenen Nutzer der Liste der Bearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu. Mit dieser Methode erhält der Nutzer nicht automatisch die Berechtigung zum Bearbeiten der Tabelle selbst. Rufen Sie dazu Spreadsheet.addEditor(user) auf.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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 Mitbearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich hinzu. Mit dieser Methode erhält der Nutzer nicht automatisch die Berechtigung zum Bearbeiten der Tabelle selbst. Rufen Sie außerdem zusätzlich Spreadsheet.addEditors(emailAddresses) auf.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

addTargetAudience(audienceId)

Die angegebene Zielgruppe wird als Bearbeiter des geschützten Bereichs hinzugefügt.

Parameter

NameTypBeschreibung
audienceIdStringDie ID der Zielgruppe, die hinzugefügt werden soll.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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, die Berechtigung zum Bearbeiten des geschützten Bereichs oder des geschützten Tabellenblatts haben. Löst eine Ausnahme aus, wenn der Nutzer keine Berechtigung zum Bearbeiten des geschützten Bereichs oder des geschützten Tabellenblatts hat.

Zurücksenden

Boolean: true, wenn alle Nutzer in der Domain, der die Tabelle gehört, die Berechtigung zum Bearbeiten des geschützten Bereichs oder des geschützten Tabellenblatts haben. false, wenn nicht.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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. Der Eigentümer der Tabelle kann geschützte Bereiche und Tabellenblätter jederzeit 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();
  }
}

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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 diese Methode einen leeren String zurück.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getEditors()

Ruft die Liste der Mitbearbeiter für den geschützten Bereich oder das geschützte Tabellenblatt ab. Löst eine Ausnahme aus, wenn der Nutzer keine Berechtigung zum Bearbeiten des geschützten Bereichs oder des Tabellenblatts hat.

// 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);
}

Zurücksenden

User[]: ein Array von Nutzern mit der Berechtigung zum Bearbeiten des geschützten Bereichs oder des geschützten Tabellenblatts

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getProtectionType()

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

Zurücksenden

ProtectionType: Typ des geschützten Bereichs, entweder RANGE oder SHEET

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getRange()

Ruft den Bereich ab, der geschützt wird. Wenn die Schutzmaßnahme auf das Tabellenblatt und nicht auf einen Bereich angewendet wird, gibt diese Methode einen Bereich zurück, der das gesamte Tabellenblatt umfasst.

Zurücksenden

Range: der Bereich, der geschützt wird

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getRangeName()

Ruft den Namen des geschützten Bereichs ab, wenn er mit einem benannten Bereich verknüpft ist. Gibt null zurück, wenn die Schutzmaßnahme nicht mit einem benannten Bereich verknüpft ist. In Skripts muss setRangeName(rangeName) explizit aufgerufen werden, um einen geschützten Bereich mit einem benannten Bereich zu verknüpfen. Ein Aufruf von Range.protect() zum Erstellen einer Schutzmaßnahme aus einem Range, der ein benannter Bereich ohne setRangeName(rangeName) ist, reicht nicht aus, um die Bereiche zu verknüpfen. Wenn Sie jedoch in der Google Tabellen-UI einen geschützten Bereich aus einem benannten Bereich erstellen, werden diese 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.

Zurücksenden

String: Name des geschützten benannten Bereichs oder null, wenn der geschützte Bereich nicht mit einem benannten Bereich verknüpft ist

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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.

Zurücksenden

TargetAudience[]: Ein Array mit den IDs der Zielgruppen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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 Objekt Protection einem geschützten Bereich statt einem geschützten Tabellenblatt entspricht, gibt diese Methode ein leeres Array zurück. Verwenden Sie zum Ändern der ungeschützten Bereiche setUnprotectedRanges(ranges), um ein neues Array von Bereichen festzulegen. Wenn Sie das gesamte Tabellenblatt noch einmal schützen möchten, geben Sie ein leeres Array an.

// 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);

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

isWarningOnly()

Legt fest, ob im geschützten Bereich der schutzbasierte Schutz verwendet wird. Warnungsbasierter Schutz bedeutet, dass jeder Nutzer Daten in diesem Bereich bearbeiten kann. Eine Ausnahme bildet lediglich die Warnung, in der der Nutzer aufgefordert wird, die Änderung zu bestätigen. Standardmäßig sind geschützte Bereiche oder Tabellenblätter nicht warnungenbasiert. Verwenden Sie setWarningOnly(warningOnly), um in den Warnstatus zu wechseln.

Zurücksenden

Boolean: true, wenn für den geschützten Bereich oder das Tabellenblatt nur eine Warnung verwendet wird

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

remove()

Schutz des Bereichs oder Tabellenblatts wird aufgehoben.

// 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

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

removeEditor(emailAddress)

Der Nutzer wird aus der Liste der Mitbearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich entfernt. Hinweis: Wenn der Nutzer Mitglied einer Google-Gruppe mit Bearbeitungsberechtigung ist oder alle Nutzer in der Domain eine Bearbeitungsberechtigung haben, kann der Nutzer den geschützten Bereich weiterhin bearbeiten. Weder der Eigentümer der Tabelle noch der aktuelle Nutzer kann entfernt werden.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der entfernt werden soll.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

removeEditor(user)

Der Nutzer wird aus der Liste der Mitbearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich entfernt. Hinweis: Wenn der Nutzer Mitglied einer Google-Gruppe mit Bearbeitungsberechtigung ist oder alle Nutzer in der Domain eine Bearbeitungsberechtigung haben, kann der Nutzer den geschützten Bereich ebenfalls bearbeiten. Weder der Eigentümer der Tabelle noch der aktuelle Nutzer kann entfernt werden.

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

removeEditors(emailAddresses)

Das angegebene Array von Nutzern wird aus der Liste der Mitbearbeiter für das geschützte Tabellenblatt oder den geschützten Bereich entfernt. Hinweis: Wenn ein Nutzer Mitglied einer Google-Gruppe mit Bearbeitungsberechtigung ist oder alle Nutzer in der Domain eine Bearbeitungsberechtigung haben, können diese Nutzer den geschützten Bereich weiterhin bearbeiten. Weder der Eigentümer der Tabelle noch der aktuelle Nutzer können 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

NameTypBeschreibung
emailAddressesString[]Ein Array mit E-Mail-Adressen der Nutzer, die entfernt werden sollen.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

removeTargetAudience(audienceId)

Die angegebene Zielgruppe wird als Bearbeiter des geschützten Bereichs entfernt.

Parameter

NameTypBeschreibung
audienceIdStringDie ID der Zielgruppe, die entfernt werden soll.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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.

Parameter

NameTypBeschreibung
descriptionStringDie Beschreibung des geschützten Bereichs oder Tabellenblatts.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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, die Berechtigung zum Bearbeiten des geschützten Bereichs oder des geschützten Tabellenblatts haben. Beachten Sie, dass alle Nutzer mit ausdrücklicher Bearbeitungsberechtigung den geschützten Bereich unabhängig von dieser Einstellung bearbeiten können. Gibt eine Ausnahme aus, wenn die Tabelle nicht zu einer Google Workspace-Domain gehört (d. h., sie gehört einem Gmail-Konto).

Parameter

NameTypBeschreibung
editableBooleantrue, wenn alle Nutzer in der Domain, zu der die Tabelle gehört, die Berechtigung zum Bearbeiten des geschützten Bereichs oder des Tabellenblatts haben sollen. Andernfalls false.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setNamedRange(namedRange)

Ordnet den geschützten Bereich einem vorhandenen benannten Bereich zu. Wenn der benannte Bereich einen anderen Bereich als den aktuell geschützten Bereich abdeckt, wird mit dieser Methode stattdessen der benannte Bereich abgedeckt. Der benannte Bereich muss sich auf demselben Tabellenblatt befinden wie der aktuell geschützte Bereich. Beachten Sie, dass Skripts diese Methode explizit aufrufen müssen, um einen geschützten Bereich mit einem benannten Bereich zu verknüpfen. Ein Aufruf von Range.protect() zum Erstellen einer Schutzmaßnahme aus einem Range-Bereich, der ein benannter Bereich ist, ohne setRangeName(rangeName) aufzurufen, ist nicht ausreichend. Wenn Sie jedoch in der Google Tabellen-UI einen geschützten Bereich aus einem benannten Bereich erstellen, werden diese automatisch verknüpft.

Parameter

NameTypBeschreibung
namedRangeNamedRangeDer vorhandene benannte Bereich, der mit dem geschützten Bereich verknüpft werden soll.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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 als den aktuell geschützten Bereich abdeckt, wird mit dieser Methode stattdessen der neue Bereich abgedeckt.

Parameter

NameTypBeschreibung
rangeRangeDer neue Bereich, der vor Änderungen geschützt werden soll.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setRangeName(rangeName)

Ordnet den geschützten Bereich einem vorhandenen benannten Bereich zu. Wenn der benannte Bereich einen anderen Bereich als den aktuell geschützten Bereich abdeckt, wird mit dieser Methode stattdessen der benannte Bereich abgedeckt. Der benannte Bereich muss sich auf demselben Tabellenblatt befinden wie der aktuell geschützte Bereich. Beachten Sie, dass Skripts diese Methode explizit aufrufen müssen, um einen geschützten Bereich mit einem benannten Bereich zu verknüpfen. Ein Aufruf von Range.protect() zum Erstellen einer Schutzmaßnahme aus einem Range-Bereich, der ein benannter Bereich ist, ohne setRangeName(rangeName) aufzurufen, ist nicht ausreichend. Wenn Sie jedoch in der Google Tabellen-UI einen geschützten Bereich aus einem benannten Bereich erstellen, werden diese 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

NameTypBeschreibung
rangeNameStringDer Name des zu schützenden benannten Bereichs.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setUnprotectedRanges(ranges)

Hebt den Schutz des angegebenen Arrays von Bereichen in einem geschützten Tabellenblatt auf Löst eine Ausnahme aus, wenn das Objekt Protection einem geschützten Bereich anstelle eines geschützten Tabellenblatts entspricht oder wenn sich einer der Bereiche nicht auf dem geschützten Tabellenblatt befindet. Wenn Sie die ungeschützten Bereiche ändern möchten, legen Sie ein neues Array von Bereichen fest. Um die gesamte Tabelle noch einmal 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

NameTypBeschreibung
rangesRange[]Das Array der Bereiche, die in einem geschützten Tabellenblatt ungeschützt bleiben sollen.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setWarningOnly(warningOnly)

Mit dieser Einstellung legen Sie fest, ob für diesen geschützten Bereich der Schutz auf Warnungen verwendet werden soll. Warnungsbasiert bedeutet, dass jeder Nutzer Daten in dem Bereich bearbeiten kann, mit Ausnahme der Bearbeitung, bei der der Nutzer aufgefordert wird, die Änderung zu bestätigen. Standardmäßig sind geschützte Bereiche oder Tabellenblätter nicht warnungsbasiert. Mit isWarningOnly() können Sie den Warnstatus prüfen.

Parameter

NameTypBeschreibung
warningOnlyBoolean

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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