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

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

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

Tắt nhãn

Việc tắt nhãn sẽ dẫn đến một bản sửa đổi mới đã phát hành 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ó một bản sửa đổi nháp, thì một bản sửa đổi bản nháp mới đã bị vô hiệu hoá sẽ được tạo dựa trên bản sửa đổi bản nháp mới nhất. Các bản sửa đổi nháp cũ hơn 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ị tắt, người dùng vẫn có thể áp dụng nhãn này thông qua API. Nhãn vẫn xuất hiện ở vị trí đã áp dụng và trong kết quả tìm kiếm của bạn. Bạn có thể xoá nhãn bị vô hiệu hoá.

Để vô hiệu hoá nhãn đã xuất bản, hãy sử dụng phương thức disable trên bộ sưu tập labels.

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

  • Tài nguyên nhãn đại diện cho mọi nhãn. Gói 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 hệ thống của nhãn.

  • useAdminAccess được true sử dụng thông tin đăng nhập quản trị viên 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 đúng nhãn.

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 tăng lên. Người dùng có thể áp dụng nhãn thông qua API. Tuy nhiên, một nhãn đã tắt sẽ không hiển thị trong giao diện người dùng trừ phi thuộc tính showInApply của phương thức disabledPolicy được định cấu hình.

Bật nhãn

Việc bật nhãn bị vô hiệu hóa sẽ khôi phục nhãn về trạng thái đã xuất bản. Việc này sẽ dẫn đến 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 tại bị vô hiệu hoá. Nếu hiện có một bản sửa đổi bản nháp 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 nhãn đã 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. Gói 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 hệ thống của nhãn.

  • useAdminAccess được true sử dụng thông tin đăng nhập quản trị viên 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 đúng nhãn.

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 tăng lên. Người dùng có thể xem và áp dụng nhãn cho các tệp thông qua API.

Xóa nhãn

Bạn chỉ có thể xoá những nhãn nháp và nhãn bị vô hiệu hoá. Khi nhãn bị xoá, mọi trường hợp đã áp dụng nhãn trước đó, 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à 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 vô hiệu hoá 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. Gói 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 hệ thống của nhãn.

  • useAdminAccess được true sử dụng thông tin đăng nhập quản trị viên 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á đúng nhãn.

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 tăng lên. Không thể áp dụng nhãn và các nhãn đã xoá cuối cùng sẽ bị xoá hoàn toàn. Để biết thêm thông tin, hãy xem phần Vòng đời của nhãn.