Method: files.modifyLabels

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

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
fileId

string

ID file yang berisi label.

Isi permintaan

Isi permintaan memuat instance ModifyLabelsRequest.

Isi respons

Respons terhadap permintaan files.modifyLabels. 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

Nilai 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 mengetahui informasi selengkapnya, lihat Panduan otorisasi.

ModifyLabelsRequest

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

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

object (LabelModification)

Daftar modifikasi yang akan diterapkan ke label pada file.
kind

string

Nilai ini selalu drive#modifyLabelsRequest.

LabelModification

Perubahan pada label di file. LabelModification 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 modifikasi pada kolom label ini.
removeLabel

boolean

Jika true, label akan dihapus dari file.
kind

string

Nilai ini selalu drive#labelModification.

FieldModification

Perubahan 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

Nilai ini selalu drive#labelFieldModification.
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. Nilai harus berupa alamat email yang valid.
unsetValues

boolean

Membatalkan penetapan nilai untuk kolom ini.