スキーマでの計算フィールドの使用

formula フィールド プロパティを使用すると、コネクタのスキーマに計算フィールドを追加できます。

数式でサポートされている関数については、関数のリストをご覧ください。以下のリンクでは、各関数の詳しい説明をご覧いただけます。

数式内で別のフィールドの ID を参照する場合は、名前の前に $ を付けてください。たとえば、フィールド ID が t_celsius の場合、式では $t_celsius として参照する必要があります。

計算フィールドの Type

計算フィールドでは Type がサポートされていますが、数式の出力はその Type で想定される形式と一致する必要があります。

たとえば、次の式の場合は:

"HYPERLINK($url, $description)"

Type は、HYPERLINK でなければなりません。

計算フィールドの aggregation

数式に集計が含まれている場合は、aggregation を AUTO に設定する必要があります。関数リストの type 列をチェックして、関数が集計を返すかどうかを確認します。数式に集計が含まれない場合は、NONE に設定します。

数式 aggregation
"SUM($cost) / SUM($units)" AUTO
"$cost + $units" NONE

スキーマの計算フィールドの例

function getSchema(request) {
  var cc = DataStudioApp.createCommunityConnector();
  var fields = cc.getFields();
  var types = cc.FieldType;
  var aggregations = cc.AggregationType;

  fields.newDimension()
      .setId('date')
      .setName('Date')
      .setDescription('Date of measurement')
      .setType(types.YEAR_MONTH_DAY);

  fields.newMetric()
      .setId('t_celsius')
      .setName('Temperature (Celsius)')
      .setDescription('Temperature in Celsius')
      .setType(types.NUMBER)
      .setAggregation(aggregations.NONE);

  fields.newMetric()
      .setId('t_fahrenheit')
      .setName('Temperature (Fahrenheit)')
      .setDescription('Temperature in Fahrenheit')
      .setFormula('$t_celsius / 5 * 9 + 32')
      .setType(types.NUMBER)
      .setAggregation(aggregations.NONE);

  fields.newMetric()
      .setId('average_temperature (Celsius)')
      .setName('Average Temperature (Celsius)')
      .setDescription('Temperature in Fahrenheit')
      .setFormula('AVG($t_celsius)')
      .setType(types.NUMBER)
      .setAggregation(aggregations.AUTO);

  fields.newMetric()
      .setId('average_temperature (Celsius)')
      .setName('Average Temperature (Celsius)')
      .setDescription('Temperature in Fahrenheit')
      .setFormula('AVG($t_celsius / 5 * 9 + 32)')
      .setType(types.NUMBER)
      .setAggregation(aggregations.AUTO);

  fields.newDimension()
      .setId('feels_like')
      .setName('Feels Like')
      .setDescription('What it feels like outside.')
      .setFormula('CASE WHEN $t_celsius < 0 THEN "Freezing" WHEN $t_celsius > 40 THEN "Too warm" ELSE "Not bad" END')
      .setType(types.TEXT);

  return { 'schema': fields.build() };
}