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)

การจัดกลุ่มแถวแต่ละแถวในตาราง Pivot

object (PivotGroup)

การจัดกลุ่มคอลัมน์แต่ละรายการในตาราง Pivot

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

การแมปตัวกรองที่เป็นตัวเลือกต่อออฟเซ็ตคอลัมน์แหล่งที่มา

ระบบจะใช้ตัวกรองก่อนที่จะรวมข้อมูลลงในตาราง Pivot คีย์ของแผนที่คือออฟเซ็ตคอลัมน์ของช่วงต้นทางที่คุณต้องการกรอง และค่าจะเป็นเกณฑ์ของคอลัมน์นั้น

เช่น หากต้นทางคือ C10:E15 คีย์ของ 0 จะมีตัวกรองสําหรับคอลัมน์ C ส่วนคีย์ 1 มีไว้สําหรับคอลัมน์ D

ช่องนี้จะเลิกใช้งานเพื่อใช้ filterSpecs แทน

object (PivotFilterSpec)

ตัวกรองที่ใช้กับคอลัมน์แหล่งที่มาก่อนรวมข้อมูลสําหรับตาราง Pivot

ทั้ง criteria และ filterSpecs จะเติมข้อมูลในคําตอบ หากมีการระบุทั้ง 2 ช่องในคําขอการอัปเดต ช่องนี้จะมีความสําคัญเหนือกว่า

object (PivotValue)

รายการค่าที่จะรวมในตาราง Pivot

enum (PivotValueLayout)

ควรแสดงค่าแนวนอน (เป็นคอลัมน์) หรือแนวตั้ง (เป็นแถว)

object (DataExecutionStatus)

เอาต์พุตเท่านั้น สถานะการประมวลผลข้อมูลสําหรับตาราง Pivot ของแหล่งข้อมูล

object (GridRange)

ช่วงที่ตาราง Pivot อ่านข้อมูล

string

รหัสของแหล่งข้อมูลที่ตาราง 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

เป็นจริงถ้าตาราง Pivot ควรมียอดรวมสําหรับการจัดกลุ่มนี้

object (PivotGroupValueMetadata)

ข้อมูลเมตาเกี่ยวกับค่าในการจัดกลุ่ม

enum (SortOrder)

ควรจัดเรียงค่าในกลุ่มนี้

object (PivotGroupSortValueBucket)

ที่เก็บข้อมูลของกลุ่ม Pivot ตรงข้าม เพื่อจัดเรียงตาม ถ้าไม่ได้ระบุ การจัดเรียงจะเรียงลําดับตามค่าของกลุ่มนี้

boolean

เป็นจริงถ้าส่วนหัวในกลุ่ม Pivot นี้ซ้ํา ค่านี้ใช้ได้กับการจัดกลุ่มแถวเท่านั้นและละเว้นโดยคอลัมน์

โดยค่าเริ่มต้น เราจะลดการเกิดซ้ําของส่วนหัวให้น้อยที่สุดด้วยการไม่แสดงส่วนหัวระดับที่สูงกว่าในส่วนเดียวกัน ตัวอย่างเช่น แม้ว่าแถวที่ 3 ด้านล่างจะตรงกับ "Q1 Mar" แต่ "Q1" จะไม่แสดงขึ้นเนื่องจากมีแถวซ้ํากับแถวก่อนหน้า การตั้งค่าซ้ํา headheads เป็นจริงจะทําให้ "Q1" ซ้ํากับ "ก.พ." และ "มี.ค."

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

string

ป้ายกํากับที่จะใช้สําหรับกลุ่มแถว/คอลัมน์ที่สามารถปรับแต่งได้ เช่น ในตาราง Pivot ต่อไปนี้ ป้ายกํากับแถวคือ Region (ซึ่งสามารถเปลี่ยนชื่อเป็น State) และป้ายกํากับคอลัมน์คือ Product (ซึ่งสามารถเปลี่ยนชื่อได้ Item) ตาราง Pivot ที่สร้างขึ้นก่อนเดือนธันวาคม 2017 จะไม่มีป้ายกํากับส่วนหัว ถ้าคุณต้องการเพิ่มป้ายกํากับส่วนหัวในตาราง Pivot ที่มีอยู่ โปรดลบตาราง Pivot ที่มีอยู่ แล้วสร้างตาราง Pivot ใหม่ด้วยพารามิเตอร์เดิม

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+

object (PivotGroupRule)

กฎกลุ่มที่จะใช้กับกลุ่มแถว/คอลัมน์นี้

object (PivotGroupLimit)

ขีดจํากัดจํานวนแถวหรือคอลัมน์ที่จะใช้กับกลุ่ม Pivot นี้

integer

ออฟเซ็ตคอลัมน์ของช่วงต้นทางที่กลุ่มนี้อ้างอิง

เช่น หากต้นทางคือ C10:E15 sourceColumnOffset ของ 0 หมายความว่ากลุ่มนี้อ้างถึงคอลัมน์ C ส่วนออฟเซ็ต 1 จะอ้างถึงคอลัมน์ D

object (DataSourceColumnReference)

การอ้างอิงถึงคอลัมน์แหล่งข้อมูลที่กลุ่มนี้อ้างอิง

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

object (ExtendedValue)

ค่าที่คํานวณซึ่งข้อมูลเมตาสอดคล้องกัน (โปรดทราบว่า formulaValue ไม่ถูกต้อง เนื่องจากค่าจะได้รับการคํานวณ)

boolean

เป็นจริงหากข้อมูลที่ตรงกับค่าถูกยุบอยู่

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

integer

ค่าออฟเซ็ตในรายการ PivotTable.values ที่ควรจัดเรียงค่าในการจัดกลุ่มนี้

object (ExtendedValue)

กําหนดที่เก็บข้อมูลที่จะใช้เลือกจัดเรียงค่า

ตัวอย่างเช่น ในตาราง Pivot ที่มีกลุ่มแถว 1 กลุ่มและกลุ่มคอลัมน์ 2 กลุ่ม กลุ่มแถวจะแสดงค่าได้สูงสุด 2 ค่า ค่าแรกสอดคล้องกับค่าภายในกลุ่มคอลัมน์แรก และค่าที่สองสอดคล้องกับค่าในกลุ่มคอลัมน์ที่สอง หากไม่มีค่าแสดงอยู่ การดําเนินการนี้จะบ่งชี้ว่าควรจัดเรียงแถวตาม "ผลรวม" ในกลุ่มคอลัมน์ หากมีค่าเดียวแสดงอยู่ ค่านี้จะตรงกับการใช้ "Total" ของที่เก็บข้อมูลนั้น

{

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

รายชื่อกลุ่มและรายชื่อที่เกี่ยวข้องจากข้อมูลต้นฉบับที่จับคู่กับชื่อกลุ่มแต่ละกลุ่ม

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

object (ExtendedValue)

ชื่อกลุ่ม ซึ่งต้องเป็นสตริง แต่ละกลุ่มใน ManualRule ที่กําหนดต้องมีชื่อกลุ่มที่ไม่ซ้ํากัน

object (ExtendedValue)

รายการในข้อมูลต้นฉบับที่ควรวางไว้ในกลุ่มนี้ โดยแต่ละรายการอาจเป็นสตริง ตัวเลข หรือบูลีน รายการอาจปรากฏในกลุ่มมากที่สุดกลุ่มหนึ่งภายใน ManualRule กลุ่ม รายการที่ไม่ปรากฏในกลุ่มใดเลยจะปรากฏขึ้นด้วยตัวเอง

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

number

ขนาดของที่เก็บข้อมูลที่สร้างขึ้น ต้องเป็นค่าบวก

number

ค่าต่ําสุดที่วางรายการลงในขนาดคงที่ ค่าด้านล่างเริ่มต้นจะรวมอยู่ในที่เก็บข้อมูลเดียว ช่องนี้ไม่บังคับ

number

ค่าสูงสุดที่รายการจะวางในที่เก็บข้อมูลที่มีขนาดคงที่ ระบบจะรวมค่าที่สูงกว่าไว้ในที่เก็บข้อมูลเดียว ช่องนี้ไม่บังคับ

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

ประเภทของการจัดกลุ่มวันที่และเวลาที่จะใช้

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

integer

จํานวนสูงสุด

integer

ลําดับขีดจํากัดกลุ่มจะมีผลกับตาราง Pivot

ระบบจะใช้ขีดจํากัดกลุ่ม Pivot จากหมายเลขคําสั่งซื้อต่ําไปสูงกว่า หมายเลขคําสั่งซื้อจะได้รับการปรับค่าให้เป็นเลขจํานวนเต็มต่อเนื่องตั้งแต่ 0

สําหรับคําขอเขียน หากต้องการปรับแต่งคําสั่งซื้อที่ใช้ทั้งหมด ขีดจํากัดกลุ่ม Pivot ทั้งหมดควรกําหนดค่าช่องนี้ด้วยตัวเลขที่ไม่ซ้ํากัน มิเช่นนั้น ลําดับจะกําหนดโดยดัชนีในรายการ PivotTable.rows แล้วตามด้วยรายการ PivotTable.columns

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

string

ค่าที่ควรระบุ ไม่รวมค่าที่ไม่ได้อยู่ในรายการนี้

object (BooleanCondition)

เงื่อนไขที่ต้องเป็นจริงสําหรับค่าต่างๆ จึงจะแสดง ( visibleValues จะไม่ลบล้างค่านี้ -- แม้ว่าระบบจะใส่ค่าดังกล่าวไว้ แต่ค่านั้นจะยังซ่อนอยู่หากไม่เป็นไปตามเงื่อนไข)

ค่าเงื่อนไขที่อ้างอิงถึงช่วงในเครื่องหมาย A1 จะได้รับการประเมินเมื่อเทียบกับชีตตาราง Pivot การอ้างอิงจะได้รับการรักษาอย่างสมบูรณ์ ดังนั้น ตาราง Pivot จึงไม่ถูกเติมลงไป เช่น ค่า =A1 ใน "ตาราง Pivot 1" จะถือว่าเป็น 'Pivot Table 1'!$A$1

ข้อมูลต้นฉบับของตาราง Pivot จะอ้างอิงตามชื่อส่วนหัวของคอลัมน์ได้ ตัวอย่างเช่น หากข้อมูลต้นฉบับมีคอลัมน์ชื่อ "รายได้" และ "ค่าใช้จ่าย" และมีการใช้เงื่อนไขกับคอลัมน์ "รายได้" ที่มีประเภท NUMBER_GREATER และค่า =Cost ระบบจะรวมเฉพาะคอลัมน์ที่มี "รายได้" > "ค่าใช้จ่าย" เท่านั้น

boolean

ค่าเริ่มต้นจะปรากฏหรือไม่ หากจริง ระบบจะไม่สนใจ visibleValues ทุกค่าที่ตรงกับ condition (หากระบุ) จะแสดง หากเป็นเท็จ ค่าที่อยู่ในทั้ง visibleValues และ condition จะแสดงขึ้นมา

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

เกณฑ์สําหรับคอลัมน์

integer

ออฟเซ็ตคอลัมน์ของช่วงที่มา

object (DataSourceColumnReference)

การอ้างอิงไปยังคอลัมน์แหล่งข้อมูล

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

ฟังก์ชันสําหรับสรุปค่า หากตั้งค่า formula ไว้ ค่าที่รองรับมีเพียง SUM และ CUSTOM หากตั้งค่า sourceColumnOffset ไว้ ระบบจะไม่รองรับ CUSTOM

string

ชื่อที่จะใช้สําหรับค่า

enum (PivotValueCalculatedDisplayType)

หากระบุไว้ ควรแสดงว่าค่า Pivot ควรจะแสดงผลจากการคํานวณด้วยค่า Pivot อื่น ตัวอย่างเช่น หากมีการระบุ displayDisplayType เป็น PERCENT_OF_GRAND_TOTAL ค่า Pivot ทั้งหมดจะแสดงเป็นเปอร์เซ็นต์ของผลรวมทั้งหมด ในเครื่องมือแก้ไขชีต ตัวเลือกนี้เรียกว่า "แสดงเป็น" ในส่วนค่าของตาราง Pivot

integer

ออฟเซ็ตคอลัมน์ของช่วงต้นทางที่ค่านี้อ่านอยู่

เช่น หากต้นทางคือ C10:E15 sourceColumnOffset ของ 0 หมายความว่าค่านี้หมายถึงคอลัมน์ C ในขณะที่ออฟเซ็ต 1 จะอ้างถึงคอลัมน์ D

string

สูตรที่กําหนดเองเพื่อคํานวณค่า สูตรต้องขึ้นต้นด้วยอักขระ =

object (DataSourceColumnReference)

การอ้างอิงไปยังคอลัมน์แหล่งข้อมูลที่ค่านี้อ่าน