Method: labels.delta

Memperbarui satu Label dengan menerapkan sekumpulan permintaan pembaruan yang menghasilkan revisi draf baru. Update batch bersifat menyeluruh atau tidak ada sama sekali: Jika ada permintaan update yang tidak valid, tidak ada perubahan yang diterapkan. Hasil draf revisi 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 diisi. Nama resource Label yang akan diperbarui.

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 permintaan tulis dijalankan.

requests[]

object (Request)

Daftar pembaruan yang akan diterapkan pada 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 milik 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

Jika berhasil, isi respons memuat data dengan struktur berikut:

Respons untuk pembaruan Label.

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

object (Response)

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

updatedLabel

object (Label)

Label setelah pembaruan diterapkan. Ini hanya disetel jika [BatchUpdateLabelResponse2.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 informasi selengkapnya, lihat Panduan otorisasi.

Permintaan

Satu jenis update untuk diterapkan ke Label.

Representasi JSON
{

  // Union field kind can be only one of the following:
  "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)
  }
  // End of list of possible types for union field kind.
}
Kolom
Kolom union kind. Jenis update. Hanya satu Kolom yang diperlukan. kind hanya dapat berupa salah satu dari berikut:
updateLabel

object (UpdateLabelPropertiesRequest)

Memperbarui properti Label.

createField

object (CreateFieldRequest)

Membuat Kolom baru.

updateField

object (UpdateFieldPropertiesRequest)

Memperbarui properti dasar Kolom.

updateFieldType

object (UpdateFieldTypeRequest)

Perbarui opsi jenis dan/atau jenis Kolom.

enableField

object (EnableFieldRequest)

Mengaktifkan Kolom.

disableField

object (DisableFieldRequest)

Menonaktifkan Kolom.

deleteField

object (DeleteFieldRequest)

Menghapus Kolom dari label.

createSelectionChoice

object (CreateSelectionChoiceRequest)

Membuat Pilihan dalam kolom Pilihan.

updateSelectionChoiceProperties

object (UpdateSelectionChoicePropertiesRequest)

Perbarui properti Pilihan dalam Kolom Pilihan.

enableSelectionChoice

object (EnableSelectionChoiceRequest)

Mengaktifkan Pilihan dalam Kolom Pilihan.

disableSelectionChoice

object (DisableSelectionChoiceRequest)

Nonaktifkan Pilihan dalam Kolom Pilihan.

deleteSelectionChoice

object (DeleteSelectionChoiceRequest)

Hapus Pilihan di 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. Akar label_properties bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai pintasan untuk memperbarui setiap kolom.

properties

object (Properties)

Wajib diisi. Beri label pada properti yang akan diperbarui.

CreateFieldRequest

Permintaan untuk membuat Kolom dalam Label.

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

object (Field)

Wajib diisi. 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. Akar properties bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai pintasan untuk memperbarui setiap kolom.

id

string

Wajib diisi. Kolom yang akan diperbarui.

properties

object (Properties)

Wajib diisi. Properti Kolom Dasar.

UpdateFieldTypeRequest

Permintaan untuk mengubah jenis Kolom.

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

  // Union field type_options can be only one of the following:
  "textOptions": {
    object (TextOptions)
  },
  "longTextOptions": {
    object (LongTextOptions)
  },
  "integerOptions": {
    object (IntegerOptions)
  },
  "dateOptions": {
    object (DateOptions)
  },
  "selectionOptions": {
    object (SelectionOptions)
  },
  "userOptions": {
    object (UserOptions)
  }
  // End of list of possible types for union field type_options.
}
Kolom
updateMask

string (FieldMask format)

Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. Akar type_options bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai pintasan untuk memperbarui setiap kolom.

id

string

Wajib diisi. Kolom yang akan diperbarui.

Kolom union type_options.

type_options hanya dapat berupa salah satu dari yang berikut:

textOptions

object (TextOptions)

Perbarui kolom menjadi Teks.

longTextOptions

object (LongTextOptions)

Perbarui kolom menjadi Teks Panjang.

integerOptions

object (IntegerOptions)

Perbarui kolom menjadi Bilangan Bulat.

dateOptions

object (DateOptions)

Perbarui kolom menjadi Tanggal.

selectionOptions

object (SelectionOptions)

Perbarui kolom ke Pilihan.

userOptions

object (UserOptions)

Perbarui kolom ke Pengguna.

LongTextOptions

Opsi jenis kolom Teks Panjang.

Representasi JSON
{
  "minLength": integer,
  "maxLength": integer
}
Kolom
minLength

integer

Hanya output. Panjang nilai valid minimum untuk kolom teks.

maxLength

integer

Hanya output. Panjang nilai valid maksimum untuk kolom teks.

EnableFieldRequest

Minta untuk mengaktifkan Kolom.

Representasi JSON
{
  "id": string
}
Kolom
id

string

Wajib diisi. 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. Akar disabledPolicy bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai pintasan untuk memperbarui setiap kolom.

id

string

Wajib diisi. Kunci Kolom yang akan dinonaktifkan.

disabledPolicy

object (DisabledPolicy)

Wajib diisi. Kebijakan Kolom Dinonaktifkan.

DeleteFieldRequest

Permintaan untuk menghapus Kolom.

Representasi JSON
{
  "id": string
}
Kolom
id

string

Wajib diisi. ID Kolom yang akan dihapus.

CreateSelectionChoiceRequest

Permintaan untuk membuat Pilihan Pilihan.

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

string

Wajib diisi. Kolom Pilihan tempat Pilihan akan dibuat.

choice

object (Choice)

Wajib diisi. Pilihan untuk berkreasi.

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. Akar properties bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai pintasan untuk memperbarui setiap kolom.

fieldId

string

Wajib diisi. Kolom Pilihan yang akan diperbarui.

id

string

Wajib diisi. Pilihan untuk mengupdate.

properties

object (Properties)

Wajib diisi. Properti Pilihan yang akan diperbarui.

EnableSelectionChoiceRequest

Permintaan untuk mengaktifkan Pilihan.

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

string

Wajib diisi. Kolom Pilihan tempat Pilihan akan diaktifkan.

id

string

Wajib diisi. 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. Akar disabledPolicy bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai pintasan untuk memperbarui setiap kolom.

fieldId

string

Wajib diisi. Kolom Pilihan tempat Pilihan akan dinonaktifkan.

id

string

Wajib diisi. Pilihan untuk dinonaktifkan.

disabledPolicy

object (DisabledPolicy)

Wajib diisi. Kebijakan yang dinonaktifkan untuk diperbarui.

DeleteSelectionChoiceRequest

Permintaan untuk menghapus Pilihan.

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

string

Wajib diisi. Kolom Pilihan tempat Pilihan akan dihapus.

id

string

Wajib diisi. Pilihan untuk dihapus.

Respons

Satu respons dari update.

Representasi JSON
{

  // Union field response can be only one of the following:
  "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)
  }
  // End of list of possible types for union field response.
}
Kolom
Kolom union response. Respons untuk permintaan terkait. response hanya dapat berupa salah satu dari berikut:
updateLabel

object (UpdateLabelPropertiesResponse)

Memperbarui properti dasar Label.

createField

object (CreateFieldResponse)

Membuat Kolom baru.

updateField

object (UpdateFieldPropertiesResponse)

Memperbarui properti dasar Kolom.

updateFieldType

object (UpdateFieldTypeResponse)

Perbarui opsi jenis dan/atau jenis Kolom.

enableField

object (EnableFieldResponse)

Mengaktifkan Kolom.

disableField

object (DisableFieldResponse)

Menonaktifkan Kolom.

deleteField

object (DeleteFieldResponse)

Menghapus Kolom dari label.

createSelectionChoice

object (CreateSelectionChoiceResponse)

Membuat opsi daftar pilihan baru 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

Respons setelah perubahan pada properti Label.

CreateFieldResponse

Respons setelah Kolom dibuat.

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

string

Kolom 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 di antara kolom (1-n).

UpdateFieldPropertiesResponse

Respons setelah perubahan terhadap properti Kolom.

Representasi JSON
{
  "priority": integer
}
Kolom
priority

integer

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

UpdateFieldTypeResponse

Respons setelah pembaruan terhadap Jenis kolom.

EnableFieldResponse

Respons setelah Kolom diaktifkan.

DisableFieldResponse

Respons setelah Kolom dinonaktifkan.

DeleteFieldResponse

Respons setelah Kolom dihapus.

CreateSelectionChoiceResponse

Respons setelah membuat Pilihan Pilihan.

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

string

ID kolom yang dibuat oleh server.

id

string

ID yang dibuat server pilihan yang dibuat dalam Kolom

UpdateSelectionChoicePropertiesResponse

Respons setelah perubahan pada properti Pilihan Pilihan.

Representasi JSON
{
  "priority": integer
}
Kolom
priority

integer

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

EnableSelectionChoiceResponse

Respons setelah Pilihan diaktifkan.

DisableSelectionChoiceResponse

Respons setelah Opsi dinonaktifkan.

DeleteSelectionChoiceResponse

Tanggapan setelah opsi Pilihan dihapus.