Pivot Tables

PivotTable

Tabel pivot.

Representasi JSON 
{
  "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.
}
Kolom
rows[]

object (PivotGroup)

Setiap pengelompokan baris dalam tabel pivot.

columns[]

object (PivotGroup)

Setiap pengelompokan kolom dalam tabel pivot.

criteria
(deprecated)

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

Pemetaan filter opsional per offset kolom sumber.

Filter diterapkan sebelum menggabungkan data ke dalam tabel pivot. Kunci peta adalah offset kolom dari rentang sumber yang ingin Anda filter, dan nilainya adalah kriteria untuk kolom tersebut.

Misalnya, jika sumbernya adalah C10:E15, kunci 0 akan memiliki filter untuk kolom C, sedangkan kunci 1 adalah untuk kolom D.

Kolom ini tidak digunakan lagi dan diganti dengan filterSpecs.

filterSpecs[]

object (PivotFilterSpec)

Filter yang diterapkan ke kolom sumber sebelum menggabungkan data untuk tabel pivot.

criteria dan filterSpecs diisi dalam respons. Jika kedua kolom ditentukan dalam permintaan pembaruan, kolom ini akan diprioritaskan.

values[]

object (PivotValue)

Daftar nilai yang akan disertakan dalam tabel pivot.

valueLayout

enum (PivotValueLayout)

Apakah nilai harus dicantumkan secara horizontal (sebagai kolom) atau vertikal (sebagai baris).

dataExecutionStatus

object (DataExecutionStatus)

Hanya output. Status eksekusi data untuk tabel pivot sumber data.

Kolom gabungan source_data. Sumber data tabel pivot. source_data hanya dapat berupa salah satu dari hal berikut:
source

object (GridRange)

Rentang tempat tabel pivot membaca data.

dataSourceId

string

ID sumber data tempat tabel pivot membaca data.

PivotGroup

Satu pengelompokan (baik baris maupun kolom) dalam tabel pivot.

Representasi JSON 
{
  "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.
}
Kolom
showTotals

boolean

Benar jika tabel pivot harus menyertakan total untuk pengelompokan ini.

valueMetadata[]

object (PivotGroupValueMetadata)

Metadata tentang nilai dalam pengelompokan.

sortOrder

enum (SortOrder)

Urutan nilai dalam grup ini harus diurutkan.

valueBucket

object (PivotGroupSortValueBucket)

Bucket grup pivot yang berlawanan yang akan diurutkan. Jika tidak ditentukan, pengurutan akan dilakukan secara alfabet berdasarkan nilai grup ini.

repeatHeadings

boolean

True jika judul dalam grup pivot ini harus diulang. Ini hanya berlaku untuk pengelompokan baris dan diabaikan oleh kolom.

Secara default, kami meminimalkan pengulangan judul dengan tidak menampilkan judul tingkat yang lebih tinggi jika judul tersebut sama. Misalnya, meskipun baris ketiga di bawah sesuai dengan "K1 Mar", "K1" tidak ditampilkan karena redundan dengan baris sebelumnya. Menetapkan repeatHeadings ke true akan menyebabkan "K1" diulang untuk "Feb" dan "Mar". 

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

string

Label yang akan digunakan untuk grup baris/kolom yang dapat disesuaikan. Misalnya, dalam tabel pivot berikut, label baris adalah Region (yang dapat diganti namanya menjadi State) dan label kolom adalah Product (yang dapat diganti namanya menjadi Item). Tabel pivot yang dibuat sebelum Desember 2017 tidak memiliki label header. Jika Anda ingin menambahkan label header ke tabel pivot yang ada, hapus tabel pivot yang ada, lalu buat tabel pivot baru dengan parameter yang sama. 

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

object (PivotGroupRule)

Aturan grup yang akan diterapkan ke grup baris/kolom ini.

groupLimit

object (PivotGroupLimit)

Batas jumlah baris atau kolom yang akan diterapkan ke grup pivot ini.

Kolom gabungan source. Sumber data grup pivot. source hanya dapat berupa salah satu dari hal berikut:
sourceColumnOffset

integer

Offset kolom dari rentang sumber yang menjadi dasar pengelompokan ini.

Misalnya, jika sumbernya adalah C10:E15, sourceColumnOffset dari 0 berarti grup ini merujuk ke kolom C, sedangkan offset 1 akan merujuk ke kolom D.

dataSourceColumnReference

object (DataSourceColumnReference)

Referensi ke kolom sumber data yang menjadi dasar pengelompokan ini.

PivotGroupValueMetadata

Metadata tentang nilai dalam pengelompokan pivot.

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

object (ExtendedValue)

Nilai yang dihitung yang sesuai dengan metadata. (Perhatikan bahwa formulaValue tidak valid, karena nilainya akan dihitung.)

collapsed

boolean

Benar jika data yang sesuai dengan nilai diciutkan.

PivotGroupSortValueBucket

Informasi tentang nilai dalam grup pivot yang harus digunakan untuk pengurutan.

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

integer

Offset dalam daftar PivotTable.values yang akan digunakan untuk mengurutkan nilai dalam pengelompokan ini.

buckets[]

object (ExtendedValue)

Menentukan bucket tempat nilai dipilih untuk diurutkan.

Misalnya, dalam tabel pivot dengan satu grup baris & dua grup kolom, grup baris dapat mencantumkan hingga dua nilai. Nilai pertama sesuai dengan nilai dalam grup kolom pertama, dan nilai kedua sesuai dengan nilai dalam grup kolom kedua. Jika tidak ada nilai yang tercantum, ini akan menunjukkan bahwa baris harus diurutkan sesuai dengan "Total Umum" di seluruh grup kolom. Jika satu nilai tercantum, hal ini akan sesuai dengan penggunaan "Total" bucket tersebut.

PivotGroupRule

Setelan opsional pada PivotGroup yang menentukan bucket untuk nilai dalam kolom data sumber, bukan mengelompokkan setiap nilai. Hanya satu PivotGroup dengan aturan grup yang dapat ditambahkan untuk setiap kolom dalam data sumber, meskipun pada kolom tertentu, Anda dapat menambahkan PivotGroup yang memiliki aturan dan PivotGroup yang tidak memiliki aturan.

Representasi JSON 
{

  // 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.
}
Kolom
Kolom gabungan rule. Aturan yang akan diterapkan ke PivotGroup. rule hanya dapat berupa salah satu dari hal berikut:
manualRule

object (ManualRule)

ManualRule.

histogramRule

object (HistogramRule)

HistogramRule.

dateTimeRule

object (DateTimeRule)

DateTimeRule.

ManualRule

Memungkinkan Anda mengatur nilai di kolom data sumber secara manual ke dalam bucket dengan nama pilihan Anda. Misalnya, tabel pivot yang menggabungkan populasi menurut negara bagian: 

+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK    |               0.7 |
| AL    |               4.8 |
| AR    |               2.9 |
...
+-------+-------------------+

dapat diubah menjadi tabel pivot yang menggabungkan populasi menurut zona waktu dengan memberikan daftar grup (misalnya, groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) ke aturan grup manual. Perhatikan bahwa efek serupa dapat dicapai dengan menambahkan kolom zona waktu ke data sumber dan menyesuaikan tabel pivot. 

+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central   |             106.3 |
| Eastern   |             151.9 |
| Mountain  |              17.4 |
...
+-----------+-------------------+
Representasi JSON 
{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}
Kolom
groups[]

object (ManualRuleGroup)

Daftar nama grup dan item yang sesuai dari data sumber yang dipetakan ke setiap nama grup.

ManualRuleGroup

Nama grup dan daftar item dari data sumber yang harus ditempatkan dalam grup dengan nama ini.

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

object (ExtendedValue)

Nama grup, yang harus berupa string. Setiap grup dalam ManualRule tertentu harus memiliki nama grup yang unik.

items[]

object (ExtendedValue)

Item dalam data sumber yang harus ditempatkan ke dalam grup ini. Setiap item dapat berupa string, angka, atau boolean. Item dapat muncul di maksimal satu grup dalam ManualRule tertentu. Item yang tidak muncul di grup mana pun akan muncul sendiri.

HistogramRule

Memungkinkan Anda mengatur nilai numerik di kolom data sumber ke dalam bucket dengan ukuran konstan. Semua nilai dari HistogramRule.start hingga HistogramRule.end ditempatkan ke dalam grup berukuran HistogramRule.interval. Selain itu, semua nilai di bawah HistogramRule.start ditempatkan dalam satu grup, dan semua nilai di atas HistogramRule.end ditempatkan dalam grup lain. Hanya HistogramRule.interval yang diperlukan, meskipun jika HistogramRule.start dan HistogramRule.end diberikan, HistogramRule.start harus kurang dari HistogramRule.end. Misalnya, tabel pivot yang menampilkan jumlah pembelian rata-rata menurut usia yang memiliki lebih dari 50 baris: 

+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16  |            $27.13 |
| 17  |             $5.24 |
| 18  |            $20.15 |
...
+-----+-------------------+

dapat diubah menjadi tabel pivot yang terlihat seperti di bawah dengan menerapkan aturan grup histogram dengan HistogramRule.start 25, HistogramRule.interval 20, dan 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 |
+-------------+-------------------+
Representasi JSON 
{
  "interval": number,
  "start": number,
  "end": number
}
Kolom
interval

number

Ukuran bucket yang dibuat. Harus positif.

start

number

Nilai minimum saat item ditempatkan ke bucket dengan ukuran konstan. Nilai di bawah awal digabungkan ke dalam satu bucket. Kolom ini bersifat opsional.

end

number

Nilai maksimum saat item ditempatkan ke bucket dengan ukuran konstan. Nilai di atas akhir digabungkan ke dalam satu bucket. Kolom ini bersifat opsional.

DateTimeRule

Memungkinkan Anda mengatur nilai tanggal-waktu di kolom data sumber ke dalam bucket berdasarkan bagian yang dipilih dari nilai tanggal atau waktunya. Misalnya, pertimbangkan tabel pivot yang menampilkan transaksi penjualan menurut tanggal: 

+----------+--------------+
| Date     | SUM of Sales |
+----------+--------------+
| 1/1/2017 |      $621.14 |
| 2/3/2017 |      $708.84 |
| 5/8/2017 |      $326.84 |
...
+----------+--------------+

Menerapkan aturan grup tanggal-waktu dengan DateTimeRuleType YEAR_MONTH akan menghasilkan tabel pivot berikut. 

+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan     |   $53,731.78 |
| 2017-Feb     |   $83,475.32 |
| 2017-Mar     |   $94,385.05 |
...
+--------------+--------------+
Representasi JSON 
{
  "type": enum (DateTimeRuleType)
}
Kolom
type

enum (DateTimeRuleType)

Jenis pengelompokan tanggal dan waktu yang akan diterapkan.

DateTimeRuleType

Jenis aturan pengelompokan tanggal dan waktu yang tersedia. Dokumentasi ini mengasumsikan bahwa lokalitas spreadsheet adalah "en-US", meskipun rendering tanggal dan waktu yang sebenarnya menggunakan lokalitas spreadsheet untuk beberapa jenis aturan.

Enum
DATE_TIME_RULE_TYPE_UNSPECIFIED Jenis default, jangan gunakan.
SECOND Mengelompokkan tanggal menurut detik, dari 0 hingga 59.
MINUTE Mengelompokkan tanggal menurut menit, dari 0 hingga 59.
HOUR Mengelompokkan tanggal menurut jam menggunakan sistem 24 jam, dari 0 hingga 23.
HOUR_MINUTE Mengelompokkan tanggal menurut jam dan menit menggunakan sistem 24 jam, misalnya 19.45.
HOUR_MINUTE_AMPM Mengelompokkan tanggal menurut jam dan menit menggunakan sistem 12 jam, misalnya 19.45. Penunjukan AM/PM diterjemahkan berdasarkan lokalitas spreadsheet.
DAY_OF_WEEK Mengelompokkan tanggal menurut hari dalam seminggu, misalnya Minggu. Hari dalam seminggu akan diterjemahkan berdasarkan lokalitas spreadsheet.
DAY_OF_YEAR Mengelompokkan tanggal menurut hari dalam setahun, dari 1 hingga 366. Perhatikan bahwa tanggal setelah 29 Februari berada dalam bucket yang berbeda pada tahun kabisat dibandingkan dengan tahun non-kabisat.
DAY_OF_MONTH Mengelompokkan tanggal berdasarkan hari dalam sebulan, dari 1 hingga 31.
DAY_MONTH Mengelompokkan tanggal berdasarkan hari dan bulan, misalnya 22-Nov. Bulan diterjemahkan berdasarkan lokalitas spreadsheet.
MONTH Mengelompokkan tanggal menurut bulan, misalnya Nov. Bulan diterjemahkan berdasarkan lokalitas spreadsheet.
QUARTER Mengelompokkan tanggal menurut kuartal, misalnya K1 (yang mewakili Jan-Mar).
YEAR Mengelompokkan tanggal berdasarkan tahun, misalnya 2008.
YEAR_MONTH Mengelompokkan tanggal berdasarkan tahun dan bulan, misalnya 2008-Nov. Bulan diterjemahkan berdasarkan lokalitas spreadsheet.
YEAR_QUARTER Mengelompokkan tanggal menurut tahun dan kuartal, misalnya K4 2008.
YEAR_MONTH_DAY Mengelompokkan tanggal menurut tahun, bulan, dan hari, misalnya 22-11-2008.

PivotGroupLimit

Batas jumlah baris atau kolom dalam grup pivot.

Representasi JSON 
{
  "countLimit": integer,
  "applyOrder": integer
}
Kolom
countLimit

integer

Batas jumlah.

applyOrder

integer

Urutan penerapan batas grup ke tabel pivot.

Batas grup pivot diterapkan dari nomor urutan yang lebih rendah ke yang lebih tinggi. Nomor urutan dinormalisasi menjadi bilangan bulat berurutan dari 0.

Untuk permintaan tulis, agar dapat menyesuaikan urutan penerapan sepenuhnya, semua batas grup pivot harus menetapkan kolom ini dengan nomor unik. Jika tidak, urutan ditentukan oleh indeks dalam daftar PivotTable.rows, lalu daftar PivotTable.columns.

PivotFilterCriteria

Kriteria untuk menampilkan/menyembunyikan baris dalam tabel pivot.

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

string

Nilai yang harus disertakan. Nilai yang tidak tercantum di sini akan dikecualikan.

condition

object (BooleanCondition)

Kondisi yang harus benar agar nilai ditampilkan. ( visibleValues tidak menggantinya -- meskipun nilai tercantum di sana, nilai tersebut masih disembunyikan jika tidak memenuhi kondisi.)

Nilai kondisi yang merujuk ke rentang dalam notasi A1 dievaluasi relatif terhadap sheet tabel pivot. Referensi diperlakukan secara mutlak, sehingga tidak diisi di tabel pivot. Misalnya, nilai kondisi =A1 di "Pivot Table 1" diperlakukan sebagai 'Pivot Table 1'!$A$1.

Data sumber tabel pivot dapat direferensikan berdasarkan nama header kolom. Misalnya, jika data sumber memiliki kolom bernama "Pendapatan" dan "Biaya" dan kondisi diterapkan ke kolom "Pendapatan" dengan jenis NUMBER_GREATER dan nilai =Cost, maka hanya kolom yang berisi "Pendapatan" > "Biaya" yang disertakan.

visibleByDefault

boolean

Apakah nilai terlihat secara default. Jika benar, visibleValues akan diabaikan, semua nilai yang memenuhi condition (jika ditentukan) akan ditampilkan. Jika salah, nilai yang ada di visibleValues dan memenuhi condition akan ditampilkan.

PivotFilterSpec

Kriteria filter tabel pivot yang terkait dengan offset kolom sumber tertentu.

Representasi JSON 
{
  "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.
}
Kolom
filterCriteria

object (PivotFilterCriteria)

Kriteria untuk kolom.

Kolom gabungan source. Kolom sumber tempat filter ini diterapkan. source hanya dapat berupa salah satu dari hal berikut:
columnOffsetIndex

integer

Offset kolom berbasis nol dari rentang sumber.

dataSourceColumnReference

object (DataSourceColumnReference)

Referensi ke kolom sumber data.

PivotValue

Definisi cara menghitung nilai dalam tabel pivot.

Representasi JSON 
{
  "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.
}
Kolom
summarizeFunction

enum (PivotValueSummarizeFunction)

Fungsi untuk meringkas nilai. Jika formula ditetapkan, satu-satunya nilai yang didukung adalah SUM dan CUSTOM. Jika sourceColumnOffset ditetapkan, CUSTOM tidak didukung.

name

string

Nama yang akan digunakan untuk nilai.

calculatedDisplayType

enum (PivotValueCalculatedDisplayType)

Jika ditentukan, menunjukkan bahwa nilai pivot harus ditampilkan sebagai hasil penghitungan dengan nilai pivot lain. Misalnya, jika calculatedDisplayType ditentukan sebagai PERCENT_OF_GRAND_TOTAL, semua nilai pivot akan ditampilkan sebagai persentase dari total gabungan. Di editor Spreadsheet, ini disebut sebagai "Tampilkan Sebagai" di bagian nilai tabel pivot.

Kolom gabungan value. Data yang akan digunakan untuk nilai dalam tabel pivot. Hanya satu nilai yang harus ditetapkan. value hanya dapat berupa salah satu dari hal berikut:
sourceColumnOffset

integer

Offset kolom dari rentang sumber yang dibaca oleh nilai ini.

Misalnya, jika sumbernya adalah C10:E15, sourceColumnOffset dari 0 berarti nilai ini merujuk ke kolom C, sedangkan offset 1 akan merujuk ke kolom D.

formula

string

Formula kustom untuk menghitung nilai. Formula harus diawali dengan karakter =.

dataSourceColumnReference

object (DataSourceColumnReference)

Referensi ke kolom sumber data yang dibaca oleh nilai ini.

PivotValueSummarizeFunction

Fungsi untuk meringkas nilai pivot.

Enum
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED Default, jangan gunakan.
SUM Berhubungan dengan fungsi SUM.
COUNTA Berhubungan dengan fungsi COUNTA.
COUNT Berhubungan dengan fungsi COUNT.
COUNTUNIQUE Berhubungan dengan fungsi COUNTUNIQUE.
AVERAGE Berhubungan dengan fungsi AVERAGE.
MAX Berhubungan dengan fungsi MAX.
MIN Berhubungan dengan fungsi MIN.
MEDIAN Berhubungan dengan fungsi MEDIAN.
PRODUCT Berhubungan dengan fungsi PRODUCT.
STDEV Berhubungan dengan fungsi STDEV.
STDEVP Berhubungan dengan fungsi STDEVP.
VAR Berhubungan dengan fungsi VAR.
VARP Berhubungan dengan fungsi VARP.
CUSTOM Menunjukkan bahwa formula harus digunakan apa adanya. Hanya berlaku jika PivotValue.formula ditetapkan.
NONE Menunjukkan bahwa nilai sudah diringkas, dan fungsi ringkasan tidak ditentukan secara eksplisit. Digunakan untuk tabel pivot sumber data Looker dengan nilai yang sudah diringkas.

PivotValueCalculatedDisplayType

Kemungkinan cara nilai pivot dihitung untuk ditampilkan.

Enum
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED Nilai default, jangan gunakan.
PERCENT_OF_ROW_TOTAL Menampilkan nilai pivot sebagai persentase dari nilai total baris.
PERCENT_OF_COLUMN_TOTAL Menampilkan nilai pivot sebagai persentase dari nilai total kolom.
PERCENT_OF_GRAND_TOTAL Menampilkan nilai pivot sebagai persentase dari nilai total gabungan.

PivotValueLayout

Tata letak nilai pivot.

Enum
HORIZONTAL Nilai disusun secara horizontal (sebagai kolom).
VERTICAL Nilai disusun secara vertikal (sebagai baris).