Class DeveloperMetadata

DeveloperMetadata

访问和修改开发者元数据。如需创建新的开发者元数据,请使用 Range.addDeveloperMetadata(key)Sheet.addDeveloperMetadata(key)Spreadsheet.addDeveloperMetadata(key)

方法

方法返回类型简介
getId()Integer返回与此开发者元数据关联的唯一 ID。
getKey()String返回与此开发者元数据关联的键。
getLocation()DeveloperMetadataLocation返回此开发者元数据的位置。
getValue()String返回与此开发者元数据关联的值,如果此元数据没有值,则返回 null
getVisibility()DeveloperMetadataVisibility返回此开发者元数据的可见性。
moveToColumn(column)DeveloperMetadata将此开发者元数据移至指定列。
moveToRow(row)DeveloperMetadata将此开发者元数据移至指定行。
moveToSheet(sheet)DeveloperMetadata将此开发者元数据移至指定的工作表。
moveToSpreadsheet()DeveloperMetadata将此开发者元数据移至顶层电子表格。
remove()void删除此元数据。
setKey(key)DeveloperMetadata将此开发者元数据的键设置为指定值。
setValue(value)DeveloperMetadata将与此开发者元数据关联的值设置为指定值。
setVisibility(visibility)DeveloperMetadata将此开发者元数据的可见性设为指定的可见性。

详细文档

getId()

返回与此开发者元数据关联的唯一 ID。

弃踢回攻

Integer - 与此开发者元数据关联的唯一 ID。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

getKey()

返回与此开发者元数据关联的键。

弃踢回攻

String - 与此开发者元数据关联的键。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

getLocation()

返回此开发者元数据的位置。

弃踢回攻

DeveloperMetadataLocation - 此开发者元数据的位置。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

getValue()

返回与此开发者元数据关联的值,如果此元数据没有值,则返回 null

弃踢回攻

String - 与此开发者元数据关联的值,如果此元数据没有值,则返回 null

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

getVisibility()

返回此开发者元数据的可见性。

弃踢回攻

DeveloperMetadataVisibility - 此开发者元数据的公开范围。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

moveToColumn(column)

将此开发者元数据移至指定列。如果指定的范围不代表单个列,则会抛出异常。

参数

名称类型说明
columnRange表示此开发者元数据新位置的列的范围。

弃踢回攻

DeveloperMetadata - 开发者元数据,用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

moveToRow(row)

将此开发者元数据移至指定行。如果指定的范围不代表单个行,则会抛出异常。

参数

名称类型说明
rowRange代表此开发者元数据新位置的行的范围。

弃踢回攻

DeveloperMetadata - 开发者元数据,用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

moveToSheet(sheet)

将此开发者元数据移至指定的工作表。

参数

名称类型说明
sheetSheet作为此开发者元数据的新位置的工作表。

弃踢回攻

DeveloperMetadata - 开发者元数据,用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

moveToSpreadsheet()

将此开发者元数据移至顶层电子表格。

弃踢回攻

DeveloperMetadata - 开发者元数据,用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

remove()

删除此元数据。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

setKey(key)

将此开发者元数据的键设置为指定值。

参数

名称类型说明
keyString要为此元数据设置的新键。

弃踢回攻

DeveloperMetadata - 开发者元数据,用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

setValue(value)

将与此开发者元数据关联的值设置为指定值。

参数

名称类型说明
valueString要为此元数据设置的新值。

弃踢回攻

DeveloperMetadata - 开发者元数据,用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

setVisibility(visibility)

将此开发者元数据的可见性设为指定的可见性。

参数

名称类型说明
visibilityDeveloperMetadataVisibility要为此元数据设置的新公开范围。

弃踢回攻

DeveloperMetadata - 开发者元数据,用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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