Method: labels.disable

Tắt nhãn đã xuất bản. Để biết thêm thông tin, hãy xem bài viết Tắt, bật và xoá nhãn.

Việc vô hiệu hoá nhãn sẽ tạo ra một 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 mới bị vô hiệu hoá 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, bạn có thể xoá nhãn bằng biểu tượ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 cập nhật. Bạn phải chỉ định ít nhất một trường. disabledPolicy gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một * duy nhất làm 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 quản trị của người dùng. Máy chủ sẽ xác minh xem người dùng có phải là quản trị viên của nhãn hay không trước khi cho phép truy cập.
writeControl

object (WriteControl)

Cho phép kiểm soát cách thực hiện các yêu cầu ghi. Mặc định là chưa đặt, tức là lượt ghi sau cùng sẽ được chọn.
disabledPolicy

object (DisabledPolicy)

Chính sách bị vô hiệu hoá để sử dụng.
languageCode

string

Mã ngôn ngữ BCP-47 dùng để đánh giá nhãn trường được bản địa hoá. Khi không được chỉ định, các giá trị bằng ngôn ngữ được thiết lập 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.