Method: files.modifyLabels

修改应用于文件的标签集。如需了解详情，请参阅为文件设置标签字段。

返回已添加或修改的标签的列表。

HTTP 请求

POST https://www.googleapis.com/drive/v3/files/{fileId}/modifyLabels

网址采用 gRPC 转码语法。

路径参数

参数
fileId

string

标签所属文件的 ID。

请求正文

请求正文包含一个 ModifyLabelsRequest 实例。

响应正文

对 files.modifyLabels 请求的响应。此字段仅包含请求添加或更新的标签。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
字段
modifiedLabels[]

object (Label)

相应请求添加或更新的标签的列表。
kind

string

始终为 "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 (LabelModification)
    }
  ],
  "kind": string
}
字段
labelModifications[]

object (LabelModification)

要应用于文件标签的修改列表。
kind

string

始终为 "drive#modifyLabelsRequest"。

LabelModification

对文件标签的修改。LabelModification 可用于向文件应用标签、更新文件上的现有标签或从文件中移除标签。

JSON 表示法 
{
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "labelId": string,
  "removeLabel": boolean,
  "kind": string
}
字段
fieldModifications[]

object (FieldModification)

相应标签的字段修改列表。
labelId

string

要修改的标签的 ID。
removeLabel

boolean

如果为 true，系统会将相应标签从文件中移除。
kind

string

始终为 "drive#labelModification"。

FieldModification

对标签字段的修改。

JSON 表示法 
{
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "fieldId": string,
  "kind": string,
  "unsetValues": boolean
}
字段
setDateValues[]

string

将 date 字段的值替换为这些新值。字符串必须采用 RFC 3339 完整日期格式：YYYY-MM-DD。
setTextValues[]

string

设置 text 字段的值。
setSelectionValues[]

string

将 selection 字段替换为这些新值。
setIntegerValues[]

string (int64 format)

将 integer 字段的值替换为这些新值。
setUserValues[]

string

将 user 字段替换为这些新值。这些值必须是有效的电子邮件地址。
fieldId

string

要修改的字段的 ID。
kind

string

始终为 "drive#labelFieldModification"。
unsetValues

boolean

取消设置相应字段的值。