Class DeveloperMetadataFinder

DeveloperMetadataFinder

在电子表格中搜索开发者元数据。如需创建新的开发者元数据查找器，请使用 Range.createDeveloperMetadataFinder()、Sheet.createDeveloperMetadataFinder() 或 Spreadsheet.createDeveloperMetadataFinder()。

方法

方法	返回类型	简介
find()	DeveloperMetadata[]	执行此搜索并返回匹配的元数据。
onIntersectingLocations()	DeveloperMetadataFinder	配置搜索以考虑具有元数据的相交位置。
withId(id)	DeveloperMetadataFinder	将此搜索限制为仅考虑与指定 ID 匹配的元数据。
withKey(key)	DeveloperMetadataFinder	将此搜索限制为仅考虑与指定键匹配的元数据。
withLocationType(locationType)	DeveloperMetadataFinder	将此搜索限制为仅考虑与指定位置类型匹配的元数据。
withValue(value)	DeveloperMetadataFinder	将此搜索限制为仅考虑与指定值匹配的元数据。
withVisibility(visibility)	DeveloperMetadataFinder	将此搜索限制为仅考虑与指定可见性匹配的元数据。

详细文档

find()

执行此搜索并返回匹配的元数据。

返回

DeveloperMetadata[] - 符合搜索条件的开发者元数据。

授权

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

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

---

onIntersectingLocations()

配置搜索以考虑具有元数据的相交位置。此选项仅适用于范围限定的搜索。

返回

DeveloperMetadataFinder - 用于链接的开发者元数据查找器。

---

withId(id)

将此搜索限制为仅考虑与指定 ID 匹配的元数据。

参数

名称	类型	说明
id	Integer	搜索元数据时要匹配的 ID。

返回

DeveloperMetadataFinder - 用于链接的开发者元数据查找器。

---

withKey(key)

将此搜索限制为仅考虑与指定键匹配的元数据。

参数

名称	类型	说明
key	String	搜索元数据时要匹配的键。

返回

DeveloperMetadataFinder - 用于链接的开发者元数据查找器。

---

withLocationType(locationType)

将此搜索限制为仅考虑与指定位置类型匹配的元数据。

参数

名称	类型	说明
locationType	DeveloperMetadataLocationType	搜索元数据时要匹配的位置类型。

返回

DeveloperMetadataFinder - 用于链接的开发者元数据查找器。

---

withValue(value)

将此搜索限制为仅考虑与指定值匹配的元数据。

参数

名称	类型	说明
value	String	搜索元数据时要匹配的值。

返回

DeveloperMetadataFinder - 用于链接的开发者元数据查找器。

---

withVisibility(visibility)

将此搜索限制为仅考虑与指定可见性匹配的元数据。

参数

名称	类型	说明
visibility	DeveloperMetadataVisibility	搜索元数据时要匹配的公开范围。

返回

DeveloperMetadataFinder - 用于链接的开发者元数据查找器。