Method: files.modifyLabels

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

คำขอ HTTP

POST https://www.googleapis.com/drive/v3/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: ปปปป-ดด-วว
setTextValues[]

string

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

string

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

string (int64 format)

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

string

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

boolean

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