Method: labels.publish

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

Memublikasikan Label akan menghasilkan revisi baru yang dipublikasikan. Semua revisi draf 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, perubahan apa pun yang akan membatalkan atau menyebabkan pembatasan baru pada metadata yang ada yang terkait dengan Label akan ditolak. Misalnya, perubahan pada Label berikut akan ditolak setelah Label dipublikasikan: * Label tidak dapat langsung dihapus. Kebijakan 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 jumlah entri maksimum.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Beri label nama resource.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

boolean

Tetapkan ke true agar kredensial admin pengguna dapat digunakan. Server akan memverifikasi bahwa pengguna adalah admin untuk Label sebelum mengizinkan akses.
writeControl

object (WriteControl)

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

string

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

Isi respons

Jika berhasil, isi respons akan berisi 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.