Pivot Tables

{
  "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.
}

object (PivotGroup)

כל קיבוץ שורות בטבלת הצירים.

object (PivotGroup)

כל קיבוץ של עמודות בטבלת הצירים.

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

מיפוי אופציונלי של מסננים לכל היסט של עמודת מקור.

המערכת מחילה את המסננים לפני צבירת נתונים בטבלת הצירים. המפתח של המפה הוא ההיסט של העמודה מטווח המקור שרוצים לסנן, והערך הוא הקריטריונים של העמודה הזו.

לדוגמה, אם המקור היה C10:E15, מפתח של 0 יהיה מסנן לעמודה C, ואילו המפתח 1 הוא לעמודה D

השדה הזה הוצא משימוש לטובת filterSpecs

object (PivotFilterSpec)

המסננים שהוחלו על עמודות המקור לפני צבירת הנתונים לטבלת הצירים.

שתי השיטות criteria וגם filterSpecs מאוכלסים בתגובות. אם שני השדות מצוינים בבקשת עדכון, השדה הזה מקבל עדיפות.

object (PivotValue)

רשימת ערכים שייכללו בטבלת הצירים.

enum (PivotValueLayout)

האם הערכים צריכים להופיע לרוחב (כעמודות) או לאורך (כשורות).

object (DataExecutionStatus)

פלט בלבד. סטטוס הפעלת הנתונים לטבלאות הצירים של מקור הנתונים.

object (GridRange)

הטווח שממנו מתבצעת קריאה של הנתונים בטבלת הצירים.

string

המזהה של מקור הנתונים שממנו מתבצעת קריאה של הנתונים בטבלת הצירים.

{
  "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.
}

boolean

הערך הוא True אם טבלת הצירים צריכה לכלול את הסכומים הכוללים של הקיבוץ הזה.

object (PivotGroupValueMetadata)

מטא-נתונים על ערכים בקיבוץ.

enum (SortOrder)

יש למיין את הערכים בקבוצה הזו.

object (PivotGroupSortValueBucket)

הקטגוריה של קבוצת הצירים הנגדית שרוצים למיין. אם לא צוין אחרת, המיון יהיה לפי סדר האלף-בית לפי ערכי הקבוצה.

boolean

True אם יש לחזור על הכותרות בקבוצת הצירים הזאת. ההגדרה הזו תקפה רק לקיבוצים של שורות, והעמודות מתעלמות ממנה.

כברירת מחדל, אנחנו מצמצמים חזרה על כותרות על ידי כך שאנחנו לא מציגים כותרות ברמה גבוהה יותר שהן זהות. לדוגמה, למרות שהשורה השלישית למטה תואמת לרבעון 1 במרץ, לרבעון 1 לא מוצגת כי היא מיותרת ביחס לשורות הקודמות. הגדרת כותרות חוזרות כ-true תגרום ל-"Q1" בשביל לחזור על התקופה "פברואר" ו-'Mar'.

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+

string

התוויות שבהן צריך להשתמש בקבוצות של השורות/העמודות הניתנות להתאמה אישית. לדוגמה, בטבלת הצירים הבאה, תווית השורה היא Region (שניתן לשנות את שמו ל- State) ותווית העמודה היא Product (שניתן לשנות את שמו Item). לטבלאות צירים שנוצרו לפני דצמבר 2017 אין תוויות של כותרות. כדי להוסיף תוויות כותרת לטבלת צירים קיימת, יש למחוק את טבלת הצירים הקיימת ואז ליצור טבלת צירים חדשה עם אותם פרמטרים.

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+

object (PivotGroupRule)

הכלל הקבוצתי שצריך להחיל על קבוצת השורות/העמודות הזו.

object (PivotGroupLimit)

מגבלת המקסימום על שורות או עמודות שיש להחיל על קבוצת הצירים הזו.

integer

ההיסט של העמודה בטווח המקור שעליו מבוססת הקיבוץ הזה.

לדוגמה, אם המקור היה C10:E15, A sourceColumnOffset מתוך 0 כלומר, הקבוצה מתייחסת לעמודה C, ואילו הקיזוז 1 יתייחס לעמודה D.

object (DataSourceColumnReference)

ההפניה לעמודה של מקור הנתונים שעליה מבוססת הקיבוץ הזה.

{
  "value": {
    object (ExtendedValue)
  },
  "collapsed": boolean
}

object (ExtendedValue)

הערך המחושב שאליו מתייחסים המטא-נתונים. (שימו לב: formulaValue אינו חוקי, מפני שהערכים יחושבו).

boolean

הערך הוא True אם הנתונים שתואמים לערך מכווצים.

{
  "valuesIndex": integer,
  "buckets": [
    {
      object (ExtendedValue)
    }
  ]
}

integer

קיזוז PivotTable.values שלפיהם יתבצע מיון של הערכים בקיבוץ הזה.

object (ExtendedValue)

המדיניות קובעת את הקטגוריה שממנה נבחרו הערכים למיון.

לדוגמה, בטבלת צירים שמכילה קבוצה אחת של שורות & שתי קבוצות של עמודות, קבוצת השורות יכולה להציג עד שני ערכים. הערך הראשון תואם לערך מתוך קבוצת העמודות הראשונה, והערך השני תואם לערך בקבוצת העמודות השנייה. אם לא רשומים ערכים, סימן שצריך למיין את השורה לפי 'סכום כולל'. מעל קבוצות העמודות. אם מופיע ערך יחיד, הערך הזה תואם לשימוש בעמודה 'סה"כ' של הקטגוריה הזו.

{

  // 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.
}

object (ManualRule)

א' ManualRule

object (HistogramRule)

א' HistogramRule

object (DateTimeRule)

א' DateTimeRule

{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}

object (ManualRuleGroup)

הרשימה של שמות הקבוצות והפריטים התואמים מנתוני המקור שממופים לכל שם של קבוצה.

{
  "groupName": {
    object (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}

object (ExtendedValue)

שם הקבוצה, שחייב להיות מחרוזת. כל קבוצה בעמודה נתונה ManualRule חייב להיות שם קבוצה ייחודי.

object (ExtendedValue)

הפריטים בנתוני המקור שצריך להוסיף לקבוצה הזו. כל פריט יכול להיות מחרוזת, מספר או ערך בוליאני. פריטים יכולים להופיע בקבוצה אחת לכל היותר ManualRule פריטים שלא מופיעים באף קבוצה יופיעו לבד.

{
  "interval": number,
  "start": number,
  "end": number
}

number

גודל הקטגוריות שנוצרות. חייב להיות חיובי.

number

הערך המינימלי שבו פריטים ממוקמים בקטגוריות בגודל קבוע. הערכים שלמטה 'התחלה' מאוחסנים בקטגוריה אחת. השדה הזה הוא אופציונלי.

number

הערך המקסימלי שבו פריטים יוצבו בקטגוריות בגודל קבוע. הערכים שלמעלה מקובצים בקטגוריה אחת. השדה הזה הוא אופציונלי.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

סוג הקיבוץ לפי תאריך ושעה שיחולו.

{
  "countLimit": integer,
  "applyOrder": integer
}

integer

מגבלת הספירה.

integer

הסדר שבו חלה הגבלה על הקבוצה בטבלת הצירים.

המערכת מחילה מגבלות על קבוצות צירים מהערך הנמוך לגבוה. מספרי ההזמנות מנורמלים למספרים שלמים עוקבים מ-0.

לבקשת כתיבה, כדי להתאים אישית באופן מלא את החלת ההזמנות, יש להגדיר מספר ייחודי בכל המגבלות של קבוצת הצירים. אחרת, הסדר נקבע על ידי האינדקס PivotTable.rows ואז את PivotTable.columns חדשה.

{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}

string

הערכים שצריך לכלול. ערכים שלא מופיעים כאן אינם נכללים.

object (BooleanCondition)

תנאי שחייב להתקיים כדי שהערכים יוצגו. ( visibleValues אינה מבטלת את ההגדרה הזו – גם אם ערך מופיע שם, הוא עדיין מוסתר אם הוא לא עומד בתנאי).

ערכים של תנאים שמפנים לטווחים בסימון A1 מוערכים ביחס לגיליון של טבלת הצירים. ההתייחסות להפניות מתבצעת בצורה מוחלטת, כך שלא ממלאים את טבלת הצירים. לדוגמה, ערך התנאי של =A1 ב-"טבלת צירים 1" נחשב בתור 'Pivot Table 1'!$A$1.

אפשר להפנות לנתוני המקור של טבלת הצירים לפי שם כותרת העמודה. לדוגמה, אם לנתוני המקור יש עמודות בשם 'הכנסה'. וגם בעמודה 'עלות' והתנאי חל על השדה Revenue [הכנסה] עמודה עם סוג NUMBER_GREATER וערך =Cost, ואז רק עמודות שבהן 'הכנסה' > עלות כלולים.

boolean

האם הערכים גלויים כברירת מחדל. אם True, visibleValues המערכת מתעלמת, כל הערכים שעומדים בקריטריונים condition (אם צוין) מוצגים. אם False, ערכים ששניהם נכללים visibleValues ופוגשים condition מוצגות.

{
  "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.
}

object (PivotFilterCriteria)

הקריטריונים לעמודה.

integer

קיזוז העמודות שמבוסס על אפס מטווח המקור.

object (DataSourceColumnReference)

ההפניה לעמודה של מקור הנתונים.

{
  "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.
}

enum (PivotValueSummarizeFunction)

פונקציה שמסכמת את הערך. אם המיקום formula מוגדר, הערכים היחידים שנתמכים הם SUM וגם CUSTOM. אם המיקום sourceColumnOffset מוגדרת, אז CUSTOM אין תמיכה.

string

שם לשימוש עבור הערך.

enum (PivotValueCalculatedDisplayType)

אם השדה הזה מוגדר, המשמעות היא שיש להציג את ערכי הציר כתוצאה מחישוב עם ערך ציר אחר. לדוגמה, אם מחושב DisplayType מוגדר כ-PERCENT_OF_GRAND_TOTAL, כל ערכי הציר מוצגים כאחוז מהסכום הכולל. בעורך Sheets, פעולה זו נקראת 'הצגה בשם' בקטע הערכים בטבלת הצירים.

integer

ההיסט של העמודה של טווח המקור שממנו הערך הזה נקרא.

לדוגמה, אם המקור היה C10:E15, A sourceColumnOffset מתוך 0 כלומר, הערך הזה מתייחס לעמודה C, ואילו הקיזוז 1 יתייחס לעמודה D.

string

נוסחה מותאמת אישית לחישוב הערך. הנוסחה חייבת להתחיל במחרוזת = .

object (DataSourceColumnReference)

ההפניה לעמודה של מקור הנתונים שממנה הערך הזה נקרא.