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

Trang này mô tả cách thực hiện các thao tác liên quan đến nhãn:

  • Tắt nhãn
  • Bật nhãn
  • Xóa nhãn

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

Sau khi tắt, người dùng vẫn có thể áp dụng nhãn này thông qua 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 của bạn. Bạn có thể xoá nhãn bị tắt.

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

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

  • Tài nguyên nhãn đại diện cho mọi nhãn. Tệp này chứa tài nguyên Name và ID. Đây là giá trị nhận dạng duy nhất trên toàn cầu cho nhãn.

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

Ví dụ này sử dụng ID để tắt nhãn chính xác.

Python

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

Node.js

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

Nhãn có State là DISABLED và mã sửa đổi của nhãn được tăng lên. Người dùng có thể áp dụng nhãn thông qua API. Tuy nhiên, nhãn bị tắt sẽ không xuất hiện trong giao diện người dùng trừ khi bạn định cấu hình thuộc tính showInApply của phương thức disabledPolicy.

Bật nhãn

Việc bật một nhãn bị tắt sẽ khôi phục nhãn đó 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 mới được phát hành dựa trên bản sửa đổi đã phát hành hiện đang bị vô hiệu hoá. Nếu có bản sửa đổi bản nháp bị tắt, hệ thống sẽ tạo một bản sửa đổi mới dựa trên bản nháp đó và bật bản sửa đổi đó. Để biết thêm thông tin, hãy xem phần Vòng đời của nhãn.

Để bật nhãn bị tắt, hãy sử dụng phương thức enable.

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

  • Tài nguyên nhãn đại diện cho mọi nhãn. Tệp này chứa tài nguyên Name và ID. Đây là giá trị nhận dạng duy nhất trên toàn cầu cho nhãn.

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

Ví dụ này sử dụng ID để bật nhãn chính xác.

Python

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

Node.js

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

Nhãn có State là PUBLISHED và mã sửa đổi của nhãn được tăng lên. Người dùng có thể xem và áp dụng nhãn cho tệp thông qua API.

Xóa nhãn

Bạn chỉ có thể xoá các nhãn ở trạng thái bản nháp và tắt. Khi một nhãn bị xoá, tất cả các thực thể mà nhãn đó từng được áp dụng, bao gồm 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ị xoá khỏi các tệp 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.

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

  • Tài nguyên nhãn đại diện cho mọi nhãn. Tệp này chứa tài nguyên Name và ID. Đây là giá trị nhận dạng duy nhất trên toàn cầu cho nhãn.

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

Ví dụ này sử dụng ID để 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',
  'use_admin_access': true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Nhãn có State là DELETED và mã sửa đổi của nhãn được tăng lên. Bạn không thể áp dụng nhãn và các nhãn đã xoá cuối cùng sẽ bị xoá bỏ. Để biết thêm thông tin, hãy xem phần Vòng đời của nhãn.