Method: files.modifyLabels

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

คำขอ HTTP

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

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

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

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

string

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

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

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

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

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

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

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

object (Label)

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

string

มักจะเป็น drive#modifyLabelResponse เสมอ

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

ต้องมีขอบเขต 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#modifyLabelRequest เสมอ

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

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