- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Minta
- UpdateLabelPropertiesRequest
- CreateFieldRequest
- UpdateFieldPropertiesRequest
- UpdateFieldTypeRequest
- LongTextOptions
- EnableFieldRequest
- DisableFieldRequest
- DeleteFieldRequest
- CreateSelectionChoiceRequest
- UpdateSelectionChoicePropertiesRequest
- EnableSelectionChoiceRequest
- DisableSelectionChoiceRequest
- DeleteSelectionChoiceRequest
- Respons
- UpdateLabelPropertiesResponse
- CreateFieldResponse
- UpdateFieldPropertiesResponse
- UpdateFieldTypeResponse
- EnableFieldResponse
- DisableFieldResponse
- DeleteFieldResponse
- CreateSelectionChoiceResponse
- UpdateSelectionChoicePropertiesResponse
- EnableSelectionChoiceResponse
- DisableSelectionChoiceResponse
- DeleteSelectionChoiceResponse
- Cobalah!
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 |
Wajib diisi. Nama resource Label yang akan diperbarui. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "writeControl": { object ( |
Kolom | |
---|---|
writeControl |
Memberikan kontrol atas cara permintaan tulis dijalankan. |
requests[] |
Daftar pembaruan yang akan diterapkan pada Label. Permintaan akan diterapkan sesuai urutan yang ditentukan. |
useAdminAccess |
Setel ke |
view |
Jika ditentukan, hanya kolom tertentu milik tampilan yang ditunjukkan yang akan ditampilkan. |
languageCode |
Kode bahasa BCP-47 yang akan digunakan untuk mengevaluasi label Kolom yang dilokalkan saat |
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Respons untuk pembaruan Label.
Representasi JSON |
---|
{ "responses": [ { object ( |
Kolom | |
---|---|
responses[] |
Balasan atas pembaruan. Hal ini dipetakan 1:1 dengan pembaruan, meskipun respons untuk beberapa permintaan mungkin kosong. |
updatedLabel |
Label setelah pembaruan diterapkan. Ini hanya disetel jika [BatchUpdateLabelResponse2.include_label_in_response] adalah |
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 |
Kolom | |
---|---|
Kolom union kind . Jenis update. Hanya satu Kolom yang diperlukan. kind hanya dapat berupa salah satu dari berikut: |
|
updateLabel |
Memperbarui properti Label. |
createField |
Membuat Kolom baru. |
updateField |
Memperbarui properti dasar Kolom. |
updateFieldType |
Perbarui opsi jenis dan/atau jenis Kolom. |
enableField |
Mengaktifkan Kolom. |
disableField |
Menonaktifkan Kolom. |
deleteField |
Menghapus Kolom dari label. |
createSelectionChoice |
Membuat Pilihan dalam kolom Pilihan. |
updateSelectionChoiceProperties |
Perbarui properti Pilihan dalam Kolom Pilihan. |
enableSelectionChoice |
Mengaktifkan Pilihan dalam Kolom Pilihan. |
disableSelectionChoice |
Nonaktifkan Pilihan dalam Kolom Pilihan. |
deleteSelectionChoice |
Hapus Pilihan di Kolom Pilihan. |
UpdateLabelPropertiesRequest
Memperbarui properti dasar Label.
Representasi JSON |
---|
{
"updateMask": string,
"properties": {
object ( |
Kolom | |
---|---|
updateMask |
Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. Akar |
properties |
Wajib diisi. Beri label pada properti yang akan diperbarui. |
CreateFieldRequest
Permintaan untuk membuat Kolom dalam Label.
Representasi JSON |
---|
{
"field": {
object ( |
Kolom | |
---|---|
field |
Wajib diisi. Kolom yang akan dibuat. |
UpdateFieldPropertiesRequest
Permintaan untuk memperbarui properti Kolom.
Representasi JSON |
---|
{
"updateMask": string,
"id": string,
"properties": {
object ( |
Kolom | |
---|---|
updateMask |
Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. Akar |
id |
Wajib diisi. Kolom yang akan diperbarui. |
properties |
Wajib diisi. Properti Kolom Dasar. |
UpdateFieldTypeRequest
Permintaan untuk mengubah jenis Kolom.
Representasi JSON |
---|
{ "updateMask": string, "id": string, // Union field |
Kolom | |
---|---|
updateMask |
Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. Akar |
id |
Wajib diisi. Kolom yang akan diperbarui. |
Kolom union
|
|
textOptions |
Perbarui kolom menjadi Teks. |
longTextOptions |
Perbarui kolom menjadi Teks Panjang. |
integerOptions |
Perbarui kolom menjadi Bilangan Bulat. |
dateOptions |
Perbarui kolom menjadi Tanggal. |
selectionOptions |
Perbarui kolom ke Pilihan. |
userOptions |
Perbarui kolom ke Pengguna. |
LongTextOptions
Opsi jenis kolom Teks Panjang.
Representasi JSON |
---|
{ "minLength": integer, "maxLength": integer } |
Kolom | |
---|---|
minLength |
Hanya output. Panjang nilai valid minimum untuk kolom teks. |
maxLength |
Hanya output. Panjang nilai valid maksimum untuk kolom teks. |
EnableFieldRequest
Minta untuk mengaktifkan Kolom.
Representasi JSON |
---|
{ "id": string } |
Kolom | |
---|---|
id |
Wajib diisi. ID Kolom yang akan diaktifkan. |
DisableFieldRequest
Permintaan untuk menonaktifkan Kolom.
Representasi JSON |
---|
{
"updateMask": string,
"id": string,
"disabledPolicy": {
object ( |
Kolom | |
---|---|
updateMask |
Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. Akar |
id |
Wajib diisi. Kunci Kolom yang akan dinonaktifkan. |
disabledPolicy |
Wajib diisi. Kebijakan Kolom Dinonaktifkan. |
DeleteFieldRequest
Permintaan untuk menghapus Kolom.
Representasi JSON |
---|
{ "id": string } |
Kolom | |
---|---|
id |
Wajib diisi. ID Kolom yang akan dihapus. |
CreateSelectionChoiceRequest
Permintaan untuk membuat Pilihan Pilihan.
Representasi JSON |
---|
{
"fieldId": string,
"choice": {
object ( |
Kolom | |
---|---|
fieldId |
Wajib diisi. Kolom Pilihan tempat Pilihan akan dibuat. |
choice |
Wajib diisi. Pilihan untuk berkreasi. |
UpdateSelectionChoicePropertiesRequest
Permintaan untuk memperbarui properti Pilihan.
Representasi JSON |
---|
{
"updateMask": string,
"fieldId": string,
"id": string,
"properties": {
object ( |
Kolom | |
---|---|
updateMask |
Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. Akar |
fieldId |
Wajib diisi. Kolom Pilihan yang akan diperbarui. |
id |
Wajib diisi. Pilihan untuk mengupdate. |
properties |
Wajib diisi. Properti Pilihan yang akan diperbarui. |
EnableSelectionChoiceRequest
Permintaan untuk mengaktifkan Pilihan.
Representasi JSON |
---|
{ "fieldId": string, "id": string } |
Kolom | |
---|---|
fieldId |
Wajib diisi. Kolom Pilihan tempat Pilihan akan diaktifkan. |
id |
Wajib diisi. Pilihan untuk mengaktifkan. |
DisableSelectionChoiceRequest
Permintaan untuk menonaktifkan Pilihan.
Representasi JSON |
---|
{
"updateMask": string,
"fieldId": string,
"id": string,
"disabledPolicy": {
object ( |
Kolom | |
---|---|
updateMask |
Kolom yang harus diperbarui. Setidaknya satu kolom harus ditentukan. Akar |
fieldId |
Wajib diisi. Kolom Pilihan tempat Pilihan akan dinonaktifkan. |
id |
Wajib diisi. Pilihan untuk dinonaktifkan. |
disabledPolicy |
Wajib diisi. Kebijakan yang dinonaktifkan untuk diperbarui. |
DeleteSelectionChoiceRequest
Permintaan untuk menghapus Pilihan.
Representasi JSON |
---|
{ "fieldId": string, "id": string } |
Kolom | |
---|---|
fieldId |
Wajib diisi. Kolom Pilihan tempat Pilihan akan dihapus. |
id |
Wajib diisi. Pilihan untuk dihapus. |
Respons
Satu respons dari update.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union response . Respons untuk permintaan terkait. response hanya dapat berupa salah satu dari berikut: |
|
updateLabel |
Memperbarui properti dasar Label. |
createField |
Membuat Kolom baru. |
updateField |
Memperbarui properti dasar Kolom. |
updateFieldType |
Perbarui opsi jenis dan/atau jenis Kolom. |
enableField |
Mengaktifkan Kolom. |
disableField |
Menonaktifkan Kolom. |
deleteField |
Menghapus Kolom dari label. |
createSelectionChoice |
Membuat opsi daftar pilihan baru untuk ditambahkan ke Kolom Pilihan. |
updateSelectionChoiceProperties |
Memperbarui Pilihan dalam Kolom Pilihan. |
enableSelectionChoice |
Mengaktifkan Pilihan dalam Kolom Pilihan. |
disableSelectionChoice |
Menonaktifkan Pilihan dalam Kolom Pilihan. |
deleteSelectionChoice |
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 |
Kolom kolom yang dibuat. Jika dibiarkan kosong dalam permintaan pembuatan, kunci akan dibuat secara otomatis dan dapat diidentifikasi di sini. |
priority |
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 |
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 |
ID kolom yang dibuat oleh server. |
id |
ID yang dibuat server pilihan yang dibuat dalam Kolom |
UpdateSelectionChoicePropertiesResponse
Respons setelah perubahan pada properti Pilihan Pilihan.
Representasi JSON |
---|
{ "priority": integer } |
Kolom | |
---|---|
priority |
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.