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)

Pengelompokan setiap kolom di 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 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.

Keduanya criteria dan filterSpecs akan diisikan dalam jawaban. Jika kedua kolom ditentukan dalam permintaan update, kolom ini akan diprioritaskan.

values[]

object (PivotValue)

Daftar nilai untuk 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 union source_data. Sumber data tabel pivot. source_data hanya dapat berupa salah satu dari hal berikut:
source

object (GridRange)

Rentang pembacaan data oleh tabel pivot.

dataSourceId

string

ID sumber data yang digunakan untuk membaca data tabel pivot.

PivotGroup

Pengelompokan tunggal (baris atau 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 nilai dalam grup ini harus diurutkan.

valueBucket

object (PivotGroupSortValueBucket)

Bucket grup pivot yang berlawanan untuk diurutkan. Jika tidak ditentukan, pengurutan akan dilakukan menurut abjad dari 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 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 {i>header<i} 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 union 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 pengguna 0 berarti kelompok ini mengacu pada 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

True jika data yang sesuai dengan nilai diciutkan.

PivotGroupSortValueBucket

Informasi tentang nilai mana dalam grup pivot yang harus digunakan untuk mengurutkan.

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

integer

Offset pada PivotTable.values daftar dari nilai mana dalam pengelompokan ini yang harus diurutkan.

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, ini akan menunjukkan bahwa baris harus diurutkan sesuai dengan "Total Keseluruhan" pada grup kolom. Jika satu nilai tercantum, ini akan sesuai dengan penggunaan "Total" dari 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)

J ManualRule.

histogramRule

object (HistogramRule)

J 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 berdasarkan 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 harus memiliki nama grup yang unik.

items[]

object (ExtendedValue)

Item dalam data sumber yang harus dimasukkan ke dalam grup ini. Setiap item dapat berupa string, angka, atau boolean. Item dapat muncul paling banyak di satu grup dalam satu grup ManualRule. Item yang tidak muncul di grup mana pun akan muncul dengan sendirinya.

HistogramRule

Memungkinkan Anda mengatur nilai numerik dalam 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 berdasarkan 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-waktu yang akan diterapkan.

DateTimeRuleType

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

Enum
DATE_TIME_RULE_TYPE_UNSPECIFIED Jenis default, jangan gunakan.
SECOND Kelompokkan tanggal menurut detik, dari 0 hingga 59.
MINUTE Kelompokkan tanggal berdasarkan menit, dari 0 hingga 59.
HOUR Kelompokkan tanggal berdasarkan jam menggunakan sistem 24 jam, dari 0 hingga 23.
HOUR_MINUTE Kelompokkan tanggal menurut jam dan menit menggunakan sistem 24 jam, misalnya 19.45.
HOUR_MINUTE_AMPM Kelompokkan tanggal menurut jam dan menit menggunakan sistem 12 jam, misalnya 19.45. Pengelompokan AM/PM diterjemahkan berdasarkan bahasa spreadsheet.
DAY_OF_WEEK Kelompokkan tanggal menurut hari, misalnya Minggu. Hari dalam seminggu akan diterjemahkan berdasarkan bahasa spreadsheet.
DAY_OF_YEAR Kelompokkan tanggal menurut hari, 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 Kelompokkan tanggal menurut hari, dari 1 hingga 31.
DAY_MONTH Kelompokkan tanggal menurut hari dan bulan, misalnya 22-Nov. Bulan ini diterjemahkan berdasarkan bahasa {i>spreadsheet<i}.
MONTH Kelompokkan tanggal menurut bulan, misalnya Nov. Bulan diterjemahkan berdasarkan bahasa spreadsheet.
QUARTER Kelompokkan tanggal berdasarkan kuartal, misalnya K1 (yang mewakili Jan-Mar).
YEAR Kelompokkan tanggal berdasarkan tahun, misalnya 2008.
YEAR_MONTH Kelompokkan tanggal menurut tahun dan bulan, misalnya 2008-Nov. Bulan ini diterjemahkan berdasarkan bahasa {i>spreadsheet<i}.
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, guna menyesuaikan sepenuhnya pesanan yang diterapkan, semua batas grup pivot harus menetapkan kolom ini dengan nomor unik. Jika tidak, urutan ditentukan oleh indeks di PivotTable.rows lalu daftar PivotTable.columns daftar.

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 menimpanya -- bahkan jika suatu nilai tercantum di sana, ia tetap disembunyikan jika tidak memenuhi kondisi.)

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

Data sumber tabel pivot dapat dirujuk oleh nama header kolom. Misalnya, jika data sumber memiliki kolom bernama "Pendapatan" dan "Biaya" dan kondisi diterapkan ke "Pendapatan" kolom dengan jenis NUMBER_GREATER dan nilai =Cost, maka hanya kolom dengan "Pendapatan" &gt; "Biaya" disertakan.

visibleByDefault

boolean

Apakah nilai terlihat secara default. Jika benar, visibleValues 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 union 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 bagaimana nilai dalam tabel pivot harus dihitung.

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 computeDisplayType ditentukan sebagai PERCENT_OF_GRAND_TOTAL, semua nilai pivot ditampilkan sebagai persentase total keseluruhan. 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 pengguna 0 berarti nilai ini mengacu pada 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 tempat nilai ini dibaca.

PivotValueSummarizeFunction

Fungsi untuk meringkas nilai pivot.

Enum
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED Defaultnya, jangan digunakan.
SUM Sesuai dengan SUM fungsi tersebut.
COUNTA Sesuai dengan COUNTA fungsi tersebut.
COUNT Sesuai dengan COUNT fungsi tersebut.
COUNTUNIQUE Sesuai dengan COUNTUNIQUE fungsi tersebut.
AVERAGE Sesuai dengan AVERAGE fungsi tersebut.
MAX Sesuai dengan MAX fungsi tersebut.
MIN Sesuai dengan MIN fungsi tersebut.
MEDIAN Sesuai dengan MEDIAN fungsi tersebut.
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 Sesuai dengan VARP fungsi tersebut.
CUSTOM Menunjukkan bahwa formula harus digunakan apa adanya. Hanya berlaku jika PivotValue.formula sudah disetel.
NONE Menunjukkan bahwa nilai sudah diringkas, dan fungsi ringkasan tidak ditentukan secara eksplisit. Digunakan untuk tabel pivot sumber data Looker tempat nilai sudah diringkas.

PivotValueCalculatedDisplayType

Cara yang memungkinkan penghitungan nilai pivot untuk tampilan.

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 nilai total keseluruhan.

PivotValueLayout

Tata letak nilai pivot.

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