Method: labels.delta

Memperbarui satu Label dengan menerapkan kumpulan permintaan pembaruan yang menghasilkan revisi draf baru. Batch update tidak ada sama sekali: Jika ada permintaan update yang tidak valid, tidak ada perubahan yang akan diterapkan. Hasil revisi draf 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 dijalankan.
requests[]

object (Request)

Daftar pembaruan untuk diterapkan pada Label. Permintaan akan diterapkan sesuai urutan yang ditentukan.
useAdminAccess

boolean

Tetapkan ke true agar kredensial admin pengguna dapat digunakan. 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 jika 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 update. Pemetaan ini memetakan 1:1 dengan pembaruan, meskipun respons untuk beberapa permintaan mungkin kosong.
updatedLabel

object (Label)

Label setelah pembaruan diterapkan. Ini hanya ditetapkan 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 untuk diterapkan pada 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 wajib diisi. kind hanya ada berupa salah satu diantara 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 dan/atau opsi jenis Kolom.
enableField

object (EnableFieldRequest)

Mengaktifkan Kolom.
disableField

object (DisableFieldRequest)

Menonaktifkan Kolom.
deleteField

object (DeleteFieldRequest)

Menghapus Kolom dari label.
createSelectionChoice

object (CreateSelectionChoiceRequest)

Membuat Pilihan di 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. Minimal satu kolom harus ditentukan. label_properties root bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai cara pintas 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. Minimal satu kolom harus ditentukan. properties root 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. Minimal 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)

Memperbarui kolom menjadi Bilangan Bulat.
dateOptions

object (DateOptions)

Perbarui kolom menjadi Tanggal.
selectionOptions

object (SelectionOptions)

Perbarui kolom menjadi Pilihan.
userOptions

object (UserOptions)

Perbarui kolom menjadi Pengguna.

LongTextOptions

Opsi jenis kolom Teks Panjang.

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

integer

Hanya output. Panjang nilai minimum yang valid 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. Minimal satu kolom harus ditentukan. disabledPolicy root bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai cara pintas 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 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. Minimal satu kolom harus ditentukan. properties root 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 memperbarui.
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 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. Minimal satu kolom harus ditentukan. disabledPolicy root bersifat tersirat dan tidak boleh ditentukan. Satu * dapat digunakan sebagai cara pintas untuk memperbarui setiap kolom.
fieldId

string

Wajib. Kolom Pilihan tempat Pilihan dinonaktifkan.
id

string

Wajib. Pilihan untuk menonaktifkan.
disabledPolicy

object (DisabledPolicy)

Wajib. Kebijakan 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 terkait. response hanya ada berupa salah satu diantara berikut:
updateLabel

object (UpdateLabelPropertiesResponse)

Properti dasar Label diperbarui.
createField

object (CreateFieldResponse)

Membuat Kolom baru.
updateField

object (UpdateFieldPropertiesResponse)

Memperbarui properti dasar Kolom.
updateFieldType

object (UpdateFieldTypeResponse)

Perbarui jenis dan/atau opsi 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 telah ditentukan untuk memastikan prioritas yang berdekatan di antara kolom (1-n).

UpdateFieldPropertiesResponse

Respons setelah perubahan pada properti Kolom.

Representasi JSON 
{
  "priority": integer
}
Kolom
priority

integer

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

UpdateFieldTypeResponse

Respons setelah perubahan pada jenis Kolom.

EnableFieldResponse

Respons setelah Aktifkan kolom.

DisableFieldResponse

Respons setelah kolom dinonaktifkan.

DeleteFieldResponse

Respons setelah Hapus kolom.

CreateSelectionChoiceResponse

Respons setelah Pilihan Pilihan dibuat.

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 perubahan pada properti Pilihan Pilihan.

Representasi JSON 
{
  "priority": integer
}
Kolom
priority

integer

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

EnableSelectionChoiceResponse

Respons setelah Pilihan diaktifkan.

DisableSelectionChoiceResponse

Respons setelah Pilihan dinonaktifkan.

DeleteSelectionChoiceResponse

Jawaban setelah Pilihan dihapus.