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:

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

Tắt nhãn

Việc tắt nhãn sẽ tạo ra một bản sửa đổi đã xuất bản mới ở trạng thái 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, thì một bản sửa đổi nháp mới ở trạng thái tắt 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á. Để biết thêm thông tin, hãy xem 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 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 đã tắt .

Để tắ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ài nguyên này chứa Name và ID (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 của quản trị viên của người dùng. Máy chủ sẽ 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ã bản 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 đã tắt sẽ không xuất hiện trong giao diện người dùng, trừ phi 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 nhãn đã tắt sẽ khôi phục nhãn đó về trạng thái đã xuất bản. Việ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 ở trạng thái tắt. Nếu có bản sửa đổi nháp đã tắt hiện tại, 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 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. Tài nguyên này chứa Name và ID (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 của quản trị viên của người dùng. Máy chủ sẽ 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 của PUBLISHED và mã bản 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.

Xoá nhãn

Bạn chỉ có thể xoá nhãn nháp và nhãn đã tắt. 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 đó, 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ị xoá khỏi các tệp Drive đó.

Để xoá 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ài nguyên này chứa Name và ID (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 của quản trị viên của người dùng. Máy chủ sẽ 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 của DELETED và mã bản sửa đổi của nhãn được tăng lên. Không thể áp dụng nhãn và các nhãn đã xoá sẽ bị xoá hoàn toàn. Để biết thêm thông tin, hãy xem bài viết Vòng đời của nhãn.