Method: labels.publish

Publikasikan semua perubahan draf ke Label. Setelah dipublikasikan, Label tidak dapat kembali ke status draf. Lihat google.apps.drive.labels.v2.Lifecycle untuk mengetahui informasi selengkapnya.

Memublikasikan Label akan menghasilkan revisi baru yang dipublikasikan. Semua draf revisi sebelumnya akan dihapus. Revisi yang dipublikasikan sebelumnya akan disimpan, tetapi tunduk pada penghapusan otomatis sesuai kebutuhan.

Setelah dipublikasikan, beberapa perubahan tidak lagi diizinkan. Secara umum, setiap perubahan yang akan membatalkan atau menyebabkan pembatasan baru pada metadata yang ada terkait Label akan ditolak. Misalnya, perubahan pada Label berikut akan ditolak setelah Label dipublikasikan: * Label tidak dapat langsung dihapus. Setelan ini harus dinonaktifkan terlebih dahulu, lalu dihapus. * Field.FieldType tidak dapat diubah. * Perubahan pada opsi Validasi kolom tidak dapat menolak sesuatu yang sebelumnya diterima. * Mengurangi entri maksimum.

Permintaan HTTP

POST https://drivelabels.googleapis.com/v2beta/{name=labels/*}:publish

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib diisi. Nama resource label.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "languageCode": string
}
Kolom
useAdminAccess

boolean

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

object (WriteControl)

Memberikan kontrol atas cara permintaan tulis dijalankan. Setelan defaultnya adalah tidak ditetapkan, yang berarti penulisan terakhir akan menang.
languageCode

string

Kode bahasa BCP-47 yang akan digunakan untuk mengevaluasi label kolom lokal. Jika tidak ditentukan, nilai dalam bahasa default yang dikonfigurasi akan digunakan.

Isi respons

Jika berhasil, isi respons memuat instance Label.

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.