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 dalam tabel pivot.

object (PivotGroup)

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

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.

object (PivotValue)

Daftar nilai untuk 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 pembacaan data oleh tabel pivot.

string

ID sumber data yang digunakan untuk membaca data 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

True 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 diurutkan. Jika tidak ditentukan, pengurutan akan dilakukan menurut abjad dari nilai grup ini.

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

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

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 pengguna 0 berarti kelompok ini mengacu pada 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 kalkulasi yang sesuai dengan metadata. (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 pada PivotTable.values daftar dari nilai mana dalam pengelompokan ini yang harus diurutkan.

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.

{

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

J ManualRule.

object (HistogramRule)

J HistogramRule.

object (DateTimeRule)

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

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.

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

number

Ukuran bucket yang dibuat. Harus positif.

number

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

number

Nilai maksimum tempat item ditempatkan ke dalam bucket berukuran konstan. Nilai di atas akhir digabungkan ke dalam 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 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.

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

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.

{
  "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 sudah diatur, maka CUSTOM tidak didukung.

string

Nama yang akan digunakan untuk nilai.

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.

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.

string

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

object (DataSourceColumnReference)

Referensi ke kolom sumber data tempat nilai ini dibaca.