PivotTable
טבלת צירים.
ייצוג ב-JSON |
---|
{ "rows": [ { object ( |
שדות | |
---|---|
rows[]
|
כל קיבוץ של שורות בטבלת הצירים. |
columns[]
|
כל קיבוץ של עמודות בטבלת הצירים. |
criteria
|
מיפוי אופציונלי של מסננים לכל היסט של עמודת מקור. המסננים מוחלים לפני שמצטברים נתונים בטבלת הצירים. המפתח של המפה הוא היסט העמודה של טווח המקור שרוצים לסנן, והערך הוא הקריטריונים של אותה עמודה.
לדוגמה, אם המקור היה
השדה הזה הוצא משימוש והוחלף על ידי השדה |
filterSpecs[]
|
המסננים שהוחלו על עמודות המקור לפני צבירת הנתונים לטבלת הצירים.
גם השדה |
values[]
|
רשימת ערכים שרוצים לכלול בטבלת הצירים. |
valueLayout
|
האם הערכים יופיעו באופן אופקי (כעמודות) או באופן אנכי (כשורות). |
dataExecutionStatus
|
פלט בלבד. סטטוס ההפעלה של הנתונים בטבלאות צירים של מקורות נתונים. |
שדה האיחוד
source_data . המקור של נתוני טבלת הצירים.
source_data
יכול להיות רק אחד מהערכים הבאים:
|
|
source
|
הטווח שממנו טבלת הצירים קוראת נתונים. |
dataSourceId
|
המזהה של מקור הנתונים שממנו טבלת הצירים קוראת נתונים. |
PivotGroup
קיבוץ יחיד (שורה או עמודה) בטבלת צירים.
ייצוג ב-JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
שדות | |
---|---|
showTotals
|
הערך True (נכון) אם טבלת הצירים צריכה לכלול את הסכומים הכוללים של הקיבוץ הזה. |
valueMetadata[]
|
מטא-נתונים לגבי ערכים בקיבוץ. |
sortOrder
|
הסדר שבו צריך למיין את הערכים בקבוצה הזו. |
valueBucket
|
הקטגוריה של קבוצת הצירים הנגדית שעל סמךה יתבצע המיון. אם לא מציינים את הערך, הסדר הוא אלפביתי לפי הערכים של הקבוצה הזו. |
repeatHeadings
|
הערך True (נכון) אם צריך לחזור על הכותרות בקבוצת הצירים הזו. האפשרות הזו תקפה רק לקיבוצי שורות, והיא מתעלמת מעמודות. כברירת מחדל, אנחנו מצמצמים את החזרה על כותרות על ידי אי-הצגת כותרות ברמה גבוהה יותר כשהן זהות. לדוגמה, למרות שהשורה השלישית שלמטה תואמת ל-'רבעון 1 מרץ', השורה 'רבעון 1' לא מוצגת כי היא יתירה ביחס לשורות הקודמות. הגדרת repeatHeadings כ-true תגרום לחזרה על 'רבעון 1' עבור 'פברואר' ו'מרץ'.
|
label
|
התוויות שישמשו לקבוצות של השורות או העמודות, שניתן להתאים אישית. לדוגמה, בטבלת הצירים הבאה, תווית השורה היא
|
groupRule
|
כלל הקבוצה שיחול על קבוצת השורות או העמודות הזו. |
groupLimit
|
מגבלת המספר של השורות או העמודות שחלה על קבוצת הצירים הזו. |
שדה האיחוד
source . מקור הנתונים של קבוצת הצירים.
source
יכול להיות רק אחד מהערכים הבאים:
|
|
sourceColumnOffset
|
היסט העמודה של טווח המקור שעליו מבוסס הקיבוץ הזה.
לדוגמה, אם המקור היה |
dataSourceColumnReference
|
ההפניה לעמודה של מקור הנתונים שעל בסיסה מתבצע הקיבוץ. |
PivotGroupValueMetadata
מטא-נתונים לגבי ערך בקיבוץ של טבלת צירים.
ייצוג ב-JSON |
---|
{
"value": {
object ( |
שדות | |
---|---|
value
|
הערך המחושב שהמטא-נתונים תואמים אליו. (שימו לב שהערך |
collapsed
|
הערך True מוחזר אם הנתונים התואמים לערך מכווצים. |
PivotGroupSortValueBucket
מידע על הערכים בקבוצת ציר שצריך להשתמש בהם למיון.
ייצוג ב-JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object ( |
שדות | |
---|---|
valuesIndex
|
ההיסט ברשימה |
buckets[]
|
קובע את הקטגוריה שממנה נבחרים ערכים למיון. לדוגמה, בטבלת צירים עם קבוצת שורות אחת ושתי קבוצות של עמודות, קבוצת השורות יכולה לכלול עד שני ערכים. הערך הראשון תואם לערך בקבוצת העמודות הראשונה, והערך השני תואם לערך בקבוצת העמודות השנייה. אם לא מופיעים ערכים, סימן שצריך למיין את השורה לפי 'סה"כ כולל' מעל קבוצות העמודות. אם מופיע ערך יחיד, המשמעות היא שייעשה שימוש ב'סה"כ' של הקטגוריה הזו. |
PivotGroupRule
הגדרה אופציונלית ב-PivotGroup
שמגדירה קטגוריות לערכים בעמודת נתוני המקור, במקום לפרט כל ערך בנפרד. אפשר להוסיף רק PivotGroup
אחד עם כלל קבוצה לכל עמודה בנתוני המקור, אבל בכל עמודה נתונה אפשר להוסיף גם PivotGroup
עם כלל וגם PivotGroup
בלי כלל.
ייצוג ב-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
וגם את HistogramRule.end
, הערך של HistogramRule.start
חייב להיות קטן מ-HistogramRule.end
. לדוגמה, טבלת צירים שמציגה את סכום הרכישה הממוצע לפי גיל, עם יותר מ-50 שורות:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
אפשר להפוך אותה לטבלת צירים שמזכירה את הטבלה הבאה על ידי החלת כלל קיבוץ של היסטוגרמה עם HistogramRule.start
של 25, HistogramRule.interval
של 20 ו-HistogramRule.end
של 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
|
הערך המינימלי שבו פריטים מועברים לקטגוריות (buckets) בגודל קבוע. ערכים מתחת ל-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', אבל הפורמט בפועל של התאריכים והשעות משתמש בלוקאל של הגיליון האלקטרוני בסוגים מסוימים של כללים.
טיפוסים בני מנייה (enum) | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
סוג ברירת המחדל, אין להשתמש בו. |
SECOND
|
קיבוץ תאריכים לפי שנייה, מ-0 עד 59. |
MINUTE
|
קיבוץ תאריכים לפי דקות, מ-0 עד 59. |
HOUR
|
קיבוץ תאריכים לפי שעה באמצעות מערכת של 24 שעות, מ-0 עד 23. |
HOUR_MINUTE
|
כדאי לקבץ תאריכים לפי שעה ודקה לפי שעון בן 24 שעות, לדוגמה 19:45. |
HOUR_MINUTE_AMPM
|
קיבוץ תאריכים לפי שעה ודקה לפי מערכת של 12 שעות, לדוגמה 19:45. ההמרה של השמות AM/PM מתבצעת על סמך השפה והאזור שמוגדרים בגיליון האלקטרוני. |
DAY_OF_WEEK
|
קיבוץ תאריכים לפי יום בשבוע, למשל יום ראשון. ימי השבוע יתורגו בהתאם ללוקאל של הגיליון האלקטרוני. |
DAY_OF_YEAR
|
קיבוץ תאריכים לפי יום בשנה, מ-1 עד 366. לתשומת ליבכם: תאריכים אחרי 29 בפברואר נכללים בקטגוריות שונות בשנים מעוברות מאשר בשנים לא מעוברות. |
DAY_OF_MONTH
|
קיבוץ תאריכים לפי היום בחודש, מ-1 עד 31. |
DAY_MONTH
|
קיבוץ תאריכים לפי יום וחודש, לדוגמה 22-Nov. החודש מתורגם על סמך השפה והאזור שמוגדרים בגיליון האלקטרוני. |
MONTH
|
קיבוץ תאריכים לפי חודש, למשל נובמבר. החודש מתורגם על סמך השפה והאזור שמוגדרים בגיליון האלקטרוני. |
QUARTER
|
קיבוץ תאריכים לפי רבעון, למשל Q1 (שמייצג את ינואר עד מרץ). |
YEAR
|
לקבץ תאריכים לפי שנה, למשל 2008. |
YEAR_MONTH
|
קיבוץ תאריכים לפי שנה וחודש, לדוגמה 2008-Nov. החודש מתורגם על סמך השפה והאזור שמוגדרים בגיליון האלקטרוני. |
YEAR_QUARTER
|
קיבוץ תאריכים לפי שנה ורבעון, לדוגמה: רבעון 4 של שנת 2008. |
YEAR_MONTH_DAY
|
קיבוץ תאריכים לפי שנה, חודש ויום, לדוגמה 22 בנובמבר 2008. |
PivotGroupLimit
מגבלת המספר של שורות או עמודות בקבוצת הצירים.
ייצוג ב-JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
שדות | |
---|---|
countLimit
|
מגבלת המספר. |
applyOrder
|
הסדר שבו מגבלת הקבוצה חלה על טבלת הצירים. המגבלות על קבוצות צירים חלות לפי מספר הסדר הנמוך יותר עד למספר הסדר הגבוה יותר. מספרי ההזמנות מתאימים לתקן של מספרים שלמים רצופים מ-0.
בבקשת כתיבה, כדי להתאים אישית באופן מלא את סדרי החלת ההגבלות, צריך להגדיר בשדה הזה מספר ייחודי לכל המגבלות של קבוצות הצירים. אחרת, הסדר נקבע לפי האינדקס ברשימה |
PivotFilterCriteria
קריטריונים להצגה או להסתרה של שורות בטבלת צירים.
ייצוג ב-JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object ( |
שדות | |
---|---|
visibleValues[]
|
ערכים שצריך לכלול. ערכים שלא מפורטים כאן לא נכללים. |
condition
|
תנאי שחייב להתקיים כדי שהערכים יוצגו. (הערך ב-
ערכי תנאים שמתייחסים לטווחים בסימון A1 נבדקים ביחס לגיליון של טבלת PivotTable. ההפניות מטופלות באופן מוחלט, ולכן הן לא מתמלאות במורד טבלת הצירים. לדוגמה, ערך התנאי
אפשר להפנות לנתוני המקור של טבלת הצירים לפי שם כותרת העמודה. לדוגמה, אם בנתוני המקור יש עמודות בשם 'הכנסה' ו'עלות', וחל תנאי על העמודה 'הכנסה' עם הסוג |
visibleByDefault
|
אם הערכים גלויים כברירת מחדל. אם הערך הוא True, המערכת מתעלמת מ- |
PivotFilterSpec
קריטריונים לסינון של טבלת PivotTable שמשויכים להיסט ספציפי של עמודה במקור.
ייצוג ב-JSON |
---|
{ "filterCriteria": { object ( |
שדות | |
---|---|
filterCriteria
|
הקריטריונים של העמודה. |
שדה האיחוד
source . עמודת המקור שעל אילו המסנן הזה חל.
source
יכול להיות רק אחד מהערכים הבאים:
|
|
columnOffsetIndex
|
הזזת העמודה מבוססת-האפס של טווח המקור. |
dataSourceColumnReference
|
ההפניה לעמודה של מקור הנתונים. |
PivotValue
ההגדרה של אופן החישוב של ערך בטבלת צירים.
ייצוג ב-JSON |
---|
{ "summarizeFunction": enum ( |
שדות | |
---|---|
summarizeFunction
|
פונקציה לסיכום הערך. אם המשתנה |
name
|
שם לשימוש בערך. |
calculatedDisplayType
|
אם מצוין, המשמעות היא שערכים של ציר צריכים להופיע כתוצאה מחישובים עם ערך אחר של ציר. לדוגמה, אם הערך של calculatedDisplayType מצוין כ-PERCENT_OF_GRAND_TOTAL, כל ערכי ציר הסיכום יוצגו כאחוז מסך הכול. בעורך של Sheets, האפשרות הזו נקראת 'הצגה בתור' בקטע הערכים של טבלת צירים. |
שדה האיחוד
value . הנתונים שישמשו לערכים בטבלת הצירים. חובה להגדיר ערך אחד בלבד.
value
יכול להיות רק אחד מהערכים הבאים:
|
|
sourceColumnOffset
|
ההיסט של העמודה בטווח המקור שממנו הערך הזה נקרא.
לדוגמה, אם המקור היה |
formula
|
נוסחה מותאמת אישית לחישוב הערך. הנוסחה חייבת להתחיל בתו |
dataSourceColumnReference
|
ההפניה לעמודה של מקור הנתונים שממנה הערך הזה נקרא. |
PivotValueSummarizeFunction
פונקציה לסיכום ערך ציר.
טיפוסים בני מנייה (enum) | |
---|---|
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
הדרכים האפשריות לחישוב ערכים של טבלת צירים לצורך הצגה.
טיפוסים בני מנייה (enum) | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
ערך ברירת מחדל, אין להשתמש בו. |
PERCENT_OF_ROW_TOTAL
|
הצגת ערכי הצירים כאחוז מהערכים הכוללים של השורות. |
PERCENT_OF_COLUMN_TOTAL
|
הצגת ערכי הצירים כאחוז מהערכים הכוללים בעמודה. |
PERCENT_OF_GRAND_TOTAL
|
הצגת ערכי ציר הסיבוב כאחוזים מהערכים של הסכום הכולל. |
PivotValueLayout
הפריסה של ערכי הצירים.
טיפוסים בני מנייה (enum) | |
---|---|
HORIZONTAL
|
הערכים מוצגים באופן אופקי (כעמודות). |
VERTICAL
|
הערכים מסודרים אנכית (כשורות). |