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 
{
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "labelId": string,
  "removeLabel": boolean,
  "kind": string
}
ช่อง
fieldModifications[]

object (FieldModification)

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

string

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

boolean

หากเป็นจริง ระบบจะนำป้ายกำกับออกจากไฟล์
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

รหัสของฟิลด์ที่จะแก้ไข
kind

string

ซึ่งจะdrive#labelFieldModificationเสมอ
unsetValues

boolean

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