Tổ chức của bạn có thể có nhiều nhãn, trong đó các nhãn có nhiều trường.
API Nhãn cung cấp tập hợp labels
để cho phép đọc nhãn.
Trang này mô tả cách tìm kiếm và truy xuất nhãn.
Phương thức
Bộ sưu tập labels
cung cấp các phương thức sau để đọc giá trị nhãn, mỗi phương thức dành cho một tác vụ cụ thể:
Phạm vi | Đọc truyện |
---|---|
Một nhãn theo tên tài nguyên | labels.get |
Tất cả nhãn | labels.list |
Lấy nhãn theo tên tài nguyên
Để lấy một nhãn duy nhất theo tên tài nguyên của nhãn đó, hãy sử dụng phương thức labels.get
.
Bạn phải nhập tên tài nguyên nhãn và tên có thể có cấu trúc như sau:
labels/{id}
hoặclabels/{id}@latest
— Tải bản sửa đổi nhãn mới nhất.labels/{id}@published
— Tải bản sửa đổi nhãn đã xuất bản hiện tại.labels/{id}@{revisionId}
—Lấy nhãn tại mã bản sửa đổi đã chỉ định.
Bạn cũng phải chỉ định:
LabelView
làLABEL_VIEW_FULL
để đặt chế độ xem Resource (Tài nguyên) được áp dụng cho phản hồi của nhãn.LABEL_VIEW_FULL
trả về tất cả các trường có thể có.
Ví dụ này sử dụng Name
để lấy một nhãn duy nhất theo tên tài nguyên.
Python
# Label name, with or without revision:
#
# Revision specified:
# labels/LABEL_ID@published
# labels/LABEL_ID@latest
# labels/LABEL_ID@1
#
# No revision specified, returns latest revision:
# labels/LABEL_ID
name = "labels/NAME@published"
# Label view controls level of data in response
view = 'LABEL_VIEW_FULL'
label = service.labels().get(name=name, view=view).execute()
Node.js
# Label name, with or without revision:
#
# Revision specified:
# labels/LABEL_ID@published
# labels/LABEL_ID@latest
# labels/LABEL_ID@1
#
# No revision specified, returns latest revision:
# labels/LABEL_ID
name = "labels/NAME@published"
# Label view controls level of data in response
view = 'LABEL_VIEW_FULL'
service.labels.get({
'name': name,
'view': view
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
console.log(res);
});
Liệt kê tất cả các nhãn
Để xem danh sách nhãn, hãy sử dụng phương thức labels.list
.
Bạn cũng phải chỉ định:
customer
để xác định phạm vi yêu cầu danh sách này. Nếu bạn không đặtcustomer
, tất cả nhãn trong khách hàng hiện tại sẽ được trả về.LabelView
làLABEL_VIEW_FULL
để đặt chế độ xem Resource (Tài nguyên) được áp dụng cho phản hồi của nhãn.LABEL_VIEW_FULL
trả về tất cả các trường có thể có.
Ví dụ này sử dụng CUSTOMER
để truy xuất danh sách nhãn.
Python
response = service.labels().list(
customer='customers/CUSTOMER', view='LABEL_VIEW_FULL').execute()
Node.js
const params = {
'customer': 'customers/CUSTOMER',
'view': 'LABEL_VIEW_FULL'
};
service.labels.list(params, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
const labels = res.data.labels;
if (labels) {
labels.forEach((label) => {
const name = label.name;
const title = label.properties.title;
console.log(`${name}\t${title}`);
});
} else {
console.log('No Labels');
}
});