Method: labels.disable

Tắt Nhãn đã xuất bản. Việc tắt Nhãn sẽ khiến bản sửa đổi đã xuất bản mới bị vô hiệu hoá dựa trên bản sửa đổi đã xuất bản hiện tại. Nếu có bản sửa đổi nháp, thì một bản sửa đổi nháp bị vô hiệu hoá mới sẽ được tạo dựa trên bản sửa đổi nháp mới nhất. Các bản sửa đổi nháp cũ hơn sẽ bị xoá.

Sau khi tắt, một nhãn có thể bị xoá bằng labels.delete.

Yêu cầu HTTP

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

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 
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
Trường
updateMask

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. disabledPolicy gốc đã được ngụ ý và không được chỉ định. Bạn có thể dùng một * duy nhất làm cú pháp viết tắt để cập nhật mọi 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.
disabledPolicy

object (DisabledPolicy)

Đã tắt chính sách để sử dụ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.