Method: labels.delta

Memperbarui satu Label dengan menerapkan serangkaian permintaan pembaruan yang menghasilkan revisi draf baru. Pembaruan batch bersifat menyeluruh: Jika ada permintaan pembaruan 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 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 dieksekusi.
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 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 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 pembaruan yang akan 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 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)

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)

Menonaktifkan 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. label_properties root tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai cara pintas untuk memperbarui setiap kolom.
properties

object (Properties)

Wajib. Beri label pada properti 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. Akar properties bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai cara pintas 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,

  // 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 cara pintas untuk memperbarui setiap kolom.
id

string

Wajib. 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 ke Integer.
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 maksimum yang valid untuk kolom teks.

EnableFieldRequest

Minta 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. Akar disabledPolicy bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai pintasan 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 Pilihan.

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

string

Wajib. Kolom Pilihan yang akan diperbarui.
id

string

Wajib. Pilihan untuk mengupdate.
properties

object (Properties)

Wajib. Properti Pilihan yang akan diperbarui.

EnableSelectionChoiceRequest

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

string

Wajib. Kolom Pilihan tempat Pilihan akan dinonaktifkan.
id

string

Wajib. Pilihan untuk dinonaktifkan.
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 tempat Pilihan akan dihapus.
id

string

Wajib. Pilihan untuk menghapus.

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 yang sesuai. 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 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 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

Jenis ini tidak memiliki kolom.

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 pembaruan pada 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

Jenis ini tidak memiliki kolom.

Respons setelah pembaruan terhadap Jenis kolom.

EnableFieldResponse

Jenis ini tidak memiliki kolom.

Respons setelah Kolom diaktifkan.

DisableFieldResponse

Jenis ini tidak memiliki kolom.

Respons setelah Penonaktifan kolom.

DeleteFieldResponse

Jenis ini tidak memiliki kolom.

Respons setelah Kolom dihapus.

CreateSelectionChoiceResponse

Respons setelah pembuatan Pilihan Seleksi.

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

string

ID kolom yang dibuat server.
id

string

ID yang dibuat server dari pilihan yang dibuat dalam Kolom

UpdateSelectionChoicePropertiesResponse

Respons setelah pembaruan pada properti Pilihan Pemilihan.

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 Choice diaktifkan.

DisableSelectionChoiceResponse

Jenis ini tidak memiliki kolom.

Respons setelah Penonaktifan Pilihan.

DeleteSelectionChoiceResponse

Jenis ini tidak memiliki kolom.

Tanggapan setelah opsi Pilihan dihapus.