Method: labels.publish

Phát hành tất cả các thay đổi nháp cho Nhãn. Sau khi xuất bản, Nhãn có thể không trở về trạng thái bản nháp. Vui lòng xem google.apps.drive.labels.v2.Lifecycle để biết thêm thông tin.

Việc xuất bản Nhãn sẽ dẫn đến một bản sửa đổi mới được xuất bản. Tất cả bản sửa đổi nháp trước đó sẽ bị xoá. Các bản sửa đổi đã xuất bản trước đó sẽ được giữ lại nhưng sẽ bị xoá tự động khi cần.

Sau khi xuất bản, một số thay đổi sẽ không được cho phép nữa. Nhìn chung, mọi thay đổi làm mất hiệu lực hoặc gây ra các hạn chế mới đối với siêu dữ liệu hiện có liên quan đến Nhãn đều sẽ bị từ chối. Ví dụ: các thay đổi sau đây đối với một Nhãn sẽ bị từ chối sau khi xuất bản Nhãn: * Không thể xoá trực tiếp nhãn. Bạn phải tắt tính năng này trước rồi mới xoá. * Không thể thay đổi Trường.FieldType. * Thay đổi đối với tùy chọn Xác thực trường không thể từ chối nội dung nào đó đã được chấp nhận trước đó. * Giảm số lượng mục nhập tối đa.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
name

string

Bắt buộc. Tên tài nguyên nhãn.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "languageCode": string
}
Trường
useAdminAccess

boolean

Đặt thành true để sử dụng thông tin đăng nhập của quản trị viên của người dùng. Máy chủ sẽ xác minh người dùng là quản trị viên của Nhãn trước khi cho phép truy cập.

writeControl

object (WriteControl)

Cung cấp quyền kiểm soát cách thực thi các yêu cầu ghi. Giá trị mặc định là không đặt, nghĩa là lượt ghi sau cùng sẽ thắng.

languageCode

string

Mã ngôn ngữ BCP-47 dùng để đánh giá nhãn trường đã bản địa hoá. Khi không được chỉ định, các giá trị bằng ngôn ngữ mặc định đã định cấu hình sẽ được sử dụng.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Label.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

Để biết thêm thông tin, hãy xem bài viết Hướng dẫn uỷ quyền.