PivotTable
피벗 테이블
JSON 표현 |
---|
{ "rows": [ { object ( |
필드 | |
---|---|
rows[]
|
피벗 테이블의 각 행 그룹화 |
columns[]
|
피벗 테이블의 각 열 그룹 |
criteria
|
소스 열 오프셋당 필터 매핑(선택사항)입니다. 필터는 피벗 테이블에 데이터를 집계하기 전에 적용됩니다. 맵의 키는 필터링하려는 소스 범위의 열 오프셋이며 값은 해당 열의 기준입니다.
예를 들어 소스가
이 필드는 다음 용도로 지원 중단되었습니다.
|
filterSpecs[]
|
피벗 테이블의 데이터를 집계하기 전에 소스 열에 적용된 필터입니다.
모두
|
values[]
|
피벗 테이블에 포함할 값의 목록입니다. |
valueLayout
|
값을 가로 (열) 또는 세로 (행) 중 어디에 표시할지 지정합니다. |
dataExecutionStatus
|
출력 전용입니다. 데이터 소스 피벗 테이블의 데이터 실행 상태입니다. |
공용체 필드
source_data 피벗 테이블 데이터의 소스입니다.
source_data
다음 중 하나여야 합니다.
|
|
source
|
피벗 테이블이 데이터를 읽는 범위입니다. |
dataSourceId
|
피벗 테이블이 데이터를 읽는 데이터 소스의 ID입니다. |
PivotGroup
피벗 테이블의 단일 그룹 (행 또는 열)입니다.
JSON 표현 |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
필드 | |
---|---|
showTotals
|
피벗 테이블에 이 그룹의 총계가 포함되어야 하는 경우 true입니다. |
valueMetadata[]
|
그룹의 값에 대한 메타데이터입니다. |
sortOrder
|
이 그룹의 값이 정렬될 순서입니다. |
valueBucket
|
정렬 기준으로 반대되는 피벗 그룹의 버킷입니다. 지정하지 않으면 이 그룹의 값에 따라 알파벳순으로 정렬됩니다. |
repeatHeadings
|
이 피벗 그룹의 제목이 반복되어야 하는 경우 true입니다. 이는 행 그룹화에만 유효하며 열에서 무시됩니다. 기본적으로 Google은 상위 제목이 동일한 곳에 표시되지 않도록 하여 제목의 반복을 최소화합니다. 예를 들어 아래의 세 번째 행이 '3분기 1분기'에 해당하더라도 '1분기'에 해당합니다. 이전 행과 중복되므로 표시되지 않습니다. repeatHeadings를 true로 설정하면 'Q1'이 발생함 '2월' 동안 반복 '3월'이 있습니다.
|
label
|
맞춤설정할 수 있는 행/열 그룹에 사용할 라벨입니다. 예를 들어 다음 피벗 테이블에서 행 라벨은
|
groupRule
|
이 행/열 그룹에 적용할 그룹 규칙입니다. |
groupLimit
|
이 피벗 그룹에 적용할 행 또는 열의 개수 한도입니다. |
공용체 필드
source 피벗 그룹의 데이터 소스입니다.
source
다음 중 하나여야 합니다.
|
|
sourceColumnOffset
|
이 그룹화의 기반이 되는 소스 범위의 열 오프셋입니다.
예를 들어 소스가
|
dataSourceColumnReference
|
이 그룹화의 기반이 되는 데이터 소스 열에 대한 참조입니다. |
PivotGroupValueMetadata
피벗 그룹의 값에 관한 메타데이터입니다.
JSON 표현 |
---|
{
"value": {
object (
|
필드 | |
---|---|
value
|
메타데이터가 해당하는 계산된 값입니다. (참고:
|
collapsed
|
값에 해당하는 데이터가 접혀 있으면 true입니다. |
PivotGroupSortValueBucket
피벗 그룹에서 정렬에 사용해야 하는 값에 대한 정보입니다.
JSON 표현 |
---|
{
"valuesIndex": integer,
"buckets": [
{
object (
|
필드 | |
---|---|
valuesIndex
|
이
|
buckets[]
|
정렬에 사용할 값을 선택할 버킷을 결정합니다. 예를 들어 행 그룹이 하나인 피벗 테이블에서 열 그룹이 2개이면 행 그룹에는 최대 2개의 값을 나열할 수 있습니다. 첫 번째 값은 첫 번째 열 그룹 내의 값에 해당하고, 두 번째 값은 두 번째 열 그룹의 값에 해당합니다. 값이 나열되지 않는 경우 '총계'에 따라 행이 정렬되어야 함을 나타냅니다. 적용할 수도 있습니다 하나의 값을 나열하는 경우 이는 '총계'를 사용하는 것에 해당합니다. 버킷의 이름을 지정합니다 |
PivotGroupRule
애플리케이션의 선택적 설정
PivotGroup
는 각 개별 값을 나누지 않고 소스 데이터 열의 값에 대한 버킷을 정의합니다. 1개만
PivotGroup
그룹 규칙이 있는 는 소스 데이터의 각 열에 추가될 수 있지만 특정 열에는
PivotGroup
규칙 및
<ph type="x-smartling-placeholder">PivotGroup
</ph>
그렇지 않은 것입니다
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드
rule 이
PivotGroup
rule
다음 중 하나여야 합니다.
|
|
manualRule
|
|
histogramRule
|
|
dateTimeRule
|
|
ManualRule
소스 데이터 열의 값을 직접 선택한 이름이 있는 버킷으로 구성할 수 있습니다. 예를 들어 주별로 인구를 집계하는 피벗 테이블은 다음과 같습니다.
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
수동 그룹 규칙에 그룹 목록 (예: groupName = 'Central', items = ['AL', 'AR', 'IA', ...])을 제공하여 시간대별로 인구를 집계하는 피벗 테이블로 전환할 수 있습니다. 소스 데이터에 시간대 열을 추가하고 피벗 테이블을 조정해도 비슷한 효과를 얻을 수 있습니다.
+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central | 106.3 |
| Eastern | 151.9 |
| Mountain | 17.4 |
...
+-----------+-------------------+
JSON 표현 |
---|
{
"groups": [
{
object (
|
필드 | |
---|---|
groups[]
|
그룹 이름 목록과 각 그룹 이름에 매핑되는 소스 데이터에서 해당하는 항목 목록입니다. |
ManualRuleGroup
이 이름을 사용하는 그룹에 배치해야 하는 소스 데이터의 항목 목록과 그룹 이름
JSON 표현 |
---|
{ "groupName": { object ( |
필드 | |
---|---|
groupName
|
그룹 이름으로, 문자열이어야 합니다. 주어진
|
items[]
|
이 그룹에 배치해야 하는 소스 데이터의 항목입니다. 각 항목은 문자열, 숫자 또는 부울일 수 있습니다. 항목은 지정된 그룹 내에서 최대 한 그룹에만 나타날 수 있습니다.
|
HistogramRule
소스 데이터 열의 숫자 값을 일정한 크기의 버킷으로 구성할 수 있습니다. 모든 값
HistogramRule.start
~
HistogramRule.end
크기가 인코더-디코더에
HistogramRule.interval
입니다. 또한 아래의 모든 값
HistogramRule.start
하나의 그룹에 배치되고 위의 모든 값은
HistogramRule.end
다른 위치에 배치됩니다 단
HistogramRule.interval
가 필요하지만
HistogramRule.start
및
<ph type="x-smartling-placeholder">HistogramRule.end
</ph>
둘 다 제공되며
HistogramRule.start
은(는) 미만이어야 합니다.
HistogramRule.end
입니다. 예를 들어 연령별 평균 구매액에 행이 50개 이상 있는 피벗 테이블이 있습니다.
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
를 갖는 히스토그램 그룹 규칙을 적용해 아래와 같은 피벗 테이블로 변환할 수 있습니다.
HistogramRule.start
25의
HistogramRule.interval
그리고
<ph type="x-smartling-placeholder">HistogramRule.end
</ph>
65가 넘습니다
+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25 | $19.34 |
| 25-45 | $31.43 |
| 45-65 | $35.87 |
| > 65 | $27.55 |
+-------------+-------------------+
| Grand Total | $29.12 |
+-------------+-------------------+
JSON 표현 |
---|
{ "interval": number, "start": number, "end": number } |
필드 | |
---|---|
interval
|
생성되는 버킷의 크기입니다. 양수여야 합니다. |
start
|
항목이 일정한 크기의 버킷에 배치되는 최솟값입니다. 시작 값 아래의 값은 단일 버킷으로 일괄 처리됩니다. 이 필드는 선택사항입니다. |
end
|
항목이 일정한 크기의 버킷에 배치되는 최댓값입니다. 끝을 초과하는 값은 단일 버킷으로 일괄 처리됩니다. 이 필드는 선택사항입니다. |
DateTimeRule
날짜 또는 시간 값의 선택한 부분을 기준으로 소스 데이터 열의 날짜-시간 값을 버킷으로 구성할 수 있습니다. 예를 들어 날짜별 판매 거래를 표시하는 피벗 테이블을 살펴보겠습니다.
+----------+--------------+
| Date | SUM of Sales |
+----------+--------------+
| 1/1/2017 | $621.14 |
| 2/3/2017 | $708.84 |
| 5/8/2017 | $326.84 |
...
+----------+--------------+
다음과 같은 날짜-시간 그룹 규칙을 적용하면
DateTimeRuleType
YEAR_MONTH 의 결과는 다음 피벗 테이블이 생성됩니다.
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
JSON 표현 |
---|
{
"type": enum (
|
필드 | |
---|---|
type
|
적용할 날짜/시간 그룹화의 유형입니다. |
DateTimeRuleType
사용 가능한 날짜-시간 그룹화 규칙 유형입니다. 이 문서에서는 날짜와 시간을 실제로 렌더링할 때 일부 규칙 유형에 대해 스프레드시트의 언어를 사용하지만, 스프레드시트 언어는 'en-US'라고 가정합니다.
열거형 | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
기본 유형이며 사용하지 마세요. |
SECOND
|
0에서 59까지 초별로 날짜를 그룹화합니다. |
MINUTE
|
날짜를 0~59 사이의 분 단위로 그룹화하세요. |
HOUR
|
0~23 사이의 24시간 체계를 사용하여 시간별로 날짜를 그룹화합니다. |
HOUR_MINUTE
|
24시간 체계(예: 19:45)를 사용하여 시간과 분을 기준으로 날짜를 그룹화합니다. |
HOUR_MINUTE_AMPM
|
12시간 체계(예: 오후 7:45)를 사용하여 시간과 분을 기준으로 날짜를 그룹화합니다. AM/PM 지정은 스프레드시트 언어에 따라 번역됩니다. |
DAY_OF_WEEK
|
요일별로 그룹화합니다(예: 일요일). 요일은 스프레드시트의 언어에 따라 번역됩니다. |
DAY_OF_YEAR
|
1에서 366까지 날짜별로 그룹화합니다. 2월 29일 이후의 날짜는 윤년과 윤년이 아닌 해의 양에 차이가 있습니다. |
DAY_OF_MONTH
|
1에서 31 사이의 날짜를 기준으로 날짜를 그룹화합니다. |
DAY_MONTH
|
일별 및 월별로 날짜를 그룹화합니다(예: 22~11월). 월은 스프레드시트 언어에 따라 번역됩니다. |
MONTH
|
날짜를 월별로 그룹화합니다(예: 11월). 월은 스프레드시트 언어에 따라 변환됩니다. |
QUARTER
|
날짜를 분기별로 그룹화합니다(예: 1분기(1~3월을 나타냄)). |
YEAR
|
연도별로 그룹화합니다(예: 2008). |
YEAR_MONTH
|
연도와 월을 기준으로 날짜를 그룹화합니다(예: 2008-11월). 월은 스프레드시트 언어에 따라 번역됩니다. |
YEAR_QUARTER
|
연도 및 분기별로 날짜를 그룹화합니다(예: 2008 Q4). |
YEAR_MONTH_DAY
|
연도, 월, 일을 기준으로 날짜를 그룹화합니다(예: 2008-11-22). |
PivotGroupLimit
피벗 그룹에 있는 행 또는 열의 개수 한도입니다.
JSON 표현 |
---|
{ "countLimit": integer, "applyOrder": integer } |
필드 | |
---|---|
countLimit
|
개수 제한입니다. |
applyOrder
|
그룹 한도가 피벗 테이블에 적용되는 순서입니다. 피벗 그룹 한도는 주문 번호가 낮은 순으로 적용됩니다. 주문 번호는 0부터 연속적인 정수로 정규화됩니다.
쓰기 요청의 경우 적용되는 주문을 완전히 맞춤설정하려면 모든 피벗 그룹 한도에 이 필드를 고유한 숫자로 설정해야 합니다. 그렇지 않으면 순서는
|
PivotFilterCriteria
피벗 테이블에서 행을 표시하거나 숨기는 기준입니다.
JSON 표현 |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
필드 | |
---|---|
visibleValues[]
|
포함되어야 하는 값입니다. 여기에 나열되지 않은 값은 제외됩니다. |
condition
|
값이 표시되려면 true여야 하는 조건입니다.
A1 표기법의 범위를 참조하는 조건 값은 피벗 테이블 시트를 기준으로 평가됩니다. 참조는 절대적으로 처리되므로 피벗 테이블에 채워지지 않습니다. 예를 들어 조건 값이
피벗 테이블의 소스 데이터는 열 헤더 이름으로 참조할 수 있습니다. 예를 들어 소스 데이터에 '수익'이라는 열이 있는 경우 '비용' 조건이 '수익' 유형이 있는 열
|
visibleByDefault
|
값의 기본 표시 여부입니다. true인 경우
|
PivotFilterSpec
특정 소스 열 오프셋과 연결된 피벗 테이블 필터 기준입니다.
JSON 표현 |
---|
{ "filterCriteria": { object ( |
필드 | |
---|---|
filterCriteria
|
열의 기준입니다. |
공용체 필드
source 이 필터가 적용되는 소스 열입니다.
source
다음 중 하나여야 합니다.
|
|
columnOffsetIndex
|
소스 범위의 0부터 시작하는 열 오프셋입니다. |
dataSourceColumnReference
|
데이터 소스 열에 대한 참조입니다. |
PivotValue
피벗 테이블의 값을 계산하는 방법에 대한 정의입니다.
JSON 표현 |
---|
{ "summarizeFunction": enum ( |
필드 | |
---|---|
summarizeFunction
|
값을 요약하는 함수입니다. 만약
|
name
|
값에 사용할 이름입니다. |
calculatedDisplayType
|
지정된 경우 다른 피벗 값을 사용한 계산의 결과로 피벗 값을 표시해야 함을 나타냅니다. 예를 들어 계산된DisplayType이 PERCENT_OF_GRAND_TOTAL로 지정된 경우 모든 피벗 값은 총계의 백분율로 표시됩니다. Sheets 편집기에서는 이를 '다음으로 표시'라고 합니다. 값을 입력합니다. |
공용체 필드
value 피벗 테이블의 값에 사용할 데이터입니다. 정확히 하나의 값을 설정해야 합니다.
value
다음 중 하나여야 합니다.
|
|
sourceColumnOffset
|
이 값을 읽는 소스 범위의 열 오프셋입니다.
예를 들어 소스가
|
formula
|
값을 계산할 맞춤 수식입니다. 수식은
|
dataSourceColumnReference
|
이 값이 읽는 데이터 소스 열에 대한 참조입니다. |
PivotValueSummarizeFunction
피벗 값을 요약하는 함수입니다.
열거형 | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
기본값이며 사용하지 않습니다. |
SUM
|
다음에 해당합니다.
SUM
함수를 사용하세요.
|
COUNTA
|
다음에 해당합니다.
COUNTA
함수를 사용하세요.
|
COUNT
|
다음에 해당합니다.
COUNT
함수를 사용하세요.
|
COUNTUNIQUE
|
다음에 해당합니다.
COUNTUNIQUE
함수를 사용하세요.
|
AVERAGE
|
다음에 해당합니다.
AVERAGE
함수를 사용하세요.
|
MAX
|
다음에 해당합니다.
MAX
함수를 사용하세요.
|
MIN
|
다음에 해당합니다.
MIN
함수를 사용하세요.
|
MEDIAN
|
다음에 해당합니다.
MEDIAN
함수를 사용하세요.
|
PRODUCT
|
다음에 해당합니다.
PRODUCT
함수를 사용하세요.
|
STDEV
|
다음에 해당합니다.
STDEV
함수를 사용하세요.
|
STDEVP
|
다음에 해당합니다.
STDEVP
함수를 사용하세요.
|
VAR
|
다음에 해당합니다.
VAR
함수를 사용하세요.
|
VARP
|
다음에 해당합니다.
VARP
함수를 사용하세요.
|
CUSTOM
|
수식을 그대로 사용해야 함을 나타냅니다. 다음 경우에만 유효:
PivotValue.formula
설정되어 있습니다.
|
NONE
|
값이 이미 요약되었으며 요약 함수가 명시적으로 지정되지 않았음을 나타냅니다. 값이 이미 요약된 Looker 데이터 소스 피벗 테이블에 사용됩니다. |
PivotValueCalculatedDisplayType
디스플레이를 위해 피벗 값을 계산할 수 있는 방법입니다.
열거형 | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
기본값이며 사용하지 마세요. |
PERCENT_OF_ROW_TOTAL
|
피벗 값을 행 총계에 대한 백분율로 표시합니다. |
PERCENT_OF_COLUMN_TOTAL
|
피벗 값을 열 총계 값의 백분율로 표시합니다. |
PERCENT_OF_GRAND_TOTAL
|
피벗 값을 총 합계 값의 백분율로 표시합니다. |
PivotValueLayout
피벗 값의 레이아웃입니다.
열거형 | |
---|---|
HORIZONTAL
|
값은 가로로 열로 배치됩니다. |
VERTICAL
|
값은 세로로 (행으로) 배치됩니다. |