Class Field

A Field object contains data-related information and its properties determine how it's used in Data Studio.
You can create a new field using fields.newDimension() or similar methods.
Field objects have methods to get and set various properties like ID, name, description, type, and aggregation.
Methods starting with get retrieve the current value of a field property.
Methods starting with set modify the value of a field property and return the Field object for chaining.

Contains field-related data. Its properties determine how the field is used in Data Studio.

const cc = DataStudioApp.createCommunityConnector();
const fields = cc.getFields();

const field1 = fields.newDimension()
                   .setId('field1_id')
                   .setName('Field 1 ID')
                   .setDescription('The first field.')
                   .setType(cc.FieldType.YEAR_MONTH)
                   .setGroup('DATETIME');

Detailed documentation

`getAggregation()`

`getDescription()`

Returns the description of this Field. Descriptions are short explanations of a field's purpose.

Return

String — The description for this field.

`getFormula()`

Returns the formula of this Field. Formulas define a data transformation that Data Studio runs at query-time.

Return

String — The formula for this field.

`getGroup()`

Returns the group of this Field. Fields collected into a group are presented together in the Data Studio UI.

Return

String — The group for this field.

`getId()`

Returns the ID of this Field. IDs are unique per set of fields and are used in formulas to refer to fields.

Return

String — The ID for this field.

`getIsReaggregatable()`

Returns true if this field can be reaggregated, false otherwise.

Return

Boolean — true if this field can be reaggregated, false otherwise.

`getName()`

Returns the name of this Field. Names are shown to the user to distinguish fields.

Return

String — The name for this field.

`getType()`

`isDefault()`

Returns true if this Field is the default metric or dimension.

Return

Boolean — true if this Field is the default metric or dimension; false otherwise.

`isDimension()`

Returns true if this field is a dimension.

Return

Boolean — true if this field is a dimension; returns false otherwise.

`isMetric()`

Returns true if this field is a metric.

Return

Boolean — true if this field is a metric; returns false otherwise.

`setAggregation(aggregation)`

Sets the aggregation type of this Field. AggregationType determines how Data Studio combines similar data into dimensions. This throws an error if called on a metric.