גישה לקבוצות ערכים בטבלאות צירים ושינוי שלהן.
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
getDisplayType() | PivotValueDisplayType | מחזירה את סוג התצוגה שמתאר כיצד ערך הציר מוצג כרגע בטבלה. |
getFormula() | String | מחזירה את הנוסחה שמשמשת לחישוב הערך הזה. |
getPivotTable() | PivotTable | מחזירה את PivotTable שאליו שייך הערך הזה. |
getSourceDataColumn() | Integer | מחזירה את המספר של עמודת נתוני המקור שערך הציר מסכם. |
getSourceDataSourceColumn() | DataSourceColumn | מחזירה את העמודה של מקור הנתונים שמסכמת את הערך בטבלת הציר. |
getSummarizedBy() | PivotTableSummarizeFunction | מחזירה את פונקציית הסיכום של הקבוצה הזו. |
remove() | void | צריך להסיר את הערך הזה מטבלת הצירים. |
setDisplayName(name) | PivotValue | הגדרת השם המוצג של הערך הזה בטבלת הצירים. |
setFormula(formula) | PivotValue | הפונקציה מגדירה את הנוסחה שמשמשת לחישוב הערך הזה. |
showAs(displayType) | PivotValue | הצגת הערך הזה בטבלת הצירים כפונקציה של ערך אחר. |
summarizeBy(summarizeFunction) | PivotValue | מגדירה את פונקציית הסיכום. |
תיעוד מפורט
getDisplayType()
מחזירה את סוג התצוגה שמתאר כיצד ערך הציר מוצג כרגע בטבלה.
החזרות
PivotValueDisplayType
– סוג התצוגה של ערך הציר הזה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
מחזירה את הנוסחה שמשמשת לחישוב הערך הזה. אם הערך הזה לא של שדה מחושב, השיטה הזו מחזירה את הערך null
.
החזרות
String
– ערך הציר לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPivotTable()
מחזירה את PivotTable
שאליו שייך הערך הזה.
החזרות
PivotTable
– טבלת הצירים שהערך הזה שייך אליה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSourceDataColumn()
מחזירה את המספר של עמודת נתוני המקור שערך הציר מסכם. האינדקס הזה מבוסס על 1. אם הקבוצה הזו מסכמת את נתוני המקור בעמודה 'A' של הגיליון האלקטרוני, השיטה מחזירה את הערך 1
.
החזרות
Integer
– מספר העמודה של נתוני המקור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSourceDataSourceColumn()
מחזירה את העמודה של מקור הנתונים שמסכמת את הערך בטבלת הציר. הפונקציה מחזירה את הערך null
אם טבלת הצירים היא לא {DataSourcePivotTableApi}.
החזרות
DataSourceColumn
– עמודת מקור הנתונים שערך הציר מסכם.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSummarizedBy()
מחזירה את פונקציית הסיכום של הקבוצה הזו.
החזרות
PivotTableSummarizeFunction
– פונקציית הסיכום של הקבוצה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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
setDisplayName(name)
הגדרת השם המוצג של הערך הזה בטבלת הצירים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
name | String | השם המוצג להגדרה. |
החזרות
PivotValue
– ערך הציר לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
הפונקציה מגדירה את הנוסחה שמשמשת לחישוב הערך הזה. אם הערך הזה הוא לא שדה מחושב, השיטה הזו תוביל לשגיאה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
formula | String | הנוסחה שמשמשת לחישוב הערך הזה. |
החזרות
PivotValue
– ערך הציר לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showAs(displayType)
הצגת הערך הזה בטבלת הצירים כפונקציה של ערך אחר.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
displayType | PivotValueDisplayType | הדרך להציג את הערכים. |
החזרות
PivotValue
– ערך הציר לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
summarizeBy(summarizeFunction)
מגדירה את פונקציית הסיכום.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
summarizeFunction | PivotTableSummarizeFunction | הפונקציה שמשמשת לסיכום נתונים בעמודת נתוני המקור של הערך הזה. |
החזרות
PivotValue
– ערך הציר לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets