Class Fields

필드

커뮤니티 커넥터의 Field 집합을 포함합니다. 이 필드 집합은 측정기준 및 측정항목은 데이터 스튜디오에서 사용할 수 있습니다. 

var cc = DataStudioApp.createCommunityConnector();
var fields = cc.getFields();
var types = cc.FieldType;

var field1 = fields.newDimension()
  // Set other properties as needed.
  .setId('field1_id');

메서드

메서드반환 유형간략한 설명
asArray()Field[]이 객체의 뷰를 배열로 반환합니다.
build()Object[]이 객체의 유효성을 검사하고 데이터 스튜디오에서 필요한 형식으로 반환합니다.
forIds(ids)Fieldsids에 ID가 있는 Field로 필터링된 새 Fields 객체를 반환합니다.
getDefaultDimension()Field필드 집합에 사용할 기본 측정기준을 반환합니다.
getDefaultMetric()Field필드 집합에 사용할 기본 측정항목을 반환합니다.
getFieldById(fieldId)Field지정된 ID가 있는 필드를 반환하거나, 이 Fields 객체에 해당 ID가 있는 필드가 없는 경우 null를 반환합니다.
newDimension()Field새 측정기준 Field를 반환합니다.
newMetric()Field새 측정항목 Field를 반환합니다.
setDefaultDimension(fieldId)void필드 집합에 사용할 기본 측정기준을 설정합니다.
setDefaultMetric(fieldId)void필드 집합에 사용할 기본 측정항목을 설정합니다.

자세한 문서

asArray()

이 객체의 뷰를 배열로 반환합니다. 

var fields = //reference to fields object.
fields.newDimension().setId('field1_id');
fields.newDimension().setId('field2_id');
fields.newDimension().setId('field3_id');

// Logging the ID of each field:
fields
  .asArray()
  .map(function(field) {
     Logger.log(field.getId());
  });

리턴

Field[] - Field 객체의 배열입니다.

build()

이 객체의 유효성을 검사하고 데이터 스튜디오에서 필요한 형식으로 반환합니다.

리턴

Object[] - 검증된 필드 데이터로, 객체 목록으로 표시됩니다.

생성 값

Error: 유효한 객체를 생성할 수 없는 경우

forIds(ids)

ids에 ID가 있는 Field로 필터링된 새 Fields 객체를 반환합니다. 

var fields = //reference to fields object.
fields.newDimension().setId('field1_id');
fields.newDimension().setId('field2_id');
fields.newDimension().setId('field3_id');

// subsetFields is a Fields object that only contains field1 and field2.
var subsetFields = fields.forIds(['field1_id', 'field3_id']);

매개변수

이름유형설명
idsString[]유지해야 하는 필드의 ID입니다.

리턴

Fields - 새 Fields 객체입니다.

getDefaultDimension()

필드 집합에 사용할 기본 측정기준을 반환합니다. 기본 측정기준은 새로운 시각화가 만들어질 때 자동으로 선택됩니다.

리턴

Field - 기본 측정기준으로 설정된 측정기준 또는 기본값이 없는 경우 null 측정기준을 설정할 수 있습니다.

getDefaultMetric()

필드 집합에 사용할 기본 측정항목을 반환합니다. 기본 측정항목이 선택됩니다. 새로운 시각화가 만들어질 때 자동으로 생성됩니다.

리턴

Field — 기본 측정항목으로 설정된 측정항목 또는 기본 측정항목이 없는 경우 null 설정합니다.

getFieldById(fieldId)

지정된 ID가 있는 필드를 반환하거나, 이 Fields 객체에 해당 ID가 있는 필드가 없는 경우 null를 반환합니다. 

var fields = //reference to fields object.
var field1 = fields.newDimension().setId('field1_id');

// byId is the same as field1.
var byId = fields.getFieldById('field1_id');

// byId2 is null.
var byId2 = fields.getFieldById('not present id');

매개변수

이름유형설명
fieldIdString가져올 필드의 ID입니다.

리턴

Field - 지정된 ID가 있는 Field 또는 null(이러한 필드가 포함되어 있지 않은 경우) 이 Fields 객체 내에서는

newDimension()

새 측정기준 Field를 반환합니다.

리턴

Field — 새 측정기준 Field입니다.

newMetric()

새 측정항목 Field를 반환합니다.

리턴

Field — 새 측정항목 Field입니다.

setDefaultDimension(fieldId)

필드 집합에 사용할 기본 측정기준을 설정합니다. 기본 측정기준이 선택되어 있습니다. 새로운 시각화가 만들어질 때 자동으로 생성됩니다.

매개변수

이름유형설명
fieldIdString기본 측정기준으로 사용할 필드의 ID입니다. 이 ID는 살펴보겠습니다.

setDefaultMetric(fieldId)

필드 집합에 사용할 기본 측정항목을 설정합니다. 기본 측정항목이 선택됩니다. 새로운 시각화가 만들어지면 자동으로 생성됩니다.

매개변수

이름유형설명
fieldIdString기본 측정항목으로 사용할 필드의 ID입니다. 이 ID는 필드 집합으로 구성되어 있습니다.