Method: labels.disable

Tắt một Nhãn đã xuất bản. Việc tắt một Nhãn sẽ dẫn đến một bản sửa đổi mới đã xuất bản và bị tắt 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, hệ thống sẽ tạo một bản sửa đổi nháp mới bị vô hiệu hoá 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ũ sẽ bị xoá.

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

Yêu cầu HTTP

POST https://drivelabels.googleapis.com/v2/{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ậ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ể sử dụng một * để viết tắt việc cập nhật mọi trường.
useAdminAccess

boolean

Đặt thành true để sử dụng thông tin xác thực quản trị 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à chưa đặt, tức là lượt ghi gần đây nhất sẽ thắng.
disabledPolicy

object (DisabledPolicy)

Chính sách đã tắt để 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ị trong ngôn ngữ được định cấu hình mặc đị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:

  • 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 Hướng dẫn uỷ quyền.