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)

피벗 테이블의 각 행 그룹화

object (PivotGroup)

피벗 테이블의 각 열 그룹

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

소스 열 오프셋당 필터 매핑(선택사항)입니다.

필터는 피벗 테이블에 데이터를 집계하기 전에 적용됩니다. 맵의 키는 필터링하려는 소스 범위의 열 오프셋이며 값은 해당 열의 기준입니다.

예를 들어 소스가 C10:E15, 키 0 열에 대한 필터가 있습니다 C 반면에 키는 1 열용 D입니다.

이 필드는 다음 용도로 지원 중단되었습니다. filterSpecs

object (PivotFilterSpec)

피벗 테이블의 데이터를 집계하기 전에 소스 열에 적용된 필터입니다.

모두 criteria 및 filterSpecs 응답에서 채워집니다 업데이트 요청에서 두 필드가 모두 지정되면 이 필드가 우선 적용됩니다.

object (PivotValue)

피벗 테이블에 포함할 값의 목록입니다.

enum (PivotValueLayout)

값을 가로 (열) 또는 세로 (행) 중 어디에 표시할지 지정합니다.

object (DataExecutionStatus)

출력 전용입니다. 데이터 소스 피벗 테이블의 데이터 실행 상태입니다.

object (GridRange)

피벗 테이블이 데이터를 읽는 범위입니다.

string

피벗 테이블이 데이터를 읽는 데이터 소스의 ID입니다.

{
  "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입니다.

object (PivotGroupValueMetadata)

그룹의 값에 대한 메타데이터입니다.

enum (SortOrder)

이 그룹의 값이 정렬될 순서입니다.

object (PivotGroupSortValueBucket)

정렬 기준으로 반대되는 피벗 그룹의 버킷입니다. 지정하지 않으면 이 그룹의 값에 따라 알파벳순으로 정렬됩니다.

boolean

이 피벗 그룹의 제목이 반복되어야 하는 경우 true입니다. 이는 행 그룹화에만 유효하며 열에서 무시됩니다.

기본적으로 Google은 상위 제목이 동일한 곳에 표시되지 않도록 하여 제목의 반복을 최소화합니다. 예를 들어 아래의 세 번째 행이 '3분기 1분기'에 해당하더라도 '1분기'에 해당합니다. 이전 행과 중복되므로 표시되지 않습니다. repeatHeadings를 true로 설정하면 'Q1'이 발생함 '2월' 동안 반복 '3월'이 있습니다.

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

string

맞춤설정할 수 있는 행/열 그룹에 사용할 라벨입니다. 예를 들어 다음 피벗 테이블에서 행 라벨은 Region ( State) 열 라벨은 다음과 같습니다. <ph type="x-smartling-placeholder">Product</ph> (이름이 변경될 수 있음) Item). 2017년 12월 이전에 생성된 피벗 테이블에는 헤더 라벨이 없습니다. 기존 피벗 테이블에 헤더 라벨을 추가하려면 기존 피벗 테이블을 삭제한 다음 동일한 매개변수를 사용하여 새 피벗 테이블을 만드세요.

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

이 피벗 그룹에 적용할 행 또는 열의 개수 한도입니다.

integer

이 그룹화의 기반이 되는 소스 범위의 열 오프셋입니다.

예를 들어 소스가 C10:E15, a sourceColumnOffset / <ph type="x-smartling-placeholder">0</ph> 이 그룹은 C인 반면, 오프셋은 1 인코더-디코더 아키텍처를 D

object (DataSourceColumnReference)

이 그룹화의 기반이 되는 데이터 소스 열에 대한 참조입니다.

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

object (ExtendedValue)

메타데이터가 해당하는 계산된 값입니다. (참고: formulaValue 값이 계산되므로 유효하지 않습니다.)

boolean

값에 해당하는 데이터가 접혀 있으면 true입니다.

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

integer

이 PivotTable.values 이 그룹화에서 정렬 기준으로 삼을 값의 목록입니다.

object (ExtendedValue)

정렬에 사용할 값을 선택할 버킷을 결정합니다.

예를 들어 행 그룹이 하나인 피벗 테이블에서 열 그룹이 2개이면 행 그룹에는 최대 2개의 값을 나열할 수 있습니다. 첫 번째 값은 첫 번째 열 그룹 내의 값에 해당하고, 두 번째 값은 두 번째 열 그룹의 값에 해당합니다. 값이 나열되지 않는 경우 '총계'에 따라 행이 정렬되어야 함을 나타냅니다. 적용할 수도 있습니다 하나의 값을 나열하는 경우 이는 '총계'를 사용하는 것에 해당합니다. 버킷의 이름을 지정합니다

{

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

그룹 한도가 피벗 테이블에 적용되는 순서입니다.

피벗 그룹 한도는 주문 번호가 낮은 순으로 적용됩니다. 주문 번호는 0부터 연속적인 정수로 정규화됩니다.

쓰기 요청의 경우 적용되는 주문을 완전히 맞춤설정하려면 모든 피벗 그룹 한도에 이 필드를 고유한 숫자로 설정해야 합니다. 그렇지 않으면 순서는 PivotTable.rows 를 선택한 다음 PivotTable.columns 목록.

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

string

포함되어야 하는 값입니다. 여기에 나열되지 않은 값은 제외됩니다.

object (BooleanCondition)

값이 표시되려면 true여야 하는 조건입니다. visibleValues 가 이를 재정의하지 않습니다. 값이 목록에 있더라도 조건을 충족하지 않으면 계속 숨겨집니다.

A1 표기법의 범위를 참조하는 조건 값은 피벗 테이블 시트를 기준으로 평가됩니다. 참조는 절대적으로 처리되므로 피벗 테이블에 채워지지 않습니다. 예를 들어 조건 값이 =A1 '피벗 테이블 1'에서 는 다음과 같이 처리됩니다. 'Pivot Table 1'!$A$1

피벗 테이블의 소스 데이터는 열 헤더 이름으로 참조할 수 있습니다. 예를 들어 소스 데이터에 '수익'이라는 열이 있는 경우 '비용' 조건이 '수익' 유형이 있는 열 NUMBER_GREATER 및 값 =Cost, '수익'이 있는 열만 &gt; "비용" 포함되어 있습니다.

boolean

값의 기본 표시 여부입니다. true인 경우 visibleValues 무시되며 충족되는 모든 값이 condition (지정된 경우)가 표시됩니다. false인 경우 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

소스 범위의 0부터 시작하는 열 오프셋입니다.

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)

지정된 경우 다른 피벗 값을 사용한 계산의 결과로 피벗 값을 표시해야 함을 나타냅니다. 예를 들어 계산된DisplayType이 PERCENT_OF_GRAND_TOTAL로 지정된 경우 모든 피벗 값은 총계의 백분율로 표시됩니다. Sheets 편집기에서는 이를 '다음으로 표시'라고 합니다. 값을 입력합니다.

integer

이 값을 읽는 소스 범위의 열 오프셋입니다.

예를 들어 소스가 C10:E15, a sourceColumnOffset / <ph type="x-smartling-placeholder">0</ph> 는 이 값이 열 C인 반면, 오프셋은 1 인코더-디코더 아키텍처를 D

string

값을 계산할 맞춤 수식입니다. 수식은 = 있습니다.

object (DataSourceColumnReference)

이 값이 읽는 데이터 소스 열에 대한 참조입니다.