Method: files.modifyLabels

Memodifikasi kumpulan label yang diterapkan ke file. Menampilkan daftar label yang ditambahkan atau diubah.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
fileId

string

ID file yang memiliki label.

Isi permintaan

Isi permintaan memuat instance ModifyLabelsRequest.

Isi respons

Respons terhadap permintaan files.modifyLabels. Salinan ini hanya berisi label yang ditambahkan atau diperbarui oleh permintaan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
Kolom
modifiedLabels[]

object (Label)

Daftar label yang ditambahkan atau diperbarui oleh permintaan.

kind

string

Ini selalu drive#ModifyLabelsResponse

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Beberapa cakupan dibatasi dan memerlukan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk informasi selengkapnya, lihat Panduan otorisasi.

ModifyLabelsRequest

Permintaan untuk mengubah kumpulan label pada file. Permintaan ini mungkin berisi berbagai modifikasi yang akan berhasil atau semuanya akan gagal secara atomik.

Representasi JSON
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
Kolom
labelModifications[]

object (LabelModification)

Daftar perubahan yang akan diterapkan pada label pada file.

kind

string

Ini selalu drive#modifyLabelsRequest.

LabelModification

Modifikasi label pada file. LabelModifikasi dapat digunakan untuk menerapkan label ke file, memperbarui label yang ada pada file, atau menghapus label dari file.

Representasi JSON
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
Kolom
labelId

string

ID label yang akan diubah.

fieldModifications[]

object (FieldModification)

Daftar perubahan pada kolom label ini.

removeLabel

boolean

Jika true (benar), label akan dihapus dari file.

kind

string

Ini selalu drive#labelModified.

FieldModification

Modifikasi pada kolom label.

Representasi JSON
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
Kolom
fieldId

string

ID kolom yang akan diubah.

kind

string

Ini selalu adalah drive#labelFieldModified.

setDateValues[]

string

Mengganti nilai kolom date dengan nilai baru ini. String harus dalam format tanggal lengkap RFC 3339: YYYY-MM-DD.

setTextValues[]

string

Menetapkan nilai kolom text.

setSelectionValues[]

string

Mengganti kolom selection dengan nilai baru ini.

setIntegerValues[]

string (int64 format)

Mengganti nilai kolom integer dengan nilai baru ini.

setUserValues[]

string

Mengganti kolom user dengan nilai baru ini. Nilainya harus berupa alamat email yang valid.

unsetValues

boolean

Batalkan penetapan nilai untuk kolom ini.