Tắt, bật và xoá nhãn

Tài liệu này mô tả cách thực hiện các tác vụ liên quan đến nhãn sau đây:

  • Tắt nhãn
  • Bật nhãn
  • Xoá nhãn

Tắt 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ũ sẽ bị xoá. Để biết thêm thông tin, hãy xem phần Vòng đời của nhãn.

Sau khi bị vô hiệu hoá, người dùng vẫn có thể áp dụng nhãn này thông qua Google Drive Labels API. Nhãn này vẫn xuất hiện ở những nơi đã áp dụng và trong kết quả tìm kiếm. Bạn có thể xoá nhãn bị vô hiệu hoá.

Để tắt một nhãn đã xuất bản, hãy sử dụng phương thức disable trên tài nguyên labels.

Bạn cũng phải chỉ định:

  • Một tài nguyên labels đại diện cho nhãn. Nó chứa một name và một id. Đây là giá trị nhận dạng duy nhất trên toàn cầu cho nhãn.

  • Tham số truy vấn useAdminAccess được đặt thành true để sử dụng thông tin đăng nhập quản trị viên của người dùng. Trước khi cấp quyền truy cập, máy chủ sẽ xác minh để đảm bảo rằng người dùng có đặc quyền quản trị Quản lý nhãn phân loại bắt buộc.

Mã mẫu sau đây cho biết cách sử dụng id của nhãn để tắt nhãn chính xác:

Python

service.labels().disable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

Node.js

service.labels.disable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Thay thế ID bằng mã nhận dạng của nhãn cần tắt.

Nhãn có State của DISABLED và mã nhận dạng phiên bản của nhãn sẽ tăng lên. Người dùng có thể áp dụng nhãn thông qua Drive Labels API. Tuy nhiên, nhãn bị vô hiệu hoá sẽ không xuất hiện trong giao diện người dùng, trừ phi bạn định cấu hình trường showInApply của đối tượng DisabledPolicy.

Bật nhãn

Khi bạn bật một nhãn đã tắt, nhãn đó sẽ được khôi phục về trạng thái đã xuất bản. Thao tác này sẽ tạo ra một bản sửa đổi đã xuất bản mới dựa trên bản sửa đổi đã xuất bản hiện tại bị vô hiệu hoá. Nếu có một bản sửa đổi nháp hiện có bị vô hiệu hoá, thì một bản sửa đổi mới sẽ được tạo dựa trên bản nháp đó và được bật. Để biết thêm thông tin, hãy xem phần Vòng đời của nhãn.

Để bật một nhãn đã tắt, hãy sử dụng phương thức enable trên tài nguyên labels.

Bạn cũng phải chỉ định:

  • Một tài nguyên labels đại diện cho nhãn. Nó chứa một name và một id. Đây là giá trị nhận dạng duy nhất trên toàn cầu cho nhãn.

  • Tham số truy vấn useAdminAccess được đặt thành true để sử dụng thông tin đăng nhập quản trị viên của người dùng. Trước khi cấp quyền truy cập, máy chủ sẽ xác minh để đảm bảo rằng người dùng có đặc quyền quản trị Quản lý nhãn phân loại bắt buộc.

Mã mẫu sau đây cho biết cách sử dụng id của nhãn để bật nhãn chính xác:

Python

service.labels().enable(
    name='labels/ID',
    body={
        'useAdminAccess': True
    }
).execute()

Node.js

service.labels.enable({
  name: 'labels/ID',
  requestBody: {
    useAdminAccess: true
  }
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Thay thế ID bằng mã nhận dạng của nhãn cần bật.

Nhãn có State của PUBLISHED và mã nhận dạng phiên bản của nhãn sẽ tăng lên. Người dùng có thể xem và áp dụng nhãn cho tệp thông qua Drive Labels API.

Xoá nhãn

Bạn chỉ có thể xoá nhãn ở trạng thái bản nháp và nhãn bị vô hiệu hoá. Khi một nhãn bị xoá, tất cả các trường hợp mà nhãn đó đã được áp dụng trước đây (bao gồm cả mọi giá trị trường tương ứng do người dùng nhập) sẽ bị xoá vĩnh viễn và bị loại bỏ khỏi các tệp đó trên Drive.

Để xoá một nhãn, trước tiên bạn phải tắt nhãn đó rồi sử dụng phương thức delete trên tài nguyên labels.

Bạn cũng phải chỉ định:

  • Một tài nguyên labels đại diện cho nhãn. Nó chứa một name và một id. Đây là giá trị nhận dạng duy nhất trên toàn cầu cho nhãn.

  • Tham số truy vấn useAdminAccess được đặt thành true để sử dụng thông tin đăng nhập quản trị viên của người dùng. Trước khi cấp quyền truy cập, máy chủ sẽ xác minh để đảm bảo rằng người dùng có đặc quyền quản trị Quản lý nhãn phân loại bắt buộc.

Mã mẫu sau đây cho biết cách dùng id của nhãn để xoá nhãn chính xác:

Python

response = service.labels().delete(
    name='labels/ID',
    useAdminAccess=True
).execute()

Node.js

service.labels.delete({
  name: 'labels/ID',
  useAdminAccess: true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Thay thế ID bằng mã nhận dạng của nhãn cần xoá.

Nhãn có State của DELETED và mã nhận dạng phiên bản của nhãn sẽ tăng lên. Không thể áp dụng nhãn và các nhãn đã xoá sẽ bị xoá vĩnh viễn. Để biết thêm thông tin, hãy xem phần Vòng đời của nhãn.