Method: files.modifyLabels

Mengubah kumpulan label yang diterapkan ke file. Untuk mengetahui informasi selengkapnya, lihat Menetapkan kolom label pada 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. 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

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

object (FieldModification)

Daftar modifikasi pada kolom label ini.
labelId

string

ID label yang akan diubah.
removeLabel

boolean

Jika benar, label akan dihapus dari file.
kind

string

Nilai ini selalu "drive#labelModification".

FieldModification

Perubahan pada kolom label.

Representasi JSON 
{
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "fieldId": string,
  "kind": string,
  "unsetValues": boolean
}
Kolom
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.
fieldId

string

ID kolom yang akan diubah.
kind

string

Nilai ini selalu "drive#labelFieldModification".
unsetValues

boolean

Membatalkan setel nilai untuk kolom ini.