修改应用于文件的标签集。返回已添加或修改的标签的列表。
HTTP 请求
POST https://www.googleapis.com/drive/v3/files/{fileId}/modifyLabels
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
fileId |
标签所属文件的 ID。 |
请求正文
请求正文包含一个 ModifyLabelsRequest
实例。
响应正文
响应 files.modifyLabels 请求。仅包含由请求添加或更新的标签。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"modifiedLabels": [
{
object ( |
字段 | |
---|---|
modifiedLabels[] |
根据请求添加或更新的标签的列表。 |
kind |
始终为 drive#modifyLabelsResponse |
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
某些范围受到限制,您的应用必须接受安全评估才能使用这些范围。有关详情,请参阅授权指南。
ModifyLabelsRequest
修改文件标签集的请求。此请求可能包含多项修改,这些修改要么全部成功,要么全部以原子方式失败。
JSON 表示法 |
---|
{
"labelModifications": [
{
object ( |
字段 | |
---|---|
labelModifications[] |
要应用于文件标签的修改列表。 |
kind |
始终为 drive#modifyLabelsRequest。 |
LabelModification
对文件的标签进行的修改。LabelModification 可用于将标签应用于文件、更新文件的现有标签或从文件中移除标签。
JSON 表示法 |
---|
{
"labelId": string,
"fieldModifications": [
{
object ( |
字段 | |
---|---|
labelId |
要修改的标签的 ID。 |
fieldModifications[] |
对此标签字段的修改列表。 |
removeLabel |
如果为 true,标签将从文件中移除。 |
kind |
始终为 drive#labelModification。 |
FieldModification
对标签字段的修改。
JSON 表示法 |
---|
{ "fieldId": string, "kind": string, "setDateValues": [ string ], "setTextValues": [ string ], "setSelectionValues": [ string ], "setIntegerValues": [ string ], "setUserValues": [ string ], "unsetValues": boolean } |
字段 | |
---|---|
fieldId |
要修改的字段的 ID。 |
kind |
始终为 drive#labelFieldModification。 |
setDateValues[] |
用这些新值替换 |
setTextValues[] |
设置 |
setSelectionValues[] |
用这些新值替换 |
setIntegerValues[] |
用这些新值替换 |
setUserValues[] |
用这些新值替换 |
unsetValues |
取消设置此字段的值。 |