טבלת צירים
טבלת צירים.
ייצוג JSON |
---|
{ "rows": [ { object ( |
שדות | |
---|---|
rows[]
|
כל קיבוץ שורות בטבלת הצירים. |
columns[]
|
כל קיבוץ עמודות בטבלת הצירים. |
criteria
|
מיפוי אופציונלי של מסננים לכל היסט של עמודות המקור. המערכת מחילה את המסננים לפני צבירה של נתונים בטבלת הצירים. המפתח של המפה הוא ההיסט של העמודה מטווח המקור שרוצים לסנן, והערך הוא הקריטריונים לעמודה הזו.
לדוגמה, אם המקור היה
השדה הזה הוצא משימוש והוקצה לטובת |
filterSpecs[]
|
המסננים שהוחלו על עמודות המקור לפני צבירה של נתונים מטבלת הצירים.
גם
|
values[]
|
רשימת ערכים שצריך לכלול בטבלת הצירים. |
valueLayout
|
האם יש לציין את הערכים באופן אופקי (כעמודות) או בצורה אנכית (כשורות). |
dataExecutionStatus
|
פלט בלבד. סטטוס ביצוע הנתונים בטבלאות צירים של מקור נתונים. |
שדה איחוד
source_data . מקור הנתונים בטבלת הצירים.
source_data
יכול להיות רק אחד מהבאים:
|
|
source
|
הטווח שטבלת הצירים קוראת ממנו נתונים. |
dataSourceId
|
המזהה של מקור הנתונים שטבלת הצירים קוראת ממנו נתונים. |
קבוצת צירים
קיבוץ יחיד (שורה או עמודה) בטבלת צירים.
ייצוג JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
שדות | |
---|---|
showTotals
|
הערך הוא True אם טבלת הצירים צריכה לכלול את הסכומים הכוללים עבור הקיבוץ הזה. |
valueMetadata[]
|
מטא-נתונים על ערכים בקבוצה. |
sortOrder
|
סדר המיון של הערכים בקבוצה הזו. |
valueBucket
|
הקטגוריה של קבוצת הצירים שמעליהם רוצים למיין. אם לא צוין אחרת, הערכים בקבוצה הזו מוצגים בסדר אלפביתי. |
repeatHeadings
|
הערך הוא True אם הכותרות בקבוצת הצירים צריכות לחזור על עצמן. הערך הזה רלוונטי רק לקיבוצי שורות, והמערכת מתעלמת ממנו בעמודות. כברירת מחדל, אנחנו מצמצמים את מספר החזרות בכותרות ולא מציגים כותרות ברמה גבוהה יותר באותו אופן. לדוגמה, למרות שהשורה השלישית שבהמשך תואמת ל "רבעון 1", השורה "רבעון 1" לא מוצגת מאחר שהיא מיותרת משורות קודמות. אם מגדירים כותרות כותרת שחוזרות על עצמן כ-True, חזרה של ה "Q1" תגרום ל "פבר" ול "מרץ".
|
label
|
התוויות לשימוש בקבוצות של השורות/העמודות, שניתן להתאים אישית. לדוגמה, בטבלת הצירים הבאה, תווית השורה היא
|
groupRule
|
כלל הקבוצה שיש להחיל על קבוצת השורות/עמודות הזו. |
groupLimit
|
מגבלת השורות או העמודות שצריך להחיל על קבוצת הצירים הזו. |
שדה איחוד
source . מקור הנתונים של קבוצת הצירים.
source
יכול להיות רק אחד מהבאים:
|
|
sourceColumnOffset
|
ההיסט של העמודות בטווח הטווחים שעליו מבוסס הקיבוץ הזה.
לדוגמה, אם המקור היה
|
dataSourceColumnReference
|
ההפניה לעמודה של מקור הנתונים שעליה מבוסס הקיבוץ הזה. |
מטא-נתונים של PivotGroupValue
מטא-נתונים על ערך בקיבוץ צירים.
ייצוג JSON |
---|
{
"value": {
object (
|
שדות | |
---|---|
value
|
הערך המחושב שאליו המטא-נתונים תואמים. (לתשומת ליבך:
|
collapsed
|
הערך הוא True אם הנתונים התואמים לערך מכווץ. |
טבלת צירים ב-PivotGroupמיון
מידע על הערכים בקבוצת צירים שיש להשתמש בהם למיון.
ייצוג JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object (
|
שדות | |
---|---|
valuesIndex
|
הקיזוז ברשימה |
buckets[]
|
קובע את הקטגוריה שממנה בוחרים את הערכים. לדוגמה, בטבלת צירים עם קבוצת שורות אחת ושתי קבוצות עמודות, קבוצת השורות יכולה לכלול עד שני ערכים. הערך הראשון תואם לערך בקבוצת העמודות הראשונה, והערך השני תואם לערך בקבוצת העמודות השנייה. אם לא מצוינים ערכים, פירוש הדבר שיש למיין את השורה בהתאם ל'סך הכולל של שורות' בכל קבוצות העמודות. אם מופיע ערך בודד, הערך צריך להתאים ל'סה"כ' של הקטגוריה הזו. |
טבלת צירים
הגדרה אופציונלית ב-PivotGroup
שמגדירה את הערכים עבור הערכים בעמודת נתוני המקור, במקום להציג פירוט של כל ערך בנפרד. אפשר להוסיף לכל עמודה בנתוני המקור רק PivotGroup
אחד עם כלל קבוצה, אבל בכל עמודה נתונה אפשר להוסיף גם
PivotGroup
שכולל כלל וגם PivotGroup
שלא מציין כלל.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
rule . הכלל שיש להחיל על PivotGroup .
rule
יכול להיות רק אחד מהבאים:
|
|
manualRule
|
א. |
histogramRule
|
א. |
dateTimeRule
|
א. |
כלל ידני
אפשר לארגן את הערכים בעמודת נתוני המקור באופן ידני לפי קטגוריות עם שמות לבחירתכם. לדוגמה, טבלת צירים שאוספת אוכלוסייה לפי מדינה:
+-------+-------------------+
| 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[]
|
רשימת שמות הקבוצות והפריטים התואמים מנתוני המקור שממופים לכל שם קבוצה. |
קבוצת מרוץ ידני
שם קבוצה ורשימה של פריטים מנתוני המקור שצריכים להיות בקבוצה עם השם הזה.
ייצוג JSON |
---|
{ "groupName": { object ( |
שדות | |
---|---|
groupName
|
שם הקבוצה, שצריך להיות מחרוזת. לכל קבוצה
ב- |
items[]
|
הפריטים בנתוני המקור שצריך להוסיף לקבוצה הזו. כל פריט יכול להיות מחרוזת, מספר או ערך בוליאני. הפריטים יכולים להופיע בקבוצה אחת לכל היותר בתוך
|
היסטוגרמה
אפשר לארגן את הערכים המספריים בעמודה של נתוני המקור בקטגוריות בגודל קבוע. כל הערכים בטווח שבין 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
|
הערך המקסימלי שבו הפריטים ממוקמים בקטגוריות של גודל קבוע. הערכים שמעל הקצה מקובצים בקטגוריה אחת. השדה הזה אופציונלי. |
תאריך ושעה של הכלל
אפשר לארגן את הערכים של תאריך-שעה בעמודה של נתוני מקור לפי קטגוריות על סמך חלקים נבחרים של ערכי התאריך או השעה שלהם. לדוגמה, נניח שטבלת צירים מציגה עסקאות של מכירות לפי תאריך:
+----------+--------------+
| 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
|
סוג הקיבוץ של תאריך ושעה שרוצים להחיל. |
סוג TimeTimeRuleType
הסוגים הזמינים של כללי קיבוץ לפי תאריך. במסמך הזה ההנחה היא שהלוקאל של הגיליון האלקטרוני הוא "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-11 בנובמבר. החודש מתורגם בהתבסס על הלוקאל בגיליון האלקטרוני. |
MONTH
|
קיבוץ תאריכים לפי חודש, לדוגמה: נובמבר. החודש מתורגם לפי המיקום בגיליון האלקטרוני. |
QUARTER
|
קיבוץ תאריכים לפי רבעון. לדוגמה, רבעון 1 (שמייצג את ינואר עד מרץ). |
YEAR
|
קיבוץ תאריכים לפי שנה, לדוגמה 2008. |
YEAR_MONTH
|
קיבוץ תאריכים לפי שנה וחודש, לדוגמה 2008-נוב'. החודש מתורגם לפי המיקום בגיליון האלקטרוני. |
YEAR_QUARTER
|
קיבוץ תאריכים לפי שנה ורבעון, לדוגמה, 2008 ברבעון 4. |
YEAR_MONTH_DAY
|
קיבוץ תאריכים לפי שנה, חודש ויום, לדוגמה 2008-11-22. |
הגבלת קבוצת צירים
מגבלת השורות או העמודות בקבוצת הצירים.
ייצוג JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
שדות | |
---|---|
countLimit
|
מגבלת הספירה. |
applyOrder
|
הסדר שבו מגבלת הקבוצה חלה על טבלת הצירים. המגבלות של קבוצות צירים חלות על מספר הזמנות נמוך עד גבוה יותר. מספרי הזמנות מנורמלים למספרים שלמים מ-0 ברציפות.
בבקשת כתיבה, כדי להתאים אישית באופן מלא את ההזמנות החלות, צריך להגדיר בשדה הזה את כל המגבלות החלות על קבוצת הצירים. אחרת, הסדר נקבע על ידי האינדקס ברשימה |
קריטריון לטבלת צירים
קריטריונים להצגה/הסתרה של שורות בטבלת צירים.
ייצוג JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
שדות | |
---|---|
visibleValues[]
|
הערכים שצריך לכלול. ערכים שאינם מפורטים כאן אינם נכללים. |
condition
|
התנאי חייב להתקיים כדי שהערכים יוצגו. (
ערכי תנאים שמפנים לטווחים בסימון A1 מוערכים ביחס לגיליון בטבלת הצירים. ההפניות מטופלות באופן מוחלט, כך שהן לא ממולאות בטבלת הצירים. לדוגמה, ערך תנאי של
אפשר להפנות לנתוני המקור של טבלת הצירים לפי שם העמודה. לדוגמה, אם נתוני המקור כוללים עמודות בשם "הכנסה" ו "עלות", ותנאי מסוים חל על העמודה "הכנסה" מסוג |
visibleByDefault
|
אם הערכים גלויים כברירת מחדל. אם הערך הוא True, המערכת מתעלמת מהשדה |
מפרט PivotFilter
הקריטריונים לסינון טבלאות הצירים שמשויכים לקיזוז של עמודת מקור ספציפית.
ייצוג JSON |
---|
{ "filterCriteria": { object ( |
שדות | |
---|---|
filterCriteria
|
הקריטריונים של העמודה. |
שדה איחוד
source . עמודת המקור שהמסנן הזה חל עליה.
source
יכול להיות רק אחד מהבאים:
|
|
columnOffsetIndex
|
הקיזוז של עמודה המבוססת על אפס של טווח המקור. |
dataSourceColumnReference
|
ההפניה לעמודה של מקור הנתונים. |
ערך ציר
ההגדרה של אופן החישוב של ערך בטבלת צירים.
ייצוג JSON |
---|
{ "summarizeFunction": enum ( |
שדות | |
---|---|
summarizeFunction
|
פונקציה המסכמת את הערך. אם הערך |
name
|
שם שאפשר להשתמש בו עבור הערך. |
calculatedDisplayType
|
אם ציינת ערכים, יש להציג את ערכי הצירים שנובעים מחישוב עם ערך ציר אחר. לדוגמה, אם הפרמטר DisplayDisplayType מוגדר כ-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
הוגדר.
|
סוג טבלת צירים מחושב
הדרכים האפשריות לחישוב ערכי צירים להצגה.
טיפוסים בני מנייה (enum) | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
ערך ברירת המחדל, לא להשתמש. |
PERCENT_OF_ROW_TOTAL
|
הצגת ערכי הצירים כאחוז מהערך הכולל של השורות. |
PERCENT_OF_COLUMN_TOTAL
|
הצגת ערכי הצירים כאחוז מהערך הכולל של העמודות. |
PERCENT_OF_GRAND_TOTAL
|
מציגה את ערכי הצירים כאחוזים מסך כל הערכים. |
פריסת צירים
הפריסה של ערכי הצירים.
טיפוסים בני מנייה (enum) | |
---|---|
HORIZONTAL
|
הערכים מסודרים אופקית (כעמודות). |
VERTICAL
|
הערכים מסודרים אנכית (כשורות). |