Method: files.modifyLabels

แก้ไขชุดป้ายกำกับที่ใช้กับไฟล์ แสดงรายการป้ายกำกับที่เพิ่มหรือแก้ไข

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
fileId

string

รหัสของไฟล์ที่มีป้ายกำกับอยู่

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ 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 
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
ช่อง
labelId

string

รหัสของป้ายกำกับที่จะแก้ไข
fieldModifications[]

object (FieldModification)

รายการการแก้ไขช่องของป้ายกำกับนี้
removeLabel

boolean

หากเป็นจริง ระบบจะนำป้ายกำกับออกจากไฟล์
kind

string

ค่านี้จะมีค่าเป็น drive#labelModification เสมอ

FieldModification

การแก้ไขฟิลด์ของป้ายกำกับ

การแสดง JSON 
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
ช่อง
fieldId

string

รหัสของช่องที่จะแก้ไข
kind

string

ค่านี้จะมีค่าเป็น drive#labelFieldModification เสมอ
setDateValues[]

string

แทนที่ค่าของช่อง date ด้วยค่าใหม่เหล่านี้ สตริงต้องอยู่ในรูปแบบวันที่แบบเต็ม RFC 3339: YYYY-MM-DD
setTextValues[]

string

ตั้งค่าของช่อง text
setSelectionValues[]

string

แทนที่ช่อง selection ด้วยค่าใหม่เหล่านี้
setIntegerValues[]

string (int64 format)

แทนที่ค่าของช่อง integer ด้วยค่าใหม่เหล่านี้
setUserValues[]

string

แทนที่ช่อง user ด้วยค่าใหม่เหล่านี้ ค่าต้องเป็นอีเมลที่ถูกต้อง
unsetValues

boolean

ยกเลิกการตั้งค่าค่าสําหรับช่องนี้