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 opsional filter 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 dari 0 akan memiliki filter untuk kolom C, sedangkan kunci 1 untuk kolom D.

Kolom ini tidak digunakan lagi dan digantikan oleh filterSpecs.

filterSpecs[]

object (PivotFilterSpec)

Filter 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 yang digunakan untuk membaca data tabel pivot.

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

True jika tabel pivot harus menyertakan total untuk pengelompokan ini.

valueMetadata[]

object (PivotGroupValueMetadata)

Metadata tentang nilai dalam pengelompokan.

sortOrder

enum (SortOrder)

Urutan pengurutan nilai dalam grup ini.

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 yang sama pada tingkat yang lebih tinggi. Misalnya, meskipun baris ketiga di bawah sesuai dengan "K1 Mar", "Q1" tidak ditampilkan karena redundan dengan baris sebelumnya. Menyetel repeatHeadings ke true akan menyebabkan "Q1" untuk "Feb" yang akan ditampilkan 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 barisnya adalah Region (yang dapat diganti namanya menjadi State) dan label kolomnya adalah Product (yang bisa diganti namanya 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 baris/grup kolom ini.

groupLimit

object (PivotGroupLimit)

Batas jumlah pada 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 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 kalkulasi 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 dari nilai mana yang 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 di grup kolom kedua. Jika tidak ada nilai yang tercantum, hal 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 di PivotGroup yang menentukan bucket untuk nilai dalam kolom data sumber, bukan memisahkan setiap nilai. Hanya satu PivotGroup dengan aturan grup dapat ditambahkan untuk setiap kolom dalam data sumber, meskipun pada setiap kolom tertentu Anda dapat PivotGroup yang memiliki aturan dan PivotGroup sementara yang tidak.

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 union 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)

J DateTimeRule.

ManualRule

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

+-------+-------------------+
| 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 maksimal dalam satu grup dalam ManualRule tertentu. Item yang tidak muncul di grup mana pun akan muncul dengan sendirinya.

HistogramRule

Memungkinkan Anda mengatur nilai numerik di kolom data sumber ke dalam bucket dengan ukuran konstan. Semua nilai dari HistogramRule.start dapat HistogramRule.end ditempatkan ke dalam kelompok ukuran, HistogramRule.interval. Selain itu, semua nilai di bawah HistogramRule.start ditempatkan dalam satu kelompok, dan semua nilai di atas HistogramRule.end ditempatkan di resource lain. Hanya HistogramRule.interval diperlukan, meskipun jika HistogramRule.start dan HistogramRule.end disediakan, HistogramRule.start harus lebih kecil 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 ini dengan menerapkan aturan grup histogram dengan HistogramRule.start dari 25 pelanggan, HistogramRule.interval dari 20 orang, dan HistogramRule.end dari 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 tempat item ditempatkan ke dalam bucket berukuran konstan. Nilai di bawah awal digabungkan ke dalam satu bucket. Kolom ini bersifat opsional.

end

number

Nilai maksimum tempat item ditempatkan ke dalam bucket berukuran konstan. Nilai di atas akhir digabungkan ke dalam satu bucket. Kolom ini bersifat opsional.

DateTimeRule

Memungkinkan Anda mengatur nilai tanggal-waktu dalam kolom data sumber ke dalam bucket berdasarkan bagian yang dipilih dari nilai tanggal atau waktu. Misalnya, pertimbangkan tabel pivot yang menampilkan transaksi penjualan berdasarkan 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 dari YEAR_MONTH 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 Kelompokkan tanggal berdasarkan 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 Kelompokkan tanggal menurut hari, 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 jatuh dalam kelompok yang berbeda di tahun kabisat daripada 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 Kelompokkan tanggal menurut bulan, misalnya Nov. Bulan diterjemahkan berdasarkan bahasa 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 Kelompokkan tanggal berdasarkan tahun dan kuartal, misalnya K4 2008.
YEAR_MONTH_DAY Kelompokkan tanggal berdasarkan tahun, bulan, dan hari, misalnya 22-11-2008.

PivotGroupLimit

Batas jumlah pada 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 jumlah urut yang lebih rendah ke yang lebih tinggi. Nomor pesanan dinormalisasi menjadi bilangan bulat berurutan dari 0.

Untuk permintaan tulis, agar dapat sepenuhnya menyesuaikan urutan penerapan, semua batas grup pivot harus memiliki kolom ini yang ditetapkan dengan angka 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 ke bawah 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 dapat dilihat secara default. Jika benar, visibleValues akan diabaikan, semua nilai yang memenuhi condition (jika ditentukan) akan ditampilkan. Jika salah, nilai yang keduanya dalam visibleValues dan bertemu condition 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 sudah diatur, maka CUSTOM tidak didukung.

name

string

Nama yang akan digunakan untuk nilai.

calculatedDisplayType

enum (PivotValueCalculatedDisplayType)

Jika ditentukan, menunjukkan bahwa nilai pivot harus ditampilkan sebagai hasil kalkulasi 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, opsi ini disebut sebagai "Tampilkan Sebagai" di bagian nilai dari tabel pivot.

Kolom union 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 rentang sumber tempat nilai ini dibaca.

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 Defaultnya, jangan digunakan.
SUM Sesuai dengan SUM fungsi tersebut.
COUNTA Berhubungan dengan fungsi COUNTA.
COUNT Sesuai dengan COUNT fungsi tersebut.
COUNTUNIQUE Sesuai dengan COUNTUNIQUE fungsi tersebut.
AVERAGE Sesuai dengan AVERAGE fungsi tersebut.
MAX Berhubungan dengan fungsi MAX.
MIN Berhubungan dengan fungsi MIN.
MEDIAN Berhubungan dengan fungsi MEDIAN.
PRODUCT Sesuai dengan PRODUCT fungsi tersebut.
STDEV Sesuai dengan STDEV fungsi tersebut.
STDEVP Sesuai dengan STDEVP fungsi tersebut.
VAR Sesuai dengan VAR fungsi tersebut.
VARP Berhubungan dengan fungsi VARP.
CUSTOM Menunjukkan bahwa formula harus digunakan apa adanya. Hanya berlaku jika PivotValue.formula sudah diatur.
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 digunakan.
PERCENT_OF_ROW_TOTAL Menampilkan nilai pivot sebagai persentase nilai total baris.
PERCENT_OF_COLUMN_TOTAL Menampilkan nilai pivot sebagai persentase 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 ditata secara vertikal (sebagai baris).