Method: labels.delta

Memperbarui satu label dengan menerapkan serangkaian permintaan pembaruan yang menghasilkan revisi draf baru. Untuk mengetahui informasi selengkapnya, lihat Memperbarui label.

Update batch bersifat menyeluruh: Jika ada permintaan update yang tidak valid, tidak ada perubahan yang diterapkan. Revisi draf yang dihasilkan harus dipublikasikan sebelum perubahan dapat digunakan dengan item Drive.

Permintaan HTTP

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:delta

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama resource label yang akan diupdate.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "writeControl": {
    object (WriteControl)
  },
  "requests": [
    {
      object (Request)
    }
  ],
  "useAdminAccess": boolean,
  "view": enum (LabelView),
  "languageCode": string
}
Kolom
writeControl

object (WriteControl)

Memberikan kontrol atas cara eksekusi permintaan tulis.
requests[]

object (Request)

Daftar pembaruan yang akan diterapkan ke label. Permintaan akan diterapkan sesuai urutan yang ditentukan.
useAdminAccess

boolean

Setel ke true untuk menggunakan kredensial admin pengguna. Server akan memverifikasi bahwa pengguna adalah admin untuk label sebelum mengizinkan akses.
view

enum (LabelView)

Jika ditentukan, hanya kolom tertentu yang termasuk dalam tampilan yang ditunjukkan yang akan ditampilkan.
languageCode

string

Kode bahasa BCP-47 yang akan digunakan untuk mengevaluasi label kolom yang dilokalkan saat include_label_in_response adalah true.

Isi respons

Respons untuk pembaruan label.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "responses": [
    {
      object (Response)
    }
  ],
  "updatedLabel": {
    object (Label)
  }
}
Kolom
responses[]

object (Response)

Balasan pembaruan. Hal ini dipetakan 1:1 dengan pembaruan, meskipun respons terhadap beberapa permintaan mungkin kosong.
updatedLabel

object (Label)

Label setelah pembaruan diterapkan. Ini hanya disetel jika include_label_in_response adalah true dan tidak ada error.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

Permintaan

Satu jenis pembaruan yang akan diterapkan ke label.

Representasi JSON 
{

  "updateLabel": {
    object (UpdateLabelPropertiesRequest)
  },
  "createField": {
    object (CreateFieldRequest)
  },
  "updateField": {
    object (UpdateFieldPropertiesRequest)
  },
  "updateFieldType": {
    object (UpdateFieldTypeRequest)
  },
  "enableField": {
    object (EnableFieldRequest)
  },
  "disableField": {
    object (DisableFieldRequest)
  },
  "deleteField": {
    object (DeleteFieldRequest)
  },
  "createSelectionChoice": {
    object (CreateSelectionChoiceRequest)
  },
  "updateSelectionChoiceProperties": {
    object (UpdateSelectionChoicePropertiesRequest)
  },
  "enableSelectionChoice": {
    object (EnableSelectionChoiceRequest)
  },
  "disableSelectionChoice": {
    object (DisableSelectionChoiceRequest)
  },
  "deleteSelectionChoice": {
    object (DeleteSelectionChoiceRequest)
  }
}
Kolom
Kolom union kind. Jenis update. Hanya satu kolom yang wajib diisi. kind hanya dapat berupa salah satu dari berikut:
updateLabel

object (UpdateLabelPropertiesRequest)

Memperbarui properti label.
createField

object (CreateFieldRequest)

Membuat kolom.
updateField

object (UpdateFieldPropertiesRequest)

Memperbarui properti dasar kolom.
updateFieldType

object (UpdateFieldTypeRequest)

Perbarui jenis kolom dan/atau opsi jenis.
enableField

object (EnableFieldRequest)

Mengaktifkan kolom.
disableField

object (DisableFieldRequest)

Menonaktifkan kolom.
deleteField

object (DeleteFieldRequest)

Menghapus kolom dari label.
createSelectionChoice

object (CreateSelectionChoiceRequest)

Buat pilihan dalam kolom pilihan.
updateSelectionChoiceProperties

object (UpdateSelectionChoicePropertiesRequest)

Memperbarui properti pilihan dalam kolom pilihan.
enableSelectionChoice

object (EnableSelectionChoiceRequest)

Aktifkan pilihan dalam kolom pilihan.
disableSelectionChoice

object (DisableSelectionChoiceRequest)

Menonaktifkan pilihan dalam kolom pilihan.
deleteSelectionChoice

object (DeleteSelectionChoiceRequest)

Menghapus pilihan dalam kolom pilihan.

UpdateLabelPropertiesRequest

Memperbarui properti dasar label.

Representasi JSON 
{
  "updateMask": string,
  "properties": {
    object (Properties)
  }
}
Kolom
updateMask

string (FieldMask format)

Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. label_properties root tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai singkatan untuk memperbarui setiap kolom.
properties

object (Properties)

Wajib. Properti label yang akan diperbarui.

CreateFieldRequest

Permintaan untuk membuat kolom dalam label.

Representasi JSON 
{
  "field": {
    object (Field)
  }
}
Kolom
field

object (Field)

Wajib. Kolom yang akan dibuat.

UpdateFieldPropertiesRequest

Permintaan untuk memperbarui properti kolom.

Representasi JSON 
{
  "updateMask": string,
  "id": string,
  "properties": {
    object (Properties)
  }
}
Kolom
updateMask

string (FieldMask format)

Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. properties root tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai singkatan untuk memperbarui setiap kolom.
id

string

Wajib. Kolom yang akan diperbarui.
properties

object (Properties)

Wajib. Properti kolom dasar.

UpdateFieldTypeRequest

Permintaan untuk mengubah jenis kolom.

Representasi JSON 
{
  "updateMask": string,
  "id": string,

  "textOptions": {
    object (TextOptions)
  },
  "integerOptions": {
    object (IntegerOptions)
  },
  "dateOptions": {
    object (DateOptions)
  },
  "selectionOptions": {
    object (SelectionOptions)
  },
  "userOptions": {
    object (UserOptions)
  }
}
Kolom
updateMask

string (FieldMask format)

Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. Root type_options tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai singkatan untuk memperbarui setiap kolom.
id

string

Wajib. Kolom yang akan diperbarui.

Kolom union type_options.

type_options hanya dapat berupa salah satu dari hal berikut:
textOptions

object (TextOptions)

Perbarui kolom ke Teks.
integerOptions

object (IntegerOptions)

Perbarui kolom ke Integer.
dateOptions

object (DateOptions)

Perbarui kolom menjadi Tanggal.
selectionOptions

object (SelectionOptions)

Perbarui kolom ke Pilihan.
userOptions

object (UserOptions)

Perbarui kolom ke Pengguna.

EnableFieldRequest

Permintaan untuk mengaktifkan kolom.

Representasi JSON 
{
  "id": string
}
Kolom
id

string

Wajib. ID kolom yang akan diaktifkan.

DisableFieldRequest

Permintaan untuk menonaktifkan kolom.

Representasi JSON 
{
  "updateMask": string,
  "id": string,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
Kolom
updateMask

string (FieldMask format)

Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. disabledPolicy root tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai singkatan untuk memperbarui setiap kolom.
id

string

Wajib. Kunci kolom yang akan dinonaktifkan.
disabledPolicy

object (DisabledPolicy)

Wajib. Kebijakan kolom dinonaktifkan.

DeleteFieldRequest

Permintaan untuk menghapus kolom.

Representasi JSON 
{
  "id": string
}
Kolom
id

string

Wajib. ID kolom yang akan dihapus.

CreateSelectionChoiceRequest

Permintaan untuk membuat pilihan seleksi.

Representasi JSON 
{
  "fieldId": string,
  "choice": {
    object (Choice)
  }
}
Kolom
fieldId

string

Wajib. Kolom pilihan tempat pilihan akan dibuat.
choice

object (Choice)

Wajib. Pilihan yang akan dibuat.

UpdateSelectionChoicePropertiesRequest

Permintaan untuk memperbarui properti pilihan.

Representasi JSON 
{
  "updateMask": string,
  "fieldId": string,
  "id": string,
  "properties": {
    object (Properties)
  }
}
Kolom
updateMask

string (FieldMask format)

Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. properties root tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai singkatan untuk memperbarui setiap kolom.
fieldId

string

Wajib. Kolom pilihan yang akan diperbarui.
id

string

Wajib. Pilihan untuk memperbarui.
properties

object (Properties)

Wajib. Properti pilihan yang akan diperbarui.

EnableSelectionChoiceRequest

Meminta untuk mengaktifkan pilihan.

Representasi JSON 
{
  "fieldId": string,
  "id": string
}
Kolom
fieldId

string

Wajib. Kolom pilihan tempat pilihan akan diaktifkan.
id

string

Wajib. Pilihan untuk mengaktifkan.

DisableSelectionChoiceRequest

Permintaan untuk menonaktifkan pilihan.

Representasi JSON 
{
  "updateMask": string,
  "fieldId": string,
  "id": string,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
Kolom
updateMask

string (FieldMask format)

Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. disabledPolicy root tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai singkatan untuk memperbarui setiap kolom.
fieldId

string

Wajib. Kolom pilihan tempat pilihan akan dinonaktifkan.
id

string

Wajib. Pilihan untuk menonaktifkan.
disabledPolicy

object (DisabledPolicy)

Wajib. Kebijakan yang dinonaktifkan untuk diperbarui.

DeleteSelectionChoiceRequest

Permintaan untuk menghapus pilihan.

Representasi JSON 
{
  "fieldId": string,
  "id": string
}
Kolom
fieldId

string

Wajib. Kolom pilihan yang akan dihapus.
id

string

Wajib. Pilihan untuk menghapus.

Respons

Satu respons dari pembaruan.

Representasi JSON 
{

  "updateLabel": {
    object (UpdateLabelPropertiesResponse)
  },
  "createField": {
    object (CreateFieldResponse)
  },
  "updateField": {
    object (UpdateFieldPropertiesResponse)
  },
  "updateFieldType": {
    object (UpdateFieldTypeResponse)
  },
  "enableField": {
    object (EnableFieldResponse)
  },
  "disableField": {
    object (DisableFieldResponse)
  },
  "deleteField": {
    object (DeleteFieldResponse)
  },
  "createSelectionChoice": {
    object (CreateSelectionChoiceResponse)
  },
  "updateSelectionChoiceProperties": {
    object (UpdateSelectionChoicePropertiesResponse)
  },
  "enableSelectionChoice": {
    object (EnableSelectionChoiceResponse)
  },
  "disableSelectionChoice": {
    object (DisableSelectionChoiceResponse)
  },
  "deleteSelectionChoice": {
    object (DeleteSelectionChoiceResponse)
  }
}
Kolom
Kolom union response. Respons untuk permintaan yang sesuai. response hanya dapat berupa salah satu dari berikut:
updateLabel

object (UpdateLabelPropertiesResponse)

Memperbarui properti dasar label.
createField

object (CreateFieldResponse)

Membuat kolom.
updateField

object (UpdateFieldPropertiesResponse)

Memperbarui properti dasar kolom.
updateFieldType

object (UpdateFieldTypeResponse)

Memperbarui jenis kolom dan/atau opsi jenis.
enableField

object (EnableFieldResponse)

Mengaktifkan kolom.
disableField

object (DisableFieldResponse)

Menonaktifkan kolom.
deleteField

object (DeleteFieldResponse)

Menghapus kolom dari label.
createSelectionChoice

object (CreateSelectionChoiceResponse)

Membuat opsi daftar pilihan untuk ditambahkan ke kolom pilihan.
updateSelectionChoiceProperties

object (UpdateSelectionChoicePropertiesResponse)

Memperbarui pilihan dalam kolom pilihan.
enableSelectionChoice

object (EnableSelectionChoiceResponse)

Mengaktifkan pilihan dalam kolom pilihan.
disableSelectionChoice

object (DisableSelectionChoiceResponse)

Menonaktifkan pilihan dalam kolom pilihan.
deleteSelectionChoice

object (DeleteSelectionChoiceResponse)

Menghapus pilihan dari kolom pilihan.

UpdateLabelPropertiesResponse

Jenis ini tidak memiliki kolom.

Respons setelah pembaruan pada properti label.

CreateFieldResponse

Respons setelah pembuatan kolom.

Representasi JSON 
{
  "id": string,
  "priority": integer
}
Kolom
id

string

Kolom dari kolom yang dibuat. Jika dibiarkan kosong dalam permintaan pembuatan, kunci akan dibuat secara otomatis dan dapat diidentifikasi di sini.
priority

integer

Prioritas kolom yang dibuat. Prioritas dapat berubah dari yang ditentukan untuk memastikan prioritas yang berdekatan antar-kolom (1-n).

UpdateFieldPropertiesResponse

Respons setelah memperbarui properti kolom.

Representasi JSON 
{
  "priority": integer
}
Kolom
priority

integer

Prioritas kolom yang diperbarui. Prioritas dapat berubah dari yang ditentukan untuk memastikan prioritas yang berdekatan antar-kolom (1-n).

UpdateFieldTypeResponse

Jenis ini tidak memiliki kolom.

Respons setelah memperbarui jenis kolom.

EnableFieldResponse

Jenis ini tidak memiliki kolom.

Mengaktifkan kolom respons berikut.

DisableFieldResponse

Jenis ini tidak memiliki kolom.

Respons setelah penonaktifan kolom.

DeleteFieldResponse

Jenis ini tidak memiliki kolom.

Respons setelah penghapusan kolom.

CreateSelectionChoiceResponse

Respons setelah pembuatan pilihan.

Representasi JSON 
{
  "fieldId": string,
  "id": string
}
Kolom
fieldId

string

ID kolom yang dihasilkan server.
id

string

ID pilihan yang dibuat dalam kolom yang dihasilkan server.

UpdateSelectionChoicePropertiesResponse

Respons setelah memperbarui properti pilihan seleksi.

Representasi JSON 
{
  "priority": integer
}
Kolom
priority

integer

Prioritas pilihan yang diperbarui. Prioritas dapat berubah dari yang ditentukan untuk memastikan prioritas yang berurutan di antara pilihan (1-n).

EnableSelectionChoiceResponse

Jenis ini tidak memiliki kolom.

Respons setelah pilihan diaktifkan.

DisableSelectionChoiceResponse

Jenis ini tidak memiliki kolom.

Respons setelah pilihan dinonaktifkan.

DeleteSelectionChoiceResponse

Jenis ini tidak memiliki kolom.

Respons setelah pilihan dihapus.