Pivot Tables

PivotTable

Pivot tablo.

JSON gösterimi
{
  "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.
}
Alanlar
rows[]

object (PivotGroup)

Pivot tablodaki her satır gruplaması.

columns[]

object (PivotGroup)

Pivot tablodaki her sütun grubu.

criteria
(deprecated)

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

Kaynak sütun ofseti başına isteğe bağlı filtre eşleme.

Filtreler, veriler pivot tabloda toplanmadan önce uygulanır. Eşlemenin anahtarı, filtrelemek istediğiniz kaynak aralığın sütun ofsetidir ve değer, söz konusu sütunun ölçütüdür.

Örneğin, kaynak C10:E15 ise 0 anahtarı C sütunu için filtreye sahip olurken 1 anahtarı D sütunu için filtreye sahip olur.

Bu alan kullanımdan kaldırılarak yerine filterSpecs getirilmiştir.

filterSpecs[]

object (PivotFilterSpec)

Pivot tablonun verileri toplanmadan önce kaynak sütunlara uygulanan filtreler.

Hem criteria hem de filterSpecs yanıtlara doldurulur. Bir güncelleme isteğinde her iki alan da belirtilirse bu alan öncelikli olur.

values[]

object (PivotValue)

Pivot tabloya dahil edilecek değerlerin listesi.

valueLayout

enum (PivotValueLayout)

Değerlerin yatay (sütun olarak) mı yoksa dikey (satır olarak) mi listeleneceğini belirtir.

dataExecutionStatus

object (DataExecutionStatus)

Yalnızca çıkış. Veri kaynağı pivot tablolarının veri yürütme durumu.

Birlik alanı source_data. Pivot tablo verilerinin kaynağı. source_data yalnızca aşağıdakilerden biri olabilir:
source

object (GridRange)

Pivot tablonun veri okuduğu aralık.

dataSourceId

string

Pivot tablonun veri okuduğu veri kaynağının kimliği.

PivotGroup

Pivot tablodaki tek bir gruplandırma (satır veya sütun).

JSON gösterimi
{
  "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.
}
Alanlar
showTotals

boolean

Pivot tabloda bu gruplandırmanın toplamları yer almalıdır.

valueMetadata[]

object (PivotGroupValueMetadata)

Gruplamadaki değerlerle ilgili meta veriler.

sortOrder

enum (SortOrder)

Bu gruptaki değerlerin sıralama düzeni.

valueBucket

object (PivotGroupSortValueBucket)

Sıralama ölçütü olarak kullanılacak ters pivot grubun paketi. Belirtilmemişse sıralama, bu grubun değerlerine göre alfabetik olarak yapılır.

repeatHeadings

boolean

Bu pivot gruptaki başlıkların tekrarlanması gerekiyorsa doğru değerini döndürür. Bu yalnızca satır gruplamaları için geçerlidir ve sütunlar tarafından yoksayılır.

Varsayılan olarak, aynı oldukları üst düzey başlıkları göstermeyerek başlıkların tekrarını en aza indiririz. Örneğin, aşağıdaki üçüncü satır "Mar 1. Çeyrek"e karşılık gelse de önceki satırlarla örtüştüğü için "1. Çeyrek" gösterilmez. repeatHeadings değerini true olarak ayarlamak, "1. Çeyrek" değerinin "Şub" ve "Mar" için tekrarlanmasına neden olur.

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

string

Özelleştirilebilen satır/sütun grupları için kullanılacak etiketler. Örneğin, aşağıdaki pivot tabloda satır etiketi Region (State olarak yeniden adlandırılabilir) ve sütun etiketi ise Product (Item olarak yeniden adlandırılabilir) şeklindedir. Aralık 2017'den önce oluşturulan pivot tablolarda başlık etiketleri yoktur. Mevcut bir pivot tabloya başlık etiketleri eklemek istiyorsanız lütfen mevcut pivot tabloyu silip aynı parametrelere sahip yeni bir pivot tablo oluşturun.

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

object (PivotGroupRule)

Bu satır/sütun grubuna uygulanacak grup kuralı.

groupLimit

object (PivotGroupLimit)

Bu pivot gruba uygulanacak satır veya sütun sayısı sınırı.

Birlik alanı source. Pivot grubun veri kaynağı. source yalnızca aşağıdakilerden biri olabilir:
sourceColumnOffset

integer

Bu gruplandırmanın temel aldığı kaynak aralığın sütun ofseti.

Örneğin, kaynak C10:E15 ise 0 değerinin sourceColumnOffset olması bu grubun C sütununa referans verdiğini, 1 ofsetinin ise D sütununa referans verdiğini gösterir.

dataSourceColumnReference

object (DataSourceColumnReference)

Bu gruplandırmanın temel aldığı veri kaynağı sütununa referans.

PivotGroupValueMetadata

Pivot gruplandırmadaki bir değerle ilgili meta veriler.

JSON gösterimi
{
  "value": {
    object (ExtendedValue)
  },
  "collapsed": boolean
}
Alanlar
value

object (ExtendedValue)

Meta verilerin karşılık geldiği hesaplanmış değer. (Değerlerin hesaplanacağı için formulaValue değerinin geçerli olmadığını unutmayın.)

collapsed

boolean

Değere karşılık gelen veriler daraltılmışsa doğru değerini döndürür.

PivotGroupSortValueBucket

Bir pivot gruptaki hangi değerlerin sıralama için kullanılacağıyla ilgili bilgiler.

JSON gösterimi
{
  "valuesIndex": integer,
  "buckets": [
    {
      object (ExtendedValue)
    }
  ]
}
Alanlar
valuesIndex

integer

Bu gruplandırmadaki değerlerin PivotTable.values listesinde sıralanacağı ofset.

buckets[]

object (ExtendedValue)

Sıralama için değerlerin seçileceği paketi belirler.

Örneğin, bir satır grubu ve iki sütun grubu içeren bir pivot tabloda satır grubu en fazla iki değer listeleyebilir. İlk değer, ilk sütun grubundaki bir değere, ikinci değer ise ikinci sütun grubundaki bir değere karşılık gelir. Listelenen bir değer yoksa satırın, sütun grupları genelinde "Genel Toplam"a göre sıralanması gerektiğini gösterir. Listelenen tek bir değer varsa bu, ilgili grubun "Toplam" değerinin kullanılmasına karşılık gelir.

PivotGroupRule

Her bir değeri ayrı ayrı belirtmek yerine, kaynak veri sütunundaki değerler için gruplar tanımlayan PivotGroup isteğe bağlı bir ayardır. Kaynak verilerdeki her sütun için yalnızca bir grup kuralı içeren PivotGroup eklenebilir. Ancak herhangi bir sütuna hem kural içeren bir PivotGroup hem de kural içermeyen bir PivotGroup ekleyebilirsiniz.

JSON gösterimi
{

  // 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.
}
Alanlar
Birlik alanı rule. PivotGroup'ye uygulanacak kural. rule yalnızca aşağıdakilerden biri olabilir:
manualRule

object (ManualRule)

A ManualRule.

histogramRule

object (HistogramRule)

A HistogramRule.

dateTimeRule

object (DateTimeRule)

A DateTimeRule.

ManualRule

Bir kaynak veri sütunundaki değerleri, seçtiğiniz adlarla paketlere manuel olarak düzenlemenize olanak tanır. Örneğin, nüfusu eyalete göre toplayan bir pivot tablo:

+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK    |               0.7 |
| AL    |               4.8 |
| AR    |               2.9 |
...
+-------+-------------------+

manuel bir grup kuralına grup listesi (örneğin, groupName = "Central", items = ["AL", "AR", "IA", ...]) sağlayarak nüfusu saat dilimine göre toplayan bir pivot tabloya dönüştürülebilir. Benzer bir etkiyi, kaynak verilere bir saat dilimi sütunu ekleyerek ve pivot tabloyu ayarlayarak da elde edebileceğinizi unutmayın.

+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central   |             106.3 |
| Eastern   |             151.9 |
| Mountain  |              17.4 |
...
+-----------+-------------------+
JSON gösterimi
{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}
Alanlar
groups[]

object (ManualRuleGroup)

Grup adlarının ve kaynak verilerdeki her grup adıyla eşleşen öğelerin listesi.

ManualRuleGroup

Bir grup adı ve kaynak verilerdeki bu ada sahip gruba yerleştirilmesi gereken öğelerin listesi.

JSON gösterimi
{
  "groupName": {
    object (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}
Alanlar
groupName

object (ExtendedValue)

Grup adı (dize olmalıdır). Belirli bir ManualRule gruptaki her grubun benzersiz bir grup adı olmalıdır.

items[]

object (ExtendedValue)

Kaynak verilerde bu gruba yerleştirilmesi gereken öğeler. Her öğe dize, sayı veya boole olabilir. Öğeler belirli bir ManualRule içinde en fazla bir grupta görünebilir. Hiçbir grupta görünmeyen öğeler kendi başlarına görünür.

HistogramRule

Bir kaynak veri sütunundaki sayısal değerleri sabit boyutlu gruplar halinde düzenlemenize olanak tanır. HistogramRule.start ile HistogramRule.end arasındaki tüm değerler HistogramRule.interval boyutunda gruplara yerleştirilir. Ayrıca, HistogramRule.start değerinin altındaki tüm değerler bir gruba, HistogramRule.end değerinin üzerindeki tüm değerler ise başka bir gruba yerleştirilir. Yalnızca HistogramRule.interval gereklidir. Ancak hem HistogramRule.start hem de HistogramRule.end sağlanırsa HistogramRule.start, HistogramRule.end değerinden az olmalıdır. Örneğin, 50'den fazla satıra sahip, yaşa göre ortalama satın alma tutarını gösteren bir pivot tablo:

+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16  |            $27.13 |
| 17  |             $5.24 |
| 18  |            $20.15 |
...
+-----+-------------------+

25 değerinde bir HistogramRule.start, 20 değerinde bir HistogramRule.interval ve 65 değerinde bir HistogramRule.end içeren bir histogram grup kuralı uygulanarak aşağıdakine benzeyen bir pivot tabloya dönüştürülebilir.

+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25        |            $19.34 |
| 25-45       |            $31.43 |
| 45-65       |            $35.87 |
| > 65        |            $27.55 |
+-------------+-------------------+
| Grand Total |            $29.12 |
+-------------+-------------------+
JSON gösterimi
{
  "interval": number,
  "start": number,
  "end": number
}
Alanlar
interval

number

Oluşturulan paketlerin boyutu. Pozitif olmalıdır.

start

number

Öğelerin sabit boyutlu gruplara yerleştirildiği minimum değer. Başlangıç değerinin altındaki değerler tek bir pakette toplanır. Bu alan isteğe bağlıdır.

end

number

Öğelerin sabit boyutlu gruplara yerleştirildiği maksimum değer. Bitiş değerinin üzerindeki değerler tek bir pakette toplanır. Bu alan isteğe bağlıdır.

DateTimeRule

Bir kaynak veri sütunundaki tarih-saat değerlerini, tarih veya saat değerlerinin seçili bölümlerine göre gruplara ayırmanıza olanak tanır. Örneğin, satış işlemlerini tarihe göre gösteren bir pivot tabloyu ele alalım:

+----------+--------------+
| Date     | SUM of Sales |
+----------+--------------+
| 1/1/2017 |      $621.14 |
| 2/3/2017 |      $708.84 |
| 5/8/2017 |      $326.84 |
...
+----------+--------------+

YEAR_MONTH DateTimeRuleType değerine sahip bir tarih-saat grubu kuralı uyguladığınızda aşağıdaki pivot tablo oluşturulur.

+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan     |   $53,731.78 |
| 2017-Feb     |   $83,475.32 |
| 2017-Mar     |   $94,385.05 |
...
+--------------+--------------+
JSON gösterimi
{
  "type": enum (DateTimeRuleType)
}
Alanlar
type

enum (DateTimeRuleType)

Uygulanacak tarih-saat gruplandırması türü.

DateTimeRuleType

Kullanılabilir tarih-saat gruplandırma kuralı türleri. Bu dokümanda, e-tablo yerel ayarının "en-US" olduğu varsayılmaktadır. Ancak tarih ve saatlerin gerçek oluşturulmasında, bazı kural türleri için e-tablonun yerel ayarı kullanılır.

Sıralamalar
DATE_TIME_RULE_TYPE_UNSPECIFIED Varsayılan türdür, kullanmayın.
SECOND Tarihleri 0 ile 59 arasında saniyeye göre gruplandırın.
MINUTE Tarihleri 0 ile 59 arasında dakikaya göre gruplandırın.
HOUR 0 ile 23 arasında 24 saatlik bir sistem kullanarak tarihleri saate göre gruplandırın.
HOUR_MINUTE Tarihleri 24 saatlik sistem kullanarak saate ve dakikaya göre gruplandırın (ör. 19:45).
HOUR_MINUTE_AMPM 12 saatlik sistem kullanarak tarihleri saate ve dakikaya göre gruplandırın (ör. 19:45). AM/PM (sabah/öğleden sonra) tanımı, e-tablonun yerel ayarına göre çevrilir.
DAY_OF_WEEK Tarihleri haftanın gününe göre gruplandırın (ör. Pazar). Haftanın günleri, e-tablonun yerel ayarına göre çevrilir.
DAY_OF_YEAR Tarihleri, yılın 1 ile 366 arasındaki gün sayısına göre gruplandırın. 29 Şubat'tan sonraki tarihlerin, artık yıllarda artık olmayan yıllara göre farklı gruplara ayrıldığını unutmayın.
DAY_OF_MONTH Tarihleri 1 ile 31 arasında değişen ayın gününe göre gruplandırın.
DAY_MONTH Tarihleri güne ve aya göre gruplandırın (ör. 22-Kas). Ay, e-tablo yerel ayarına göre çevrilir.
MONTH Tarihleri aya göre gruplandırın (ör. Kasım). Ay, e-tablo yerel ayarına göre çevrilir.
QUARTER Tarihleri çeyreğe göre gruplandırın (ör. 1. çeyrek (Ocak-Mart'ı temsil eder)).
YEAR Tarihleri yıla göre gruplandırın (ör. 2008).
YEAR_MONTH Tarihleri yıla ve aya göre gruplandırın (ör. 2008-Kas). Ay, e-tablo yerel ayarına göre çevrilir.
YEAR_QUARTER Tarihleri yıla ve çeyreğe göre gruplandırın (ör. 2008 4. çeyrek).
YEAR_MONTH_DAY Tarihleri yıl, ay ve güne göre gruplandırın (ör. 22.11.2008).

PivotGroupLimit

Pivot gruptaki satır veya sütunlardaki sayı sınırı.

JSON gösterimi
{
  "countLimit": integer,
  "applyOrder": integer
}
Alanlar
countLimit

integer

Sayı sınırı.

applyOrder

integer

Grup sınırının pivot tabloya uygulanma sırası.

Pivot grubu sınırları, düşükten yükseğe doğru sipariş numarasına göre uygulanır. Sipariş numaraları, 0'dan itibaren art arda gelen tam sayılar olacak şekilde normalleştirilir.

Yazma isteği için, geçerli siparişleri tamamen özelleştirmek amacıyla tüm pivot grup sınırlarında bu alanın benzersiz bir sayıyla ayarlanması gerekir. Aksi takdirde sıra, PivotTable.rows listesinde ve ardından PivotTable.columns listesinde bulunan dizin tarafından belirlenir.

PivotFilterCriteria

Pivot tabloda satırları gösterme/gizleme ölçütleri.

JSON gösterimi
{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}
Alanlar
visibleValues[]

string

Dahil edilmesi gereken değerler. Burada listelenmeyen değerler hariç tutulur.

condition

object (BooleanCondition)

Değerlerin gösterilmesi için doğru olması gereken bir koşul. ( visibleValues bunu geçersiz kılmaz. Bir değer listede yer alsa bile koşulu karşılamıyorsa gizli kalır.)

A1 gösterimindeki aralıklara atıfta bulunan koşul değerleri, pivot tablo sayfasına göre değerlendirilir. Referanslar mutlak olarak değerlendirilir, bu nedenle pivot tabloda aşağı doğru doldurulmaz. Örneğin, "Pivot Tablo 1"deki =A1 koşul değeri 'Pivot Table 1'!$A$1 olarak değerlendirilir.

Pivot tablonun kaynak verilerine sütun başlığı adıyla referans verilebilir. Örneğin, kaynak verilerde "Gelir" ve "Maliyet" adlı sütunlar varsa ve "Gelir" sütununa NUMBER_GREATER türü ve =Cost değeriyle bir koşul uygulanırsa yalnızca "Gelir" > "Maliyet" olan sütunlar dahil edilir.

visibleByDefault

boolean

Değerlerin varsayılan olarak görünür olup olmadığı. Doğruysa visibleValues yoksayılır, condition (belirtilmişse) koşulunu karşılayan tüm değerler gösterilir. Yanlış ise hem visibleValues içinde bulunan hem de condition koşulunu karşılayan değerler gösterilir.

PivotFilterSpec

Belirli bir kaynak sütun ofsetiyle ilişkili pivot tablo filtre ölçütleri.

JSON gösterimi
{
  "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.
}
Alanlar
filterCriteria

object (PivotFilterCriteria)

Sütun ölçütleri.

Birlik alanı source. Bu filtrenin uygulandığı kaynak sütun. source yalnızca aşağıdakilerden biri olabilir:
columnOffsetIndex

integer

Kaynak aralığın sıfır tabanlı sütun ofseti.

dataSourceColumnReference

object (DataSourceColumnReference)

Veri kaynağı sütununa referans.

PivotValue

Pivot tablodaki bir değerin nasıl hesaplanacağının tanımı.

JSON gösterimi
{
  "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.
}
Alanlar
summarizeFunction

enum (PivotValueSummarizeFunction)

Değeri özetleyen bir işlev. formula ayarlanmışsa desteklenen tek değerler SUM ve CUSTOM'dir. sourceColumnOffset ayarlanmışsa CUSTOM desteklenmez.

name

string

Değer için kullanılacak ad.

calculatedDisplayType

enum (PivotValueCalculatedDisplayType)

Belirtiliyse pivot değerlerinin başka bir pivot değer içeren bir hesaplamanın sonucu olarak gösterilmesi gerektiğini belirtir. Örneğin, calculatedDisplayType PERCENT_OF_GRAND_TOTAL olarak belirtilirse tüm pivot değerleri, toplamın yüzdesi olarak gösterilir. E-Tablolar düzenleyicisinde, pivot tablonun değer bölümünde bu değere "Şöyle Göster" adı verilir.

Birlik alanı value. Pivot tablodaki değerler için kullanılacak veriler. Tam olarak bir değer ayarlanmalıdır. value yalnızca aşağıdakilerden biri olabilir:
sourceColumnOffset

integer

Bu değerin okuduğu kaynak aralığın sütun ofseti.

Örneğin, kaynak C10:E15 ise 0 değerinin sourceColumnOffset olması bu değerin C sütununu, 1 ofsetinin ise D sütununu kastettiği anlamına gelir.

formula

string

Değeri hesaplamak için özel bir formül. Formül, = karakteriyle başlamalıdır.

dataSourceColumnReference

object (DataSourceColumnReference)

Bu değerin okuduğu veri kaynağı sütununa referans.

PivotValueSummarizeFunction

Pivot değerini özetleyen bir işlev.

Sıralamalar
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED Varsayılan ayardır, kullanılmaz.
SUM SUM işlevine karşılık gelir.
COUNTA COUNTA işlevine karşılık gelir.
COUNT COUNT işlevine karşılık gelir.
COUNTUNIQUE COUNTUNIQUE işlevine karşılık gelir.
AVERAGE AVERAGE işlevine karşılık gelir.
MAX MAX işlevine karşılık gelir.
MIN MIN işlevine karşılık gelir.
MEDIAN MEDIAN işlevine karşılık gelir.
PRODUCT PRODUCT işlevine karşılık gelir.
STDEV STDEV işlevine karşılık gelir.
STDEVP STDEVP işlevine karşılık gelir.
VAR VAR işlevine karşılık gelir.
VARP VARP işlevine karşılık gelir.
CUSTOM Formülün olduğu gibi kullanılacağını belirtir. Yalnızca PivotValue.formula ayarlanmışsa geçerlidir.
NONE Değerin zaten özetlenmiş olduğunu ve özetleme işlevinin açıkça belirtilmediğini gösterir. Değerin zaten özetlendiği Looker veri kaynağı pivot tabloları için kullanılır.

PivotValueCalculatedDisplayType

Pivot tablo değerlerinin görüntüleme için hesaplanabileceği olası yöntemler.

Sıralamalar
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED Varsayılan değerdir, kullanmayın.
PERCENT_OF_ROW_TOTAL Pivot değerlerini, satır toplam değerlerinin yüzdesi olarak gösterir.
PERCENT_OF_COLUMN_TOTAL Pivot değerlerini, sütun toplam değerlerinin yüzdesi olarak gösterir.
PERCENT_OF_GRAND_TOTAL Pivot değerlerini, toplam değerlerin yüzdesi olarak gösterir.

PivotValueLayout

Pivot değerlerinin düzeni.

Sıralamalar
HORIZONTAL Değerler yatay olarak (sütunlar halinde) düzenlenir.
VERTICAL Değerler dikey olarak (satır olarak) düzenlenir.