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 gruplaması.

criteria
(deprecated)

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

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

Filtreler, veriler pivot tabloya eklenmeden önce uygulanır. Haritanın 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ütununu, 1 anahtarı ise D sütununu içerir.

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

filterSpecs[]

object (PivotFilterSpec)

Pivot tablo için verileri birleştirmeden önce kaynak sütunlara uygulanan filtreler.

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

values[]

object (PivotValue)

Pivot tabloya eklenecek değerlerin listesi.

valueLayout

enum (PivotValueLayout)

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

dataExecutionStatus

object (DataExecutionStatus)

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

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

object (GridRange)

Pivot tablonun verileri okuduğu aralık.

dataSourceId

string

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

PivotGroup

Pivot tabloda 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ı gerekiyorsa doğru değerini alır.

valueMetadata[]

object (PivotGroupValueMetadata)

Gruplamadaki değerlerle ilgili meta veriler.

sortOrder

enum (SortOrder)

Bu gruptaki değerlerin sıralanması gerekir.

valueBucket

object (PivotGroupSortValueBucket)

Sıralama için zıt pivot grubun paketi. Belirtilmezse, sıralama bu grubun değerlerine göre alfabetik olarak yapılır.

repeatHeadings

boolean

Bu pivot grubundaki başlıklar tekrar edilmesi gerekiyorsa doğru değerini alır. Bu yalnızca satır gruplamaları için geçerlidir ve sütunlar tarafından yoksayılır.

Varsayılan olarak, aynı ü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 "1. Çeyrek Mart"a karşılık gelse de, önceki satırlarla gereksiz olduğu için "Ç1" gösterilmez. Yineleyici Başlıkların true (doğru) değerine ayarlanması, "Q1"in "Şubat" ve "Mart" 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 (yeni adıyla State) ve sütun etiketi Product şeklindedir (Item olarak yeniden adlandırılabilir). Aralık 2017'den önce oluşturulan pivot tablolarda başlık etiketleri bulunmaz. Mevcut bir pivot tabloya başlık etiketleri eklemek istiyorsanız lütfen mevcut pivot tabloyu silin ve ardından aynı parametrelerle 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ıdır.

groupLimit

object (PivotGroupLimit)

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

Birleşim alanı source. Pivot grubunun veri kaynağı. source aşağıdakilerden yalnızca biri olabilir:
sourceColumnOffset

integer

Bu gruplamanın temel aldığı kaynak aralığın sütun uzaklığı.

Örneğin, kaynak C10:E15 ise 0 değerine sahip sourceColumnOffset değeri, bu grubun C sütununa, 1 ofseti ise D sütununa karşılık gelir.

dataSourceColumnReference

object (DataSourceColumnReference)

Bu gruplamanı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 verinin karşılık geldiği hesaplanan değer. (Değerler 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 alır.

PivotGroupSortValueBucket

Sıralama için pivot grubunda hangi değerlerin kullanılması gerektiği hakkında bilgi.

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

integer

Bu gruplandırmadaki değerlerin sıralanması gereken PivotTable.values listesindeki ofset.

buckets[]

object (ExtendedValue)

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

Örneğin, bir satır grubu ve iki sütun grubu olan bir pivot tabloda satır grubu en fazla iki değeri 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. Hiçbir değer listelenmemesi, satırın sütun grupları üzerinden "Genel Toplam"a göre sıralanması gerektiğini gösterir. Tek bir değer listeleniyorsa bu, ilgili grubun "Toplamı"nın kullanılmasına karşılık gelir.

PivotGroupRule

Her bir değeri ayrı ayrı ayırmak yerine kaynak veri sütunundaki değerler için paketleri tanımlayan PivotGroup üzerinde isteğe bağlı bir ayardır. Kaynak verilerdeki her sütun için grup kuralına sahip yalnızca bir PivotGroup eklenebilir ancak belirli bir sütuna hem kural içeren PivotGroup hem de bulunmayan 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
Birleşim alanı rule. PivotGroup öğesine uygulanacak kural. rule aşağıdakilerden yalnızca biri olabilir:
manualRule

object (ManualRule)

ManualRule.

histogramRule

object (HistogramRule)

HistogramRule.

dateTimeRule

object (DateTimeRule)

DateTimeRule.

ManualRule

Bir kaynak veri sütunundaki değerleri, seçtiğiniz adlara sahip gruplar halinde 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 = 'Merkezi', items = ['AL', 'AR', 'IA', ...]) sağlayarak nüfusu saat dilimine göre toplayan bir pivot tabloya dönüştürülebilir. Kaynak verilere saat dilimi sütunu eklenerek ve pivot tablonun ayarlanarak da benzer bir etki elde edilebileceğini 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 listesi ve her grup adıyla eşleşen kaynak verilerdeki ilgili öğeler.

ManualRuleGroup

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

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

object (ExtendedValue)

Dize olması gereken grup adı. Belirli bir ManualRule içindeki her grubun benzersiz bir grup adı olmalıdır.

items[]

object (ExtendedValue)

Kaynak verilerdeki, bu gruba yerleştirilmesi gereken öğeler. Her öğe bir 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üzenlemenizi sağlar. HistogramRule.start ile HistogramRule.end arasındaki tüm değerler, HistogramRule.interval boyut gruplarına yerleştirilir. Ayrıca, HistogramRule.start altındaki tüm değerler bir gruba, HistogramRule.end ü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 değeri, HistogramRule.end değerinden küçük olmalıdır. Örneğin, 50'den fazla satır içeren ve yaşa göre ortalama satın alma tutarının gösterildiği bir pivot tablo: 

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

HistogramRule.start değeri 25, HistogramRule.interval değeri 20 ve HistogramRule.end değeri 65 olan bir histogram grubu kuralı uygulayarak aşağıdaki gibi 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 kovalara yerleştirildiği minimum değerdir. Başlangıç değerinin altındaki değerler tek bir grupta toplanır. Bu alan isteğe bağlıdır.

end

number

Öğelerin sabit boyutlu kovalara yerleştirildiği maksimum değerdir. Sonun üzerindeki değerler tek bir grupta yer alı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çilen kısımlarına göre gruplar halinde düzenlemenizi sağlar. Örneğin, tarihe göre satış işlemlerini 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 tarihli bir tarih-saat grubu kuralı uygulandığında aşağıdaki pivot tablo elde edilir. 

+--------------+--------------+
| 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ının türü.

DateTimeRuleType

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

Sıralamalar
DATE_TIME_RULE_TYPE_UNSPECIFIED Varsayılan tür, kullanmayın.
SECOND Tarihleri saniyeye göre 0 ile 59 arasında gruplandırın.
MINUTE Tarihleri dakikaya göre (0 ile 59 arasında) gruplandırın.
HOUR Tarihleri 24 saatlik bir sistem kullanarak 0'dan 23'e kadar saate göre gruplandırın.
HOUR_MINUTE Tarihleri 24 saatlik bir sistem kullanarak saate ve dakikaya göre gruplandırın (ör. 19:45).
HOUR_MINUTE_AMPM Tarihleri 12 saatlik bir sistem kullanarak saate ve dakikaya göre gruplandırın (ör. 19:45). ÖÖ/ÖS tanımlaması 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 gününe göre (1 ile 366 arasında) gruplandırın. 29 Şubat'tan sonraki tarihlerin, artık yıllarda, artık olmayan yıllarda farklı gruplara denk düştüğünü unutmayın.
DAY_OF_MONTH Tarihleri ayın gününe göre (1 ile 31 arasında) gruplandırın.
DAY_MONTH Tarihleri güne ve aya göre gruplandırın (ör. 22-Kasım). Ay, e-tablonun 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 üç aylık döneme göre gruplandırın, örneğin 1. Çeyrek (Ocak-Mart'ı temsil eder).
YEAR Tarihleri yıla göre gruplandırın (örneğin, 2008).
YEAR_MONTH Tarihleri yıla ve aya göre gruplandırın (ör. 2008-Kasım. Ay, e-tablonun yerel ayarına göre çevrilir.)
YEAR_QUARTER Tarihleri yıla ve üç aylık döneme göre gruplandırın (ör. 2008 4. Çeyrek).
YEAR_MONTH_DAY Tarihleri yıla, aya ve güne göre gruplandırın (ör. 2008-11-22).

PivotGroupLimit

Pivot grubundaki 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üşük olan sipariş numarasından üst sipariş numarasına uygulanır. Sipariş numaraları, 0'dan sonraki ardışık tam sayılara normalleştirilir.

Yazma isteklerinde, uygulanan siparişleri tam olarak özelleştirmek için tüm pivot grup sınırlarında bu alan benzersiz bir sayıyla ayarlanmalıdır. Aksi takdirde, sıra PivotTable.rows listesi ve ardından PivotTable.columns listesindeki dizin tarafından belirlenir.

PivotFilterCriteria

Pivot tablodaki 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 değeri bunu geçersiz kılmaz. Burada bir değer listelenmiş olsa bile, koşulu karşılamıyorsa gizli olarak kalır.)

A1 gösterimindeki aralıklara başvuruda bulunan koşul değerleri pivot tablo sayfasına göre değerlendirilir. Referanslar mutlak şekilde ele alındığından pivot tabloda 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 başvurulabilir. Ö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 uygulanmışsa yalnızca "Gelir" > "Maliyet" sütunları dahil edilir.

visibleByDefault

boolean

Değerlerin varsayılan olarak görünür olup olmadığı. True (doğru) değerine ayarlanırsa visibleValues yok sayılır ve condition değerini karşılayan tüm değerler (belirtilmişse) gösterilir. Yanlış ise hem visibleValues içinde olan hem de condition değerini karşılayan değerler gösterilir.

PivotFilterSpec

Belirli bir kaynak sütun uzaklığıyla 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ütuna ilişkin ölçütler.

Birleşim alanı source. Bu filtrenin geçerli olduğu kaynak sütun. source aşağıdakilerden yalnızca 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 hesaplanması gerektiğinin 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 ayarlanırsa yalnızca SUM ve CUSTOM değerleri desteklenir. sourceColumnOffset ayarlanırsa CUSTOM desteklenmez.

name

string

Değer için kullanılacak bir ad.

calculatedDisplayType

enum (PivotValueCalculatedDisplayType)

Belirtilirse pivot değerlerin, başka bir pivot değerle yapılan hesaplamanın sonucu olarak görüntülenmesi gerektiğini belirtir. Örneğin, ComputeDisplayType PERCENT_OF_GRAND_TOTAL olarak belirtilirse, tüm pivot değerler genel toplamın yüzdesi olarak gösterilir. E-Tablolar düzenleyicisinde bu, pivot tablonun değer bölümünde "Farklı Göster" olarak adlandırılır.

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

integer

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

Örneğin, kaynak C10:E15 ise 0 değerine sahip sourceColumnOffset değeri, C sütununu, 1 farkı ise D sütununu belirtir.

formula

string

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

dataSourceColumnReference

object (DataSourceColumnReference)

Bu değerin veri okuduğu veri kaynağı sütununa başvuru.

PivotValueSummarizeFunction

Pivot değeri özetleyen bir işlev.

Sıralamalar
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED Varsayılan değerdir, bu değeri kullanma.
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ılması gerektiğini belirtir. Yalnızca PivotValue.formula ayarlanmışsa geçerlidir.
NONE Değerin zaten özetlendiğini ve özetleme işlevinin açıkça belirtilmediğini belirtir. Değerin zaten özetlendiği Looker veri kaynağı pivot tabloları için kullanılır.

PivotValueCalculatedDisplayType

Özet değerlerinin görüntülü reklam 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, genel toplam değerlerin yüzdesi olarak gösterir.

PivotValueLayout

Pivot değerlerin düzeni.

Sıralamalar
HORIZONTAL Değerler yatay olarak (sütun olarak) gösterilir.
VERTICAL Değerler dikey olarak (satırlar olarak) yerleştirilir.