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' לא מוצגת כי היא יתירה ביחס לשורות הקודמות. הגדרת כותרות חוזרות כ-true תגרום ל-"Q1" בשביל לחזור על התקופה "פברואר" ו-'Mar'.
|
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
|
מקבצים תאריכים לפי רבעון. לדוגמה, רבעון 1 (שמייצג ינואר-מרץ). |
YEAR
|
צריך לקבץ תאריכים לפי שנה, לדוגמה 2008. |
YEAR_MONTH
|
צריך לקבץ את התאריכים לפי שנה וחודש, לדוגמה 2008 עד נובמבר. החודש יתורגם לפי הלוקאל של הגיליון האלקטרוני. |
YEAR_QUARTER
|
מקבצים תאריכים לפי שנה ורבעון, לדוגמה רבעון 4 של שנת 2008. |
YEAR_MONTH_DAY
|
קבץ תאריכים לפי שנה, חודש ויום, לדוגמה 2008-11-22. |
PivotGroupLimit
מגבלת המקסימום על שורות או עמודות בקבוצת הצירים.
ייצוג JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
שדות | |
---|---|
countLimit
|
מגבלת המספר. |
applyOrder
|
הסדר שבו המגבלה על הקבוצה חלה על טבלת הצירים. המערכת מחילה מגבלות על קבוצות צירים מהערך הנמוך לגבוה. מספרי ההזמנות מנורמלים למספרים שלמים עוקבים מ-0.
לבקשת כתיבה, כדי להתאים אישית באופן מלא את החלת ההזמנות, יש להגדיר מספר ייחודי בכל המגבלות של קבוצת הצירים. אחרת, הסדר נקבע על ידי האינדקס
|
PivotFilterCriteria
הקריטריונים להצגה או להסתרה של שורות בטבלת צירים.
ייצוג ב-JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object ( |
שדות | |
---|---|
visibleValues[]
|
הערכים שצריך לכלול. ערכים שלא מפורטים כאן לא נכללים. |
condition
|
תנאי שחייב להתקיים כדי שהערכים יוצגו. (
ערכים של תנאים שמפנים לטווחים בסימון A1 מוערכים ביחס לגיליון של טבלת הצירים. ההתייחסות להפניות מתבצעת בצורה מוחלטת, כך שלא ממלאים את טבלת הצירים. לדוגמה, ערך התנאי
אפשר להפנות לנתוני המקור של טבלת הצירים לפי שם כותרת העמודה. לדוגמה, אם בנתוני המקור יש עמודות בשם 'הכנסה' ו'עלות', ותנאי חל על העמודה 'הכנסה' עם הסוג |
visibleByDefault
|
אם הערכים גלויים כברירת מחדל. אם הערך הוא True, המערכת מתעלמת מ- |
PivotFilterSpec
הקריטריונים לסינון טבלאות הצירים שמשויכים להיסט עמודת מקור ספציפית.
ייצוג ב-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
|
הערכים מסודרים אנכית (כשורות). |