- 资源:DeveloperMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DeveloperMetadataLocation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DeveloperMetadataLocationType
- DeveloperMetadataVisibility
- 方法
资源:DeveloperMetadata
与电子表格中的位置或对象相关联的开发者元数据。开发者元数据可用于将任意数据与电子表格的各个部分相关联,并且会在数据移动和修改电子表格时,在这些位置保持关联状态。例如,如果开发者元数据与第 5 行相关联,然后又将另一行插入到第 5 行上方,那么原始元数据仍将与其最初关联的行(现在是第 6 行)相关联。如果关联的对象被删除,其元数据也会被删除。
JSON 表示法 |
---|
{ "metadataId": integer, "metadataKey": string, "metadataValue": string, "location": { object ( |
字段 | |
---|---|
metadataId |
用于标识元数据的电子表格范围的唯一 ID。可以在创建元数据时指定 ID,否则系统会随机生成并分配 ID。必须为正值。 |
metadataKey |
元数据键。电子表格中可能会有多个具有相同键的元数据。开发者元数据必须始终指定键。 |
metadataValue |
与元数据的键相关联的数据。 |
location |
与元数据关联的位置。 |
visibility |
元数据的可见性。必须始终为开发者元数据指定可见性。 |
DeveloperMetadataLocation
电子表格中可能与元数据相关联的位置。
JSON 表示法 |
---|
{ "locationType": enum ( |
字段 | |
---|---|
locationType |
此对象代表的位置类型。此字段为只读字段。 |
联合字段 location 。关联元数据的位置。location 只能是下列其中一项: |
|
spreadsheet |
如果元数据与整个电子表格相关联,则为“true”。 |
sheetId |
当元数据与整个工作表相关联时,相应的工作表 ID。 |
dimensionRange |
表示元数据与维度相关联的行或列。指定的 |
DeveloperMetadataLocationType
枚举与开发者元数据相关联的各类位置。
枚举 | |
---|---|
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED |
默认值。 |
ROW |
与整个行维度关联的开发者元数据。 |
COLUMN |
与整个列维度关联的开发者元数据。 |
SHEET |
在整个工作表中关联的开发者元数据。 |
SPREADSHEET |
在整个电子表格中关联的开发者元数据。 |
DeveloperMetadataVisibility
枚举可能的元数据可见性。
枚举 | |
---|---|
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED |
默认值。 |
DOCUMENT |
对文档可见的元数据可通过任何有权访问该文档的开发者项目访问。 |
PROJECT |
项目可见的元数据仅对创建这些元数据的开发者项目可见并由其访问。 |
方法 |
|
---|---|
|
返回具有指定 ID 的开发者元数据。 |
|
返回与指定的 DataFilter 匹配的所有开发者元数据。 |