搜尋標籤

貴機構可以設定多個標籤，其中包含多個欄位的標籤。 標籤 API 提供 labels 集合來啟用 讀取標籤。

本頁說明如何搜尋並擷取標籤。

方法

labels 集合提供 下列讀取標籤值的方法，每種方法都有特定工作：

依據資源名稱取得標籤

如要依資源名稱取得單一標籤，請使用 labels.get 方法，增加圍繞地圖邊緣的邊框間距。

必須提供標籤資源名稱，結構可以是：

• labels/{id} 或 labels/{id}@latest：取得最新標籤修訂版本。
• labels/{id}@published：取得目前已發布的標籤修訂版本。
• labels/{id}@{revisionId}：取得指定修訂版本 ID 的標籤。

您也必須指定：

• LabelView 是 LABEL_VIEW_FULL，用來設定套用至標籤回應的資源檢視畫面。 LABEL_VIEW_FULL 會傳回所有可能的欄位。

此範例使用 Name，根據資源名稱取得單一標籤。

# 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()

# 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 界定此範圍 在「清單」中提出權限要求如未設定 customer，目前所有標籤 這樣客戶就會收到一次轉換

• LabelView 是 LABEL_VIEW_FULL，用來設定套用至標籤回應的資源檢視畫面。 LABEL_VIEW_FULL 會傳回所有可能的欄位。

本例使用 CUSTOMER 擷取標籤清單。

response = service.labels().list(
  customer='customers/CUSTOMER', view='LABEL_VIEW_FULL').execute()

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