PivotTable
ピボット テーブル。
JSON 表現 |
---|
{ "rows": [ { object ( |
フィールド | |
---|---|
rows[]
|
ピボット テーブル内の各行のグループ化。 |
columns[]
|
ピボット テーブル内での各列グループ。 |
criteria
|
ソース列のオフセットごとのフィルタのマッピング(省略可)。 フィルタは、ピボット テーブルにデータを集計する前に適用されます。マップのキーはフィルタするソース範囲の列オフセットで、値はその列の条件です。
たとえば、ソースが
このフィールドは非推奨のため、 |
filterSpecs[]
|
ピボット テーブルのデータを集計する前にソース列に適用されたフィルタ。
レスポンスには |
values[]
|
ピボット テーブルに含める値のリスト。 |
valueLayout
|
値を横方向(列として)または縦方向(行として)表示するかどうか。 |
dataExecutionStatus
|
出力専用。データソースのピボット テーブルのデータ実行ステータス。 |
共用体フィールド source_data 。ピボット テーブルのデータのソース。
source_data は次のいずれかになります。 |
|
source
|
ピボット テーブルがデータを読み取る範囲。 |
dataSourceId
|
ピボット テーブルがデータを読み取るデータソースの ID。 |
PivotGroup
ピボット テーブル内の 1 つのグループ(行または列)。
JSON 表現 |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
フィールド | |
---|---|
showTotals
|
ピボット テーブルにこのグループの合計を含める場合は true に設定します。 |
valueMetadata[]
|
グループ内の値に関するメタデータ。 |
sortOrder
|
このグループの値を並べ替える順序。 |
valueBucket
|
並べ替え基準とする反対側のピボット グループのバケット。指定しない場合、並べ替えはこのグループの値のアルファベット順になります。 |
repeatHeadings
|
このピボット グループの見出しを繰り返す必要がある場合は true です。これは行のグループ化に対してのみ有効で、列では無視されます。 デフォルトでは、上位レベルの見出しが同じ場合は表示されないようにして、見出しの繰り返しを最小限に抑えます。たとえば、下の 3 行目は「Q1 Mar」に対応していますが、「Q1」は前の行と重複するため表示されません。repeatHeadings を true に設定すると、「2 月」と「3 月」に対して「Q1」が繰り返されます。
|
label
|
カスタマイズ可能な行/列グループに使用するラベル。たとえば、次のピボット テーブルでは、行ラベルは
|
groupRule
|
この行/列グループに適用するグループルール。 |
groupLimit
|
このピボット グループに適用する行または列数の上限。 |
共用体フィールド source 。ピボット グループのデータソース。
source は次のいずれかになります。 |
|
sourceColumnOffset
|
このグループ化の基となるソース範囲の列オフセット。
たとえば、ソースが |
dataSourceColumnReference
|
このグループ化のベースとなるデータソース列への参照。 |
PivotGroupValueMetadata
ピボット グループ内の値に関するメタデータ。
JSON 表現 |
---|
{
"value": {
object (
|
フィールド | |
---|---|
value
|
メタデータが対応する計算値。(値が計算されるため、 |
collapsed
|
値に対応するデータが閉じられている場合は true。 |
PivotGroupSortValueBucket
並べ替えに使用するピボット グループ内の値の情報。
JSON 表現 |
---|
{
"valuesIndex": integer,
"buckets": [
{
object (
|
フィールド | |
---|---|
valuesIndex
|
このグループ化の値の並べ替え基準とする |
buckets[]
|
並べ替える値の選択元となるバケットを指定します。 たとえば、1 つの行グループと 2 つの列グループがあるピボット テーブルでは、行グループに最大 2 つの値を入れることができます。1 つ目の値は 1 つ目の列グループ内の値に対応し、2 つ目の値は 2 つ目の列グループ内の値に対応しています。値がリストされていない場合は、列グループの「総計」に基づいて行を並べ替える必要があります。値が 1 つだけ表示されている場合は、そのバケットの「合計」に相当します。 |
PivotGroupRule
個々の値を分解するのではなく、ソースデータ列の値のバケットを定義する PivotGroup
のオプション設定。グループルールを持つ PivotGroup
はソースデータの列ごとに 1 つだけ追加できますが、任意の列には、ルールを持つ PivotGroup
とそうでない PivotGroup
の両方を追加できます。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド rule 。PivotGroup に適用するルール。
rule は次のいずれかになります。 |
|
manualRule
|
|
histogramRule
|
|
dateTimeRule
|
|
ManualRule
ソースデータの列の値を、任意の名前のバケットに手動で整理できます。たとえば、州ごとに人口を集計するピボット テーブルは次のようになります。
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
手動グループルールにグループのリスト(groupName = 'Central'、items = ['AL', 'AR', 'IA', ...] など)を与えることで、タイムゾーンごとに人口を集計するピボット テーブルに変換できます。なお、ソースデータにタイムゾーン列を追加してピボット テーブルを調整した場合も、同様の効果が得られます。
+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central | 106.3 |
| Eastern | 151.9 |
| Mountain | 17.4 |
...
+-----------+-------------------+
JSON 表現 |
---|
{
"groups": [
{
object (
|
フィールド | |
---|---|
groups[]
|
グループ名と、各グループ名にマッピングされているソースデータの対応する項目のリスト。 |
ManualRuleGroup
グループ名と、この名前のグループに配置する必要があるソースデータの項目リスト。
JSON 表現 |
---|
{ "groupName": { object ( |
フィールド | |
---|---|
groupName
|
グループ名。文字列で指定する必要があります。特定の |
items[]
|
このグループに配置するソースデータ内の項目。各項目には、文字列、数値、ブール値を指定できます。アイテムは、1 つの |
HistogramRule
ソースデータ列の数値を、一定サイズのバケットに整理できます。HistogramRule.start
から HistogramRule.end
のすべての値がサイズ HistogramRule.interval
のグループに配置されます。また、HistogramRule.start
の下のすべての値は 1 つのグループに配置され、HistogramRule.end
を超える値はすべて別のグループに配置されます。HistogramRule.interval
のみが必須ですが、HistogramRule.start
と HistogramRule.end
の両方が指定されている場合は、HistogramRule.start
は HistogramRule.end
より小さくする必要があります。たとえば、年齢別の平均購入金額を示すピボット テーブルには 50 行以上の行があります。
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
HistogramRule.start
が 25、HistogramRule.interval
が 20、HistogramRule.end
が 65 のヒストグラム グループ ルールを適用すると、次のようなピボット テーブルに変換できます。
+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25 | $19.34 |
| 25-45 | $31.43 |
| 45-65 | $35.87 |
| > 65 | $27.55 |
+-------------+-------------------+
| Grand Total | $29.12 |
+-------------+-------------------+
JSON 表現 |
---|
{ "interval": number, "start": number, "end": number } |
フィールド | |
---|---|
interval
|
作成されるバケットのサイズ。正の値を指定してください。 |
start
|
アイテムを一定サイズのバケットに入れる最小値。start 以下の値は 1 つのバケットにまとめられます。このフィールドは省略可能です。 |
end
|
一定サイズのバケットに商品アイテムが入れられる最大値。指定した値を超える値は 1 つのバケットにまとめられます。このフィールドは省略可能です。 |
DateTimeRule
ソースデータ列の日時の値を、日時の値の選択した部分に基づいてバケットに整理できます。たとえば、販売取引を日付別に示したピボット テーブルについて考えてみましょう。
+----------+--------------+
| Date | SUM of Sales |
+----------+--------------+
| 1/1/2017 | $621.14 |
| 2/3/2017 | $708.84 |
| 5/8/2017 | $326.84 |
...
+----------+--------------+
DateTimeRuleType
が YEAR_MONTH の日時グループルールを適用すると、次のピボット テーブルが作成されます。
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
JSON 表現 |
---|
{
"type": enum (
|
フィールド | |
---|---|
type
|
適用する日時グループ化のタイプ。 |
DateTimeRuleType
使用可能な日時グループ化ルールの種類。このドキュメントでは、スプレッドシートの言語 / 地域が「en-US」であることを前提としていますが、一部のルールタイプでは、日付と時刻の実際のレンダリングではスプレッドシートの言語 / 地域が使用されます。
列挙型 | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
デフォルトのタイプです。使用しないでください。 |
SECOND
|
日付を 0 ~ 59 秒でグループ化します。 |
MINUTE
|
0 ~ 59 の範囲で日付を分単位でグループ化します。 |
HOUR
|
24 時間制を使用して、0 ~ 23 の範囲で日付をグループ化します。 |
HOUR_MINUTE
|
24 時間制を使用して日付を時間と分でグループ化します(例: 19:45)。 |
HOUR_MINUTE_AMPM
|
12 時間制を使用して日付を時間と分でグループ化します(例:午後 7 時 45 分)。AM / PM の指定は、スプレッドシートの言語 / 地域に基づいて翻訳されます。 |
DAY_OF_WEEK
|
日曜日など、曜日ごとに日付をグループ化します。曜日は、スプレッドシートの言語 / 地域に基づいて翻訳されます。 |
DAY_OF_YEAR
|
日付を 1 ~ 366 の範囲内でグループ化します。2 月 29 日以降の日付は、うるう年とうるう年以外の場合とで、異なるバケットに分類されます。 |
DAY_OF_MONTH
|
日付を 1 ~ 31 の範囲で日ごとにグループ化します。 |
DAY_MONTH
|
日付は日と月でグループ化します(例: 11 月 22 日)。月はスプレッドシートの言語 / 地域に基づいて翻訳されます。 |
MONTH
|
日付を月別にグループ化します(11 月など)。月はスプレッドシートの言語 / 地域に基づいて翻訳されます。 |
QUARTER
|
日付は四半期ごとにグループ化します。たとえば、第 1 四半期(1 月~ 3 月を表す)などです。 |
YEAR
|
日付を年別にグループ化します(例: 2008)。 |
YEAR_MONTH
|
日付を年と月でグループ化します(例: 2008-11 月)。月は、スプレッドシートの言語 / 地域に基づいて翻訳されます。 |
YEAR_QUARTER
|
年や四半期ごとに日付をグループ化します(「2008 Q4」など)。 |
YEAR_MONTH_DAY
|
年、月、日で日付をグループ化します(例: 2008-11-22)。 |
PivotGroupLimit
ピボット グループ内の行または列数の上限。
JSON 表現 |
---|
{ "countLimit": integer, "applyOrder": integer } |
フィールド | |
---|---|
countLimit
|
上限数。 |
applyOrder
|
グループの上限がピボット テーブルに適用される順序。 ピボット グループの制限は、順序番号が小さいものから高いものの順に適用されます。注文番号は 0 の連続する整数に正規化されます。
書き込みリクエストの場合、適用する注文を完全にカスタマイズするには、すべてのピボット グループの制限に、このフィールドに一意の番号を設定する必要があります。それ以外の場合、順序は |
PivotFilterCriteria
ピボット テーブルの行を表示または非表示にする条件。
JSON 表現 |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
フィールド | |
---|---|
visibleValues[]
|
含める必要がある値。ここに記載されていない値は除外されます。 |
condition
|
条件。値を表示するために true でなければなりません。(
A1 表記の範囲を参照する条件値は、ピボット テーブルのシートを基準にして評価されます。参照は絶対に扱われるため、ピボット テーブルには入力されません。たとえば、「ピボット テーブル 1」の条件値
ピボット テーブルのソースデータは、列見出し名で参照できます。たとえば、ソースデータに「Revenue」と「Cost」という名前の列があり、タイプが |
visibleByDefault
|
デフォルトで値を表示するかどうかを指定します。true の場合、 |
PivotFilterSpec
特定のソース列のオフセットに関連付けられたピボット テーブルのフィルタ条件。
JSON 表現 |
---|
{ "filterCriteria": { object ( |
フィールド | |
---|---|
filterCriteria
|
列の条件。 |
共用体フィールド source 。このフィルタが適用されるソース列。source は次のいずれかになります。 |
|
columnOffsetIndex
|
ソース範囲のゼロベースの列オフセット。 |
dataSourceColumnReference
|
データソース列への参照。 |
PivotValue
ピボット テーブル内の値の計算方法の定義。
JSON 表現 |
---|
{ "summarizeFunction": enum ( |
フィールド | |
---|---|
summarizeFunction
|
値を集計する関数。 |
name
|
値に使用する名前。 |
calculatedDisplayType
|
指定すると、別のピボット値を使用した計算の結果としてピボット値が表示されることを示します。たとえば、computeType が PERCENT_OF_GRAND_TOTAL として指定されている場合、すべてのピボット値が総計に対する割合として表示されます。スプレッドシート エディタでは、これはピボット テーブルの値セクションに [表示方法] と表示されます。 |
共用体フィールド value 。ピボット テーブルの値に使用するデータ。必ず 1 つの値を設定する必要があります。value は次のいずれかになります。 |
|
sourceColumnOffset
|
この値の読み取り元となるソース範囲の列オフセット。
たとえば、ソースが |
formula
|
値を計算するためのカスタム数式。数式の先頭は「 |
dataSourceColumnReference
|
この値が読み取られるデータソース列への参照。 |
PivotValueSummarizeFunction
ピボット値を要約する関数。
列挙型 | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
デフォルトの設定では、使用しないでください。 |
SUM
|
SUM 関数に対応します。
|
COUNTA
|
COUNTA 関数に対応します。
|
COUNT
|
COUNT 関数に対応します。
|
COUNTUNIQUE
|
COUNTUNIQUE 関数に対応します。
|
AVERAGE
|
AVERAGE 関数に対応します。
|
MAX
|
MAX 関数に対応します。
|
MIN
|
MIN 関数に対応します。
|
MEDIAN
|
MEDIAN 関数に対応します。
|
PRODUCT
|
PRODUCT 関数に対応します。
|
STDEV
|
STDEV 関数に対応します。
|
STDEVP
|
STDEVP 関数に対応します。
|
VAR
|
VAR 関数に対応します。
|
VARP
|
VARP 関数に対応します。
|
CUSTOM
|
数式をそのまま使用することを示します。PivotValue.formula が設定されている場合のみ有効です。
|
NONE
|
値がすでに要約されていて、要約関数が明示的に指定されていないことを示します。値がすでに要約されている Looker データソースのピボット テーブルに使用されます。 |
PivotValueCalculatedDisplayType
表示するピボット値の計算方法。
列挙型 | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
デフォルト値。使用しないでください。 |
PERCENT_OF_ROW_TOTAL
|
ピボット値を、行の合計値に対するパーセンテージとして表示します。 |
PERCENT_OF_COLUMN_TOTAL
|
ピボット値を、列の合計値に対する割合として表示します。 |
PERCENT_OF_GRAND_TOTAL
|
合計値に対するピボット値の割合が表示されます。 |
PivotValueLayout
ピボット値のレイアウト。
列挙型 | |
---|---|
HORIZONTAL
|
値は横方向に(列として)配置されます。 |
VERTICAL
|
値は縦方向(行として)に配置されます。 |