搜索标签

您的组织可以有多个标签，而标签可以包含多个字段。 标签 API 提供 labels 集合，以启用 标签读取。

本页面介绍了如何搜索和检索标签。

方法

labels 集合提供 以下方法读取标签值，每种方法都有特定的任务：

Range 阅读
按资源名称单个标签 labels.get
所有标签 labels.list

按资源名称获取标签

要按资源名称获取单个标签，请使用 labels.get 方法。

标签资源名称是必填项，可以采用如下结构：

  • labels/{id} 或 labels/{id}@latest - 获取最新的标签修订版本。
  • labels/{id}@published - 获取当前发布的标签修订版本。
  • labels/{id}@{revisionId} - 获取指定修订版本 ID 处的标签。

您还必须指定以下内容：

  • LabelView为 LABEL_VIEW_FULL 用于设置应用于标签响应的资源视图。 LABEL_VIEW_FULL 会返回所有可能的字段。

此示例使用 Name 按资源名称获取单个标签。

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);
});

列出所有标签

要获取标签列表，请使用 labels.list 方法。

您还必须指定以下内容：

  • 一个 customer，用于限定此范围 list 请求的状态。如果 customer 未设置，则当前标签中的所有标签 客户被退回。

  • LabelView为 LABEL_VIEW_FULL 用于设置应用于标签响应的资源视图。 LABEL_VIEW_FULL 会返回所有可能的字段。

此示例使用 CUSTOMER 检索标签列表。

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');
  }
});