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)

Setiap pengelompokan baris di tabel pivot.

object (PivotGroup)

Setiap pengelompokan kolom dalam tabel pivot.

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 untuk 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.

criteria dan filterSpecs akan diisi dalam respons. Jika kedua kolom 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 vertikal (sebagai baris).

object (DataExecutionStatus)

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

object (GridRange)

Rentang tabel pivot membaca data.

string

ID sumber data yang datanya dibaca 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 berlawanan yang akan diurutkan. Jika tidak ditentukan, pengurutan dilakukan secara alfabetis berdasarkan nilai grup ini.

boolean

Benar 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 yang sama pada tingkat yang lebih tinggi. Misalnya, meskipun baris ketiga di bawah sesuai dengan "Q1 Mar", "Q1" tidak ditampilkan karena menjadi redundan dengan baris sebelumnya. Menetapkan repeatHeadings ke true akan menyebabkan "Q1" diulang untuk "Feb" dan "Mar".

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

string

Label yang 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 {i>header<i} ke tabel pivot yang ada, hapus tabel pivot yang ada dan kemudian 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 baris/grup kolom ini.

object (PivotGroupLimit)

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

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.

object (DataSourceColumnReference)

Referensi ke kolom sumber data yang menjadi dasar pengelompokan ini.

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

object (ExtendedValue)

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

boolean

True jika data yang sesuai dengan nilai diciutkan.

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

integer

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

object (ExtendedValue)

Menentukan bucket tempat nilai 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 di 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 berdasarkan "Jumlah Total" di atas grup kolom. Jika satu nilai tercantum, ini akan sesuai dengan penggunaan "Total" dari 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 tertentu 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 maksimal satu grup dalam ManualRule yang ditentukan. Item yang tidak muncul di grup mana pun akan muncul dengan sendirinya.

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

number

Ukuran bucket yang dibuat. Harus positif.

number

Nilai minimum untuk memasukkan item ke dalam bucket dengan ukuran konstan. Nilai di bawah awal disatukan menjadi satu bucket. Kolom ini bersifat opsional.

number

Nilai maksimum untuk item yang ditempatkan ke dalam bucket dengan ukuran konstan. Nilai di atas disatukan menjadi satu bucket. Kolom ini bersifat opsional.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

Jenis pengelompokan tanggal-waktu yang akan diterapkan.

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

integer

Batas jumlah.

integer

Urutan penerapan batas grup pada tabel pivot.

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

Untuk permintaan tulis, untuk sepenuhnya menyesuaikan urutan yang diterapkan, semua batas grup pivot harus menetapkan kolom ini dengan nomor unik. Jika tidak, urutan akan ditentukan oleh indeks dalam daftar PivotTable.rows, kemudian daftar PivotTable.columns.

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

string

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

object (BooleanCondition)

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

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

Data sumber tabel pivot dapat direferensikan 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 false, nilai yang ada di visibleValues dan 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 untuk 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 ditentukan sebagai PERCENT_OF_GRAND_TOTAL, semua nilai pivot ditampilkan sebagai persentase dari total keseluruhan. Di editor Sheets, ini disebut sebagai "Show As" di bagian nilai pada tabel pivot.

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.

string

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

object (DataSourceColumnReference)

Referensi ke kolom sumber data tempat nilai ini membaca.