라벨 검색

조직은 라벨을 여러 개 가질 수 있으며, 라벨의 입력란은 여러 개일 수 있습니다. Labels API는 labels 컬렉션을 사용하여 라벨을 읽습니다.

이 페이지에서는 라벨을 검색하고 가져오는 방법을 설명합니다.

메서드

labels 컬렉션은 다음과 같이 각각 특정 작업을 염두에 두고 라벨 값을 읽는 방법을 보여줍니다.

범위 읽기
리소스 이름별 단일 라벨 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');
  }
});