Method: files.modifyLabels

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

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

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

เนื้อความของคำขอมีอินสแตนซ์ของ ModifyLabelsRequest

เนื้อหาการตอบกลับ

ตอบกลับคําขอ files.modifyLabels ซึ่งจะมีเฉพาะป้ายกํากับที่เพิ่มหรืออัปเดตตามคําขอเท่านั้น

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
ช่อง
modifiedLabels[]

object (Label)

รายการป้ายกํากับที่เพิ่มหรืออัปเดตตามคําขอ
kind

string

นี่เป็นไดรฟ์เสมอ#modifyLabelsResponse

ขอบเขตการให้สิทธิ์

ต้องการขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

ขอบเขตบางอย่างถูกจํากัดและต้องมีการประเมินความปลอดภัยเพื่อให้แอปใช้งานได้ สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์

คําขอป้ายกํากับการแก้ไข

คําขอแก้ไขชุดป้ายกํากับบนไฟล์ คําขอนี้อาจมีการแก้ไขหลายอย่างซึ่งไม่ว่าจะสําเร็จหรือล้มเหลวทั้งหมด

การแสดง JSON 
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
ช่อง
labelModifications[]

object (LabelModification)

รายการการแก้ไขที่จะใช้กับป้ายกํากับในไฟล์
kind

string

นี่เป็น Drive#modifyLabelsRequest เสมอ

การแก้ไขป้ายกํากับ

การแก้ไขป้ายกํากับบนไฟล์ คุณสามารถใช้ LabelModification เพื่อนําป้ายกํากับไปใช้กับไฟล์ อัปเดตป้ายกํากับที่มีอยู่บนไฟล์ หรือนําป้ายกํากับออกจากไฟล์

การแสดง JSON 
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
ช่อง
labelId

string

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

object (FieldModification)

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

boolean

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

string

เป็น Drive#labelModification เสมอ

การแก้ไขฟิลด์

การแก้ไขช่องของป้ายกํากับ

การแสดง 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

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