Class PivotTable

טבלתצירים

גישה ושינוי של טבלאות צירים.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
addCalculatedPivotValue(name, formula)	PivotValue	הפונקציה יוצרת ערך ציר חדש בטבלת הצירים, שמחושב מהערך שצוין ב-formula עם הערך שצוין ב-name.
addColumnGroup(sourceDataColumn)	PivotGroup	הגדרת קיבוץ חדש של עמודות ציר בטבלת הצירים.
addFilter(sourceDataColumn, filterCriteria)	PivotFilter	יצירת מסנן צירים חדש לטבלת הצירים.
addPivotValue(sourceDataColumn, summarizeFunction)	PivotValue	הגדרת ערך ציר חדש בטבלת הצירים עם הערך שצוין ב-summarizeFunction.
addRowGroup(sourceDataColumn)	PivotGroup	הגדרת קיבוץ חדש של שורות ציר בטבלת הצירים.
asDataSourcePivotTable()	DataSourcePivotTable	הפונקציה מחזירה את טבלת הצירים כטבלת צירים של מקור נתונים אם טבלת הצירים מקושרת ל-DataSource, או כ-null במקרים אחרים.
getAnchorCell()	Range	הפונקציה מחזירה את הערך Range שמייצג את התא שאליו מוצמדת טבלת הצירים.
getColumnGroups()	PivotGroup[]	הפונקציה מחזירה רשימה מסודרת של קבוצות העמודות בטבלת הצירים הזו.
getFilters()	PivotFilter[]	הפונקציה מחזירה רשימה מסודרת של המסננים בטבלת הצירים הזו.
getPivotValues()	PivotValue[]	הפונקציה מחזירה רשימה מסודרת של ערכי הצירים בטבלת הצירים הזו.
getRowGroups()	PivotGroup[]	הפונקציה מחזירה רשימה מסודרת של קבוצות השורות בטבלת הצירים הזו.
getSourceDataRange()	Range	הפונקציה מחזירה את טווח נתוני המקור שעליו נוצרה טבלת הצירים.
getValuesDisplayOrientation()	Dimension	הפונקציה מחזירה אם הערכים מוצגים כשורות או כעמודות.
remove()	void	מחיקת טבלת הצירים הזו.
setValuesDisplayOrientation(dimension)	PivotTable	הגדרת הפריסה של טבלת הצירים כך שהערכים יוצגו כעמודות או כשורות.

מסמכים מפורטים

addCalculatedPivotValue(name, formula)

הפונקציה יוצרת ערך ציר חדש בטבלת הצירים, שמחושב מהערך שצוין ב-formula עם הערך שצוין ב-name.

פרמטרים

שם	סוג	תיאור
name	String	השם של ערך הציר המחושב הזה.
formula	String	הנוסחה שמשמש לחישוב הערך הזה.

חזרה

PivotValue – ה-PivotValue שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

addColumnGroup(sourceDataColumn)

הגדרת קיבוץ חדש של עמודות ציר בטבלת הצירים. הערך שצוין בשדה sourceDataColumn מציין את העמודה בנתוני המקור שעליהם מבוסס הקיבוץ.

פרמטרים

שם	סוג	תיאור
sourceDataColumn	Integer	המספר של העמודה שהקבוצה הזו מסכם. האינדקס הזה מייצג את המספר המוחלט של העמודה בגיליון האלקטרוני. הערך 1 מייצג את העמודה 'A', הערך 2 מייצג את העמודה B וכו'.

חזרה

PivotGroup – ה-PivotGroup שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

addFilter(sourceDataColumn, filterCriteria)

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

פרמטרים

שם	סוג	תיאור
sourceDataColumn	Integer	המספר של העמודה שהקבוצה הזו מסכם. האינדקס הזה מייצג את המספר המוחלט של העמודה בגיליון האלקטרוני. הערך 1 מייצג את העמודה 'A', הערך 2 מייצג את העמודה B וכו'.
filterCriteria	FilterCriteria	קריטריוני הסינון ששימשו לביצוע הסינון.

חזרה

PivotFilter – ה-PivotFilter שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

addPivotValue(sourceDataColumn, summarizeFunction)

הגדרת ערך ציר חדש בטבלת הצירים עם הערך שצוין ב-summarizeFunction. הערך sourceDataColumn שצוין מציין את העמודה בנתוני המקור שעליה מבוסס הערך.

פרמטרים

שם	סוג	תיאור
sourceDataColumn	Integer	המספר של העמודה שהקבוצה הזו מסכם. האינדקס הזה מייצג את המספר המוחלט של העמודה בגיליון האלקטרוני. הערך 1 מייצג את העמודה 'A', הערך 2 מייצג את העמודה B וכו'.
summarizeFunction	PivotTableSummarizeFunction

חזרה

PivotValue – ה-PivotValue שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

addRowGroup(sourceDataColumn)

הגדרת קיבוץ חדש של שורות ציר בטבלת הצירים. הערך שצוין בשדה sourceDataColumn מציין את העמודה בנתוני המקור שעליהם מבוסס הקיבוץ.

פרמטרים

שם	סוג	תיאור
sourceDataColumn	Integer	המספר של העמודה שהקבוצה הזו מסכם. האינדקס הזה מייצג את המספר המוחלט של העמודה בגיליון האלקטרוני. הערך 1 מייצג את העמודה 'A', הערך 2 מייצג את העמודה B וכו'.

חזרה

PivotGroup – ה-PivotGroup שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

asDataSourcePivotTable()

הפונקציה מחזירה את טבלת הצירים כטבלת צירים של מקור נתונים אם טבלת הצירים מקושרת ל-DataSource, או כ-null במקרים אחרים.

חזרה

DataSourcePivotTable – טבלת צירים של מקור נתונים.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getAnchorCell()

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

חזרה

Range – תא העוגן של טבלת הצירים הזו

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getColumnGroups()

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

חזרה

PivotGroup[] – קבוצות העמודות בטבלת הצירים הזו

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getFilters()

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

חזרה

PivotFilter[] – המסננים בטבלת הצירים הזו

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getPivotValues()

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

חזרה

PivotValue[] – ערכי הצירים בטבלת הצירים הזו

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getRowGroups()

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

חזרה

PivotGroup[] – קבוצות השורות בטבלת הצירים הזו

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getSourceDataRange()

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

חזרה

Range – טווח נתוני המקור של טבלת הצירים הזו.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getValuesDisplayOrientation()

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

חזרה

Dimension — אם הערכים מוצגים כשורות או כעמודות

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

remove()

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

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setValuesDisplayOrientation(dimension)

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

פרמטרים

שם	סוג	תיאור
dimension	Dimension	המאפיין שמציין איך להציג את ערכי הציר.

חזרה

PivotTable – טבלת הצירים לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets