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)

Pengelompokan setiap baris dalam tabel pivot.

object (PivotGroup)

Pengelompokan setiap kolom dalam tabel pivot.

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

Pemetaan opsional untuk filter per offset kolom sumber.

Filter diterapkan sebelum menggabungkan data ke 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 digantikan dengan filterSpecs.

object (PivotFilterSpec)

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

Baik criteria maupun filterSpecs diisi sebagai respons. Jika kedua kolom tersebut ditentukan dalam permintaan pembaruan, kolom ini akan diprioritaskan.

object (PivotValue)

Daftar nilai yang akan disertakan dalam tabel pivot.

enum (PivotValueLayout)

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

object (DataExecutionStatus)

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

object (GridRange)

Rentang yang digunakan tabel pivot untuk membaca data.

string

ID sumber data yang digunakan oleh tabel pivot.

{
  "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

Benar jika tabel pivot harus menyertakan total untuk pengelompokan ini.

object (PivotGroupValueMetadata)

Metadata tentang nilai dalam pengelompokan.

enum (SortOrder)

Urutan nilai dalam grup ini harus diurutkan.

object (PivotGroupSortValueBucket)

Bucket grup pivot yang berlawanan untuk mengurutkannya. Jika tidak ditentukan, pengurutan diurutkan berdasarkan abjad pada nilai grup ini.

boolean

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

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

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

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 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 |
+--------------+---------+-------+

object (PivotGroupRule)

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

object (PivotGroupLimit)

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

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.

object (DataSourceColumnReference)

Referensi pada kolom sumber data yang menjadi dasar pengelompokan ini.

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

object (ExtendedValue)

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

boolean

True jika data yang sesuai dengan nilai diciutkan.

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

integer

Offset dalam daftar PivotTable.values yang menentukan nilai dalam pengelompokan ini.

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 di grup kolom pertama, dan nilai kedua sesuai dengan nilai di grup kolom kedua. Jika tidak ada nilai yang tercantum, hal ini menunjukkan bahwa baris harus diurutkan menurut "Grand Total" selama grup kolom. Jika satu nilai tercantum, ini sama dengan menggunakan "Total" bucket tersebut.

{

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

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

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

object (ExtendedValue)

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

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 maksimum satu grup dalam ManualRule yang ditentukan. Item yang tidak muncul di grup mana pun akan muncul sendiri.

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

number

Ukuran bucket yang dibuat. Harus positif.

number

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

number

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

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

Jenis pengelompokan tanggal dan waktu yang akan diterapkan.

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

integer

Batas jumlah.

integer

Urutan batas grup diterapkan ke tabel pivot.

Batas grup pivot diterapkan dari nomor pesanan yang lebih rendah ke yang lebih tinggi. Nomor pesanan dinormalkan ke bilangan bulat berurutan dari 0.

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

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

string

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

object (BooleanCondition)

Kondisi yang harus bernilai benar agar nilai dapat ditampilkan. ( visibleValues tidak mengganti nilai ini -- meskipun nilai tercantum di sana, nilai tersebut tetap disembunyikan jika tidak memenuhi kondisi.)

Nilai kondisi yang merujuk ke rentang dalam notasi A1 dievaluasi sesuai dengan sheet tabel pivot. Referensi diperlakukan mutlak, sehingga tidak diisi pada 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 kolom "Pendapatan" dengan jenis NUMBER_GREATER dan nilai =Cost, hanya kolom yang menyertakan "Pendapatan" > "Biaya".

boolean

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

{
  "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)

Kriteria untuk kolom.

integer

Offset kolom berbasis nol dari rentang sumber.

object (DataSourceColumnReference)

Referensi ke kolom sumber data.

{
  "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)

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

string

Nama yang akan digunakan untuk nilai.

enum (PivotValueCalculatedDisplayType)

Jika ditentukan, menunjukkan bahwa nilai pivot harus ditampilkan sebagai hasil penghitungan dengan nilai pivot lainnya. Misalnya, jika calculateDisplayType ditetapkan sebagai PERCENT_OF_GRAND_TOTAL, semua nilai pivot akan ditampilkan sebagai persentase total keseluruhan. Di editor Spreadsheet, ini disebut sebagai “Tampilkan Sebagai” di bagian nilai tabel pivot.

integer

Offset kolom dari rentang sumber yang dibaca 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.

string

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

object (DataSourceColumnReference)

Referensi ke kolom sumber data yang nilai ini dibaca.