Pivot Tables

{
  "rows": [
    {
      object (PivotGroup)
    }
  ],
  "columns": [
    {
      object (PivotGroup)
    }
  ],
  "criteria": {
    integer: {
      object (PivotFilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (PivotFilterSpec)
    }
  ],
  "values": [
    {
      object (PivotValue)
    }
  ],
  "valueLayout": enum (PivotValueLayout),
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  },

  // Union field source_data can be only one of the following:
  "source": {
    object (GridRange)
  },
  "dataSourceId": string
  // End of list of possible types for union field source_data.
}

object (PivotGroup)

ピボット テーブルの各行グループ。

object (PivotGroup)

ピボット テーブルの各列グループ。

map (key: integer, value: object ( PivotFilterCriteria))

ソース列のオフセットごとのフィルタのマッピング（省略可）。

フィルタは、ピボット テーブルにデータを集計する前に適用されます。マップのキーはフィルタするソース範囲の列オフセットで、値はその列の条件です。

たとえば、ソースが C10:E15、キー: 0 列のフィルタを使用します。 C であり、鍵 1 列に対する D。

このフィールドのサポートは終了し、 filterSpecs。

object (PivotFilterSpec)

ピボット テーブルのデータを集計する前にソース列に適用されるフィルタ。

両方 criteria および filterSpecs レスポンスに挿入されます。更新リクエストで両方のフィールドが指定されている場合、このフィールドが優先されます。

object (PivotValue)

ピボット テーブルに含める値のリスト。

enum (PivotValueLayout)

値を列として横に並べるか、行として縦に並べるかを指定します。

object (DataExecutionStatus)

出力専用。データソースのピボット テーブルのデータの実行ステータス。

object (GridRange)

ピボット テーブルがデータを読み取っている範囲。

string

ピボット テーブルがデータを読み取っているデータソースの ID。

{
  "showTotals": boolean,
  "valueMetadata": [
    {
      object (PivotGroupValueMetadata)
    }
  ],
  "sortOrder": enum (SortOrder),
  "valueBucket": {
    object (PivotGroupSortValueBucket)
  },
  "repeatHeadings": boolean,
  "label": string,
  "groupRule": {
    object (PivotGroupRule)
  },
  "groupLimit": {
    object (PivotGroupLimit)
  },

  // Union field source can be only one of the following:
  "sourceColumnOffset": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field source.
}

boolean

ピボット テーブルにこのグループの合計を含める場合は true に設定します。

object (PivotGroupValueMetadata)

グループ化の値に関するメタデータ。

enum (SortOrder)

このグループの値を並べ替える順序。

object (PivotGroupSortValueBucket)

並べ替えに使用される反対のピボット グループのバケット。指定しない場合、このグループの値でアルファベット順に並べ替えられます。

boolean

このピボット グループの見出しを繰り返す場合は true に設定します。これは行のグループ化にのみ有効で、列では無視されます。

デフォルトでは、同じ内容の上位レベルの見出しが表示されないようにして、見出しの繰り返しを最小限に抑えています。たとえば、次の 3 行目は「Q1 Mar」に対応しますが、前の行と冗長なので表示されません。repeatHeadings を true に設定すると「Q1」が発生する「2 月」に対して繰り返します。“Mar”とします

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+

string

カスタマイズ可能な行/列グループに使用するラベル。たとえば、次のピボット テーブルでは、行ラベルは Region （名前は、 State）で、列ラベルは Product （名前は Item など）。2017 年 12 月より前に作成されたピボット テーブルにはヘッダーラベルがありません。既存のピボット テーブルにヘッダーラベルを追加する場合は、既存のピボット テーブルを削除してから、同じパラメータで新しいピボット テーブルを作成してください。

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+

object (PivotGroupRule)

この行/列グループに適用するグループルール。

object (PivotGroupLimit)

このピボット グループに適用する行または列の上限数。

integer

このグループ化の基になっているソース範囲の列オフセット。

たとえば、ソースが C10:E15、 sourceColumnOffset / 0 はこのグループが列を参照することを意味します。 C であり、オフセットは 1 次の列を参照します。 D。

object (DataSourceColumnReference)

このグループ化の基になっているデータソース列への参照。

{
  "value": {
    object (ExtendedValue)
  },
  "collapsed": boolean
}

object (ExtendedValue)

メタデータが対応する計算値。（なお、 formulaValue は値が計算されるため無効です）。

boolean

値に対応するデータが閉じている場合は true。

{
  "valuesIndex": integer,
  "buckets": [
    {
      object (ExtendedValue)
    }
  ]
}

integer

オブジェクトのオフセットは PivotTable.values グループ化する値の並べ替え基準となるリストを指定します。

object (ExtendedValue)

並べ替える値を選択するバケットを指定します。

たとえば、1 つの行グループと2 つの列グループがある場合、その行グループには最大 2 つの値をリストできます。1 つ目の値は 1 つ目の列グループ内の値に対応し、2 つ目の値は 2 つ目の列グループの値に対応します。値がリストにない場合は、「総計」に従って行を並べ替える必要があることを示しています。クリックします。値が 1 つの場合は、「合計」表示されます。

{

  // Union field rule can be only one of the following:
  "manualRule": {
    object (ManualRule)
  },
  "histogramRule": {
    object (HistogramRule)
  },
  "dateTimeRule": {
    object (DateTimeRule)
  }
  // End of list of possible types for union field rule.
}

object (ManualRule)

ManualRule。

object (HistogramRule)

HistogramRule。

object (DateTimeRule)

DateTimeRule。

{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}

object (ManualRuleGroup)

グループ名と、各グループ名にマッピングされているソースデータの対応する項目のリスト。

{
  "groupName": {
    object (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}

object (ExtendedValue)

グループ名。文字列にする必要があります。特定の ManualRule 一意のグループ名が必要です。

object (ExtendedValue)

このグループに配置するソースデータ内のアイテム。各アイテムには文字列、数値、ブール値を指定できます。アイテムは、同じグループ内の最大 1 つのグループにしか ManualRule。グループに表示されないアイテムは単独で表示されます。

{
  "interval": number,
  "start": number,
  "end": number
}

number

作成されるバケットのサイズ。正の値を指定してください。

number

アイテムを一定サイズのバケットに入れる最小値。start を下回る値は 1 つのバケットにまとめて表示されます。このフィールドは省略可能です。

number

アイテムを一定サイズのバケットに入れる最大値。上限を超える値は 1 つのバケットにまとめて表示されます。このフィールドは省略可能です。

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

適用する日時のグループ化のタイプ。

{
  "countLimit": integer,
  "applyOrder": integer
}

integer

数の上限。

integer

グループ制限がピボット テーブルに適用される順序。

ピボット グループの制限は、注文番号の昇順に適用されます。注文番号は、0 からの連続する整数に正規化されます。

書き込みリクエストの場合、適用する注文を完全にカスタマイズするには、すべてのピボット グループの制限で、このフィールドに一意の番号を設定する必要があります。それ以外の場合の順序は、 PivotTable.rows 一覧表示してから、 PivotTable.columns 選択します。

{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}

string

含める必要がある値。ここに記載されていない値は除外されます。

object (BooleanCondition)

値を表示するには true になる条件。( visibleValues これをオーバーライドしません。値がリストされていても、条件を満たしていない場合は非表示になります）。

A1 表記の範囲を参照する条件値は、ピボット テーブル シートを基準として評価されます。参照は完全に扱われるため、ピボット テーブル内には入力されません。たとえば、条件値「 =A1 「ピボットテーブル 1」は 'Pivot Table 1'!$A$1。

ピボット テーブルのソースデータは、列見出し名で参照できます。たとえば、ソースデータに「Revenue」という列があり、[費用]条件が [収益]セクションに適用されます次の型の列 NUMBER_GREATER と値 =Cost] を選択し、「収益」の列のみ>費用含まれます。

boolean

値をデフォルトで表示するかどうか。true の場合、 visibleValues 無視され、その条件を満たすすべての値が condition 表示されます。false の場合、指定済みのフィールドと visibleValues そして condition 表示されます。

{
  "filterCriteria": {
    object (PivotFilterCriteria)
  },

  // Union field source can be only one of the following:
  "columnOffsetIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field source.
}

object (PivotFilterCriteria)

列の条件。

integer

ソース範囲のゼロベースの列オフセット。

object (DataSourceColumnReference)

データソース列への参照。

{
  "summarizeFunction": enum (PivotValueSummarizeFunction),
  "name": string,
  "calculatedDisplayType": enum (PivotValueCalculatedDisplayType),

  // Union field value can be only one of the following:
  "sourceColumnOffset": integer,
  "formula": string,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field value.
}

enum (PivotValueSummarizeFunction)

値を要約する関数。条件 formula 設定されている場合、サポートされる値は SUM および CUSTOM。条件 sourceColumnOffset 設定されている場合、 CUSTOM はサポートされていません。

string

値に使用する名前。

enum (PivotValueCalculatedDisplayType)

指定すると、別のピボット値を使用した計算の結果として、ピボット値が表示されることを示します。たとえば、computeDisplayType が PERCENT_OF_GRAND_TOTAL として指定されている場合、すべてのピボット値は、総計に対する割合として表示されます。これはスプレッドシート エディタでは [次の表示に変更] として表示されます。ピボットテーブルの値セクションで 使用できます

integer

この値を読み取るソース範囲の列オフセット。

たとえば、ソースが C10:E15、 sourceColumnOffset / 0 これは、この値が列を参照することを意味します。 C であり、オフセットは 1 次の列を参照します。 D。

string

値を計算するためのカスタム数式。数式の先頭は = あります。

object (DataSourceColumnReference)

この値が読み取られるデータソース列への参照。