修改檔案套用的標籤組合。傳回已新增或修改的標籤清單。
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 |
取消設定這個欄位的值。 |