开发人员元数据在GAS中的实际用例

在GAS（Google Apps Script）中，开发人员元数据（Developer Metadata）提供了一种在电子表格、文档、幻灯片和表单等Google应用中存储自定义信息的方法。以下是一些使用开发人员元数据的实际用例以及相应的代码示例：

1. 标记特定单元格或区域： 可以使用开发人员元数据来标记特定单元格或区域，以便在代码中进行引用。例如，可以使用元数据标记电子表格中的某些单元格，以便在代码中获取它们的值或进行其他操作。

function markCellWithMetadata() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var cell = sheet.getRange("A1");

  var metadata = {
    key: "myKey",
    value: "myValue"
  };

  sheet.addDeveloperMetadata(metadata, cell);
}

2. 创建自定义菜单： 可以使用开发人员元数据来创建自定义菜单，并将其与特定的文档或电子表格相关联。这样，用户就可以通过菜单快速访问自定义功能。

function createCustomMenu() {
  var doc = DocumentApp.getActiveDocument();

  var metadata = {
    key: "menuType",
    value: "customMenu"
  };

  doc.addDeveloperMetadata(metadata);

  var ui = DocumentApp.getUi();
  ui.createMenu('Custom Menu')
    .addItem('Function 1', 'function1')
    .addItem('Function 2', 'function2')
    .addToUi();
}

3. 存储和检索信息： 可以使用开发人员元数据来存储和检索自定义信息。例如，可以在电子表格中存储某个特定单元格的上次修改日期，并在代码中检索该信息进行进一步处理。

function storeLastModified() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var cell = sheet.getRange("A1");

  var metadata = {
    key: "lastModified",
    value: new Date().toLocaleString()
  };

  sheet.addDeveloperMetadata(metadata, cell);
}

function retrieveLastModified() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var cell = sheet.getRange("A1");

  var metadata = sheet.getDeveloperMetadata(cell);

  if (metadata.length > 0) {
    var lastModified = metadata[0].getValue();
    Logger.log(lastModified);
  } else {
    Logger.log("No developer metadata found");
  }
}

以上是几个使用开发人员元数据的实际用例。开发人员可以根据自己的需求和场景，利用这些元数据来存储和检索自定义信息。