如何查看google sheet/ranges保护状态？

Question

我用@OMila 编写了一个代码来帮助限制某些用户的某些范围，同时保护 sheet 中的整个剩余范围免受他们的编辑。我想检查 [=15] 的保护状态=] 每个 for 循环迭代，如果它受保护 ==> 迭代 ++（检查下一个 sheet），如果不受保护，运行脚本和保护范围。目的是，当某些人制作新的 sheets 时，我希望脚本通过触发器自动运行，但是当 sheets 的数量增加时，每次传播的执行时间都会增加sheet 并且可能会达到 google 引用限制，因此我需要通过放置一个 if 条件来检查 sheet 保护状态并按照前面所述执行脚本来优化执行脚本的方式。这是代码：

  function Sheet_Ranges_Protection() {
  var Veranda_Test = SpreadsheetApp.openById("Sheet ID");
  var Veranda_Sheets = Veranda_Test.getSheets();

  for(var SheetNumb = 0; SheetNumb < Veranda_Sheets.length; SheetNumb++) {

    var me = Session.getEffectiveUser();

    // Define ranges that will be protected for everyone
    var range1 = Veranda_Sheets[SheetNumb].getRange(6, 1, 
    Veranda_Sheets[SheetNumb].getMaxRows(), 
    Veranda_Sheets[SheetNumb].getMaxColumns());
    var range2 = Veranda_Sheets[SheetNumb].getRange(1, 8, 5, 
    Veranda_Sheets[SheetNumb].getMaxColumns());
    var range3 = Veranda_Sheets[SheetNumb].getRange(1, 4, 5);
    var ranges = [range1, range2, range3];

    // Set protection for all the sheet minus QC/PLN ranges
    for(var i = 0; i < ranges.length; i++) {
      var rangeProtection = ranges[i].protect().setDescription('Range protection');
      rangeProtection.addEditor(me);
      rangeProtection.removeEditors(rangeProtection.getEditors());
      if (rangeProtection.canDomainEdit()) {
        rangeProtection.setDomainEdit(false);
      }
    }

    var QC_Range         = Veranda_Sheets[SheetNumb].getRange("E1:G5");
    var PLN_Range        = Veranda_Sheets[SheetNumb].getRange("A1:C5");

    // Set protection for QC range
    var QC_protection = QC_Range.protect().setDescription('QC protection');
    QC_protection.removeEditors(QC_protection.getEditors());
    QC_protection.addEditor('Editor1@gmail.com');
    if (QC_protection.canDomainEdit()) {
      QC_protection.setDomainEdit(false);
    }

    // Set protection for PLN range
    var PLN_protection = PLN_Range.protect().setDescription('PLN protection');
    PLN_protection.removeEditors(PLN_protection.getEditors());
    PLN_protection.addEditor('Editor2@gmail.com');
    if (PLN_protection.canDomainEdit()) {
      PLN_protection.setDomainEdit(false);
    }    
    }
    }

Answer 1

您可以使用 getProtections() 功能在创建新保护之前检查已经存在的保护类型。

由于您专门使用范围创建保护，因此您可以使用 getProtections(SpreadsheetApp.ProtectionType.RANGE) 仅获取脚本创建的保护（所有这些都是范围，而不是工作表范围的保护）。

您可以假设，如果您创建了第一个保护，那么您就创建了所有这些保护。所以代码看起来像这样：

var protections = Veranda_Sheets[SheetNumb].getProtections(SpreadsheetApp.ProtectionType.RANGE);
if (protections.length==0) {
   //add protections here
}

如果这不是一个安全的假设，您可以验证缺少哪些保护，并在以后像这样创建它们：

var protections = Veranda_Sheets[SheetNumb].getProtections(SpreadsheetApp.ProtectionType.RANGE);
var protectionNames = [];
for (var i=0; i<protections.length; i++) {
    protectionNames.push(protections[i].getDescription());
}

if (!protectionNames.includes('<name of protection i am about to create>') {
    //create protection '<name of protection i am about to create>'
} //else skip;

希望对您有所帮助！

如何查看google sheet/ranges保护状态？

How to check on google sheet/ranges protection status?

if-statement

protection

google-sheets

google-apps-script