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 אם צריך לחזור על הכותרות בקבוצת הצירים הזאת. המאפיין הזה חוקי רק לקיבוצים של שורות, והעמודות מתעלמת ממנו. כברירת מחדל, אנחנו מצמצמים חזרות על כותרות על ידי אי-הצגה של כותרות ברמה גבוהה יותר כשהן זהות. לדוגמה, למרות שהשורה השלישית מתחת ל-"Q1 Mar", "Q1" לא מוצגת כי היא מיותרת בהשוואה לשורות הקודמות. הגדרה של כותרות חוזרות כ-true תגרום לחזרה על "Q1" עבור "פבר" ו "מרץ".
|
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', פריטים = ['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
|
הערך המינימלי שבו פריטים ממוקמים בקטגוריות בגודל קבוע. הערכים שמתחת להתחלה מקובצים בקטגוריה אחת. השדה הזה הוא אופציונלי. |
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', אבל העיבוד של התאריכים והשעות בפועל מתבסס על הלוקאל של הגיליון האלקטרוני בסוגים מסוימים של כללים.
טיפוסים בני מנייה (enums) | |
---|---|
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-בנובמבר. החודש מתורגם לפי הלוקאל של הגיליון האלקטרוני. |
MONTH
|
קיבוץ תאריכים לפי חודש, למשל נובמבר. החודש מתורגם בהתאם לאזור של הגיליון האלקטרוני. |
QUARTER
|
כדאי לקבץ תאריכים לפי רבעון, לדוגמה רבעון 1 (שמייצג את ינואר עד מרץ). |
YEAR
|
קיבוץ תאריכים לפי שנה, לדוגמה 2008. |
YEAR_MONTH
|
קיבוץ תאריכים לפי שנה וחודש, למשל '2008-נוב'. החודש מתורגם לפי הלוקאל של הגיליון האלקטרוני. |
YEAR_QUARTER
|
קבץ תאריכים לפי שנה ורבעון, לדוגמה 2008 רבעון 4. |
YEAR_MONTH_DAY
|
קיבוץ תאריכים לפי שנה, חודש ויום, לדוגמה 2008-11-22. |
PivotGroupLimit
מגבלת הספירה של שורות או עמודות בקבוצת הצירים.
ייצוג JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
שדות | |
---|---|
countLimit
|
מגבלת הספירה. |
applyOrder
|
הסדר שבו חלה מגבלת הקבוצה על טבלת הצירים. המגבלות על קבוצות הצירים חלות ממספר הזמנה נמוך לגבוה. מספרי ההזמנות מנורמלים למספרים שלמים עוקבים בין 0.
לבקשת כתיבה, כדי להתאים אישית באופן מלא את ההזמנות המיושמות, יש להגדיר את השדה הזה במספר ייחודי בכל המגבלות של קבוצת הצירים. אחרת, הסדר נקבע לפי האינדקס ברשימה
|
PivotFilterCriteria
קריטריונים להצגה/הסתרה של שורות בטבלת צירים.
ייצוג JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
שדות | |
---|---|
visibleValues[]
|
הערכים שצריך לכלול. ערכים שלא מפורטים כאן מוחרגים. |
condition
|
תנאי שחייב להתקיים כדי שהערכים יוצגו. (
ערכי התנאים שמפנים לטווחים בסימון A1 מוערכים ביחס לגיליון של טבלת הצירים. יש להתייחס להפניות באופן מוחלט, לכן לא ממלאים את טבלת הצירים. לדוגמה, ערך התנאי
אפשר להפנות לנתוני המקור של טבלת הצירים לפי השם של כותרת העמודה. לדוגמה, אם בנתוני המקור יש עמודות בשם Revenue (הכנסה) ו-Cost (עלות), ותנאי מסוים חל על העמודה 'Revenue' (הכנסה) עם הסוג
|
visibleByDefault
|
האם הערכים מוצגים כברירת מחדל. אם הערך הוא True, המערכת תתעלם מה
|
PivotFilterSpec
הקריטריונים לסינון טבלת הצירים המשויכים להיסט ספציפי של עמודת מקור.
ייצוג JSON |
---|
{ "filterCriteria": { object ( |
שדות | |
---|---|
filterCriteria
|
הקריטריונים של העמודה. |
שדה איחוד
source . עמודת המקור שעליה חל המסנן הזה.
source
יכול להיות רק אחד מהבאים:
|
|
columnOffsetIndex
|
היסט העמודה מבוססת-האפס של טווח המקור. |
dataSourceColumnReference
|
ההפניה לעמודה של מקור הנתונים. |
PivotValue
ההגדרה של אופן החישוב של ערך בטבלת צירים.
ייצוג JSON |
---|
{ "summarizeFunction": enum ( |
שדות | |
---|---|
summarizeFunction
|
פונקציה לסיכום הערך. אם
|
name
|
שם לשימוש עבור הערך. |
calculatedDisplayType
|
אם הערך צוין, המשמעות היא שהערכים של צירים צריכים להיות מוצגים כתוצאה מחישוב עם ערך אחר. לדוגמה, אם הפרמטר formattedDisplayType צוין כ-PERCENT_OF_GRAND_TOTAL, כל הערכים של הצירים מוצגים כאחוז מהערך הכולל. בעורך Sheets, מצב זה נקרא 'הצגה בשם' בקטע הערכים של טבלת הצירים. |
שדה איחוד
value . הנתונים שישמשו עבור הערכים בטבלת הצירים. יש להגדיר ערך אחד בדיוק.
value
יכול להיות רק אחד מהבאים:
|
|
sourceColumnOffset
|
ההיסט בעמודה של טווח המקור שממנו הערך הזה קורא.
לדוגמה, אם המקור היה
|
formula
|
נוסחה מותאמת אישית לחישוב הערך. הנוסחה חייבת להתחיל בתו |
dataSourceColumnReference
|
ההפניה לעמודה של מקור הנתונים שממנה הערך הזה קורא. |
PivotValueSummarizeFunction
פונקציה לסיכום ערך בטבלת צירים.
טיפוסים בני מנייה (enums) | |
---|---|
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
הדרכים האפשריות שבהן ערכי הציר יחושבו להצגה.
טיפוסים בני מנייה (enums) | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
ערך ברירת המחדל, אין להשתמש. |
PERCENT_OF_ROW_TOTAL
|
ערכי הצירים מוצגים כאחוז מהערכים הכוללים של השורה. |
PERCENT_OF_COLUMN_TOTAL
|
ערכי הצירים מוצגים כאחוז מהערכים הכוללים של העמודה. |
PERCENT_OF_GRAND_TOTAL
|
ערכי הציר כאחוז מהערכים הכוללים של הציר. |
PivotValueLayout
הפריסה של הערכים בציר.
טיפוסים בני מנייה (enums) | |
---|---|
HORIZONTAL
|
הערכים מסודרים לרוחב (כעמודות). |
VERTICAL
|
הערכים מפורטים בצורה אנכית (כשורות). |