בקשה
סוג עדכון אחד שצריך להחיל על גיליון אלקטרוני.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
kind סוג העדכון. חובה למלא רק שדה אחד.
kind
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
updateSpreadsheetProperties
|
עדכון המאפיינים של הגיליון האלקטרוני. |
updateSheetProperties
|
עדכון המאפיינים של גיליון. |
updateDimensionProperties
|
עדכון המאפיינים נכסים. |
updateNamedRange
|
עדכון טווח בעל שם. |
repeatCell
|
חוזרת על תא יחיד בטווח. |
addNamedRange
|
הפונקציה מוסיפה טווח תאים בעל שם. |
deleteNamedRange
|
מחיקה של טווח תאים בעל שם. |
addSheet
|
הוספת גיליון. |
deleteSheet
|
מוחקת גיליון. |
autoFill
|
מילוי אוטומטי של נתונים נוספים על סמך נתונים קיימים. |
cutPaste
|
גוזרים נתונים מאזור אחד ומדביקים אותם באזור אחר. |
copyPaste
|
העתקת נתונים מאזור אחד והדבקה שלהם באזור אחר. |
mergeCells
|
המערכת ממזגת תאים. |
unmergeCells
|
ביטול המיזוג של התאים שמוזגו. |
updateBorders
|
עדכון הגבולות בטווח של תאים. |
updateCells
|
עדכון תאים רבים בבת אחת. |
addFilterView
|
הוספת תצוגה מסוננת. |
appendCells
|
מצרפת תאים אחרי השורה האחרונה שמכילים נתונים בגיליון. |
clearBasicFilter
|
ניקוי המסנן הבסיסי בגיליון. |
deleteDimension
|
מוחקת שורות או עמודות בגיליון. |
deleteEmbeddedObject
|
מוחקת אובייקט מוטמע (למשל תרשים, תמונה) בגיליון. |
deleteFilterView
|
מחיקה של תצוגת סינון מגיליון. |
duplicateFilterView
|
שכפול של תצוגת מסנן. |
duplicateSheet
|
משכפל גיליון. |
findReplace
|
חיפוש והחלפה של מופעים של טקסט מסוים בטקסט אחר. |
insertDimension
|
הוספת שורות או עמודות חדשות בגיליון. |
insertRange
|
הוספת תאים חדשים לגיליון, הזזת התאים הקיימים. |
moveDimension
|
מעביר שורות או עמודות למיקום אחר בגיליון. |
updateEmbeddedObjectPosition
|
מעדכנת את המיקום של אובייקט מוטמע (למשל, תרשים, תמונה). |
pasteData
|
מדביק נתונים (HTML או קובץ מופרד) בגיליון. |
textToColumns
|
ממירה עמודת טקסט לעמודות רבות של טקסט. |
updateFilterView
|
עדכון המאפיינים של תצוגת מסנן. |
deleteRange
|
מחיקת טווח של תאים מגיליון והזזה של התאים הנותרים. |
appendDimension
|
מצרפת את המידות לסוף הגיליון. |
addConditionalFormatRule
|
הוספת כלל חדש של עיצוב מותנה. |
updateConditionalFormatRule
|
עדכון כלל קיים של עיצוב מותנה. |
deleteConditionalFormatRule
|
מחיקת כלל קיים של עיצוב מותנה. |
sortRange
|
מיון נתונים בטווח. |
setDataValidation
|
מגדיר אימות נתונים לתא אחד או יותר. |
setBasicFilter
|
מגדיר את המסנן הבסיסי בגיליון. |
addProtectedRange
|
הפונקציה מוסיפה טווח תאים מוגן. |
updateProtectedRange
|
עדכון טווח מוגן. |
deleteProtectedRange
|
מוחקת טווח תאים מוגן. |
autoResizeDimensions
|
המערכת משנה באופן אוטומטי את הגודל של מאפיין אחד או יותר, על סמך תוכן התאים באותו מאפיין. |
addChart
|
הוספת תרשים. |
updateChartSpec
|
עדכון המפרט של התרשים. |
updateBanding
|
עדכון טווח עם טווח |
addBanding
|
הוספת טווח תחומי חדש |
deleteBanding
|
הסרת טווח עם תחום |
createDeveloperMetadata
|
יצירת מטא-נתונים חדשים של מפתח |
updateDeveloperMetadata
|
עדכון רשומה קיימת של מטא נתונים של מפתח |
deleteDeveloperMetadata
|
מחיקת מטא-נתונים של המפתח |
randomizeRange
|
יוצרת באופן אקראי את הסדר של השורות בטווח. |
addDimensionGroup
|
יצירת קבוצה בטווח שצוין. |
deleteDimensionGroup
|
מחיקת קבוצה בטווח שצוין. |
updateDimensionGroup
|
עדכון מצב הקבוצה שצוינה. |
trimWhitespace
|
חיתוך תאים של רווחים לבנים (כמו רווחים, כרטיסיות או שורות חדשות). |
deleteDuplicates
|
מסירה שורות שמכילות ערכים כפולים בעמודות שצוינו בטווח תאים. |
updateEmbeddedObjectBorder
|
עדכון הגבול של אובייקט מוטמע. |
addSlicer
|
הוספת כלי סינון. |
updateSlicerSpec
|
מעדכן את המפרט של כלי הסינון. |
addDataSource
|
הוספת מקור נתונים. |
updateDataSource
|
עדכון מקור נתונים. |
deleteDataSource
|
מחיקת מקור נתונים. |
refreshDataSource
|
מתבצע רענון של מקור נתונים אחד או יותר ו-dbobjects משויכים. |
cancelDataSourceRefresh
|
ביטול הרענון של מקור נתונים אחד או יותר ושל dbobjects שמשויכים אליו. |
UpdateSpreadsheetPropertiesRequest
עדכון מאפיינים של גיליון אלקטרוני.
ייצוג JSON |
---|
{
"properties": {
object (
|
שדות | |
---|---|
properties
|
המאפיינים שצריך לעדכן. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. השורש 'properties' היא משתמעת ואין לציין אותה. סינגל
|
UpdateSheetPropertiesRequest
מעדכן את המאפיינים של הגיליון עם הערכים שצוינו
sheetId
ייצוג JSON |
---|
{
"properties": {
object (
|
שדות | |
---|---|
properties
|
המאפיינים שצריך לעדכן. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
UpdateDimensionPropertiesRequest
מעדכנות את המאפיינים של מאפיינים בטווח שצוין.
ייצוג JSON |
---|
{ "properties": { object ( |
שדות | |
---|---|
properties
|
מאפיינים שצריך לעדכן. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
שדה איחוד
dimension_range טווח המאפיינים.
dimension_range
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
range
|
השורות או העמודות שרוצים לעדכן. |
dataSourceSheetRange
|
העמודות בגיליון של מקור נתונים שיש לעדכן. |
DataSourceSheetDimensionRange
טווח לאורך מאפיין יחיד
DATA_SOURCE
גיליון.
ייצוג JSON |
---|
{
"sheetId": integer,
"columnReferences": [
{
object (
|
שדות | |
---|---|
sheetId
|
המזהה של הגיליון שבו נמצא הטווח של מקור הנתונים. |
columnReferences[]
|
העמודות בגיליון של מקור הנתונים. |
UpdateNamedRangeRequest
עדכון המאפיינים של טווח התאים בעל השם שצוין
namedRangeId
ייצוג JSON |
---|
{
"namedRange": {
object (
|
שדות | |
---|---|
namedRange
|
טווח התאים בעל השם שיש לעדכן במאפיינים החדשים. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
RepeatCellRequest
עדכון כל התאים בטווח לערכים של אובייקט התא הנתון. רק השדות המפורטים
fields
השדה עודכן; אחרים לא משתנים.
אם כותבים תא עם נוסחה, הטווחים של הנוסחה יגדלו אוטומטית לכל שדה בטווח. לדוגמה, אם כותבים תא עם נוסחה
=A1
בטווח B2:C4, B2 יהיה
=A1
, B3 יהיה
=A2
, B4 יהיה
=A3
, C2 יהיה
=B1
, C3 הוא
=B2
, C4 הוא
=B3
.
כדי שהטווחים של הנוסחה יהיו סטטיים, משתמשים בפונקציה
$
סימן גרפי. לדוגמה, משתמשים בנוסחה
=$A$1
כדי למנוע הגדלה של השורה והעמודה.
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
הטווח שבו יש לחזור על התא. |
cell
|
הנתונים לכתיבה. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
AddNamedRangeRequest
הפונקציה מוסיפה לגיליון האלקטרוני טווח תאים בעל שם.
ייצוג JSON |
---|
{
"namedRange": {
object (
|
שדות | |
---|---|
namedRange
|
טווח התאים בעל השם להוספה.
|
DeleteNamedRangeRequest
מסירה מהגיליון האלקטרוני את טווח התאים בעל השם עם המזהה הנתון.
ייצוג JSON |
---|
{ "namedRangeId": string } |
שדות | |
---|---|
namedRangeId
|
המזהה של טווח התאים בעל השם למחיקה. |
AddSheetRequest
הוספת גיליון חדש. כשנוסף גיליון באינדקס נתון, כל הגיליונות הבאים והאינדקסים גדלים. כדי להוסיף גיליון אובייקטים, צריך להשתמש ב-
AddChartRequest
במקום זאת,
EmbeddedObjectPosition.sheetId
או
EmbeddedObjectPosition.newSheet
.
ייצוג JSON |
---|
{
"properties": {
object (
|
שדות | |
---|---|
properties
|
המאפיינים שצריכים להיות לגיליון החדש. כל המאפיינים הם אופציונליים.
|
DeleteSheetRequest
מחיקת הגיליון המבוקש.
ייצוג JSON |
---|
{ "sheetId": integer } |
שדות | |
---|---|
sheetId
|
המזהה של הגיליון שרוצים למחוק.
אם הגיליון כולל
|
AutoFillRequest
מילוי יותר נתונים על סמך נתונים קיימים.
ייצוג JSON |
---|
{ "useAlternateSeries": boolean, // Union field |
שדות | |
---|---|
useAlternateSeries
|
True אם צריך ליצור נתונים עם הפונקציה "alternate" סדרות. הנתון הזה משתנה בהתאם לסוג ולכמות של נתוני המקור. |
שדה איחוד
area האזור למילוי האוטומטי.
area
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
range
|
הטווח למילוי אוטומטי. הפעולה הזו תבדוק את הטווח ותזהה את המיקום שמכיל נתונים, ותמלא אוטומטית את הנתונים האלה בשאר הטווח. |
sourceAndDestination
|
אזורי המקור והיעד למילוי אוטומטי. ההגדרה הזו מציינת במפורש את מקור המילוי האוטומטי ואיפה להרחיב את הנתונים האלה. |
SourceAndDestination
שילוב של טווח מקור ודרכים להרחיב את המקור הזה.
ייצוג JSON |
---|
{ "source": { object ( |
שדות | |
---|---|
source
|
מיקום הנתונים שבהם יש להשתמש כמקור למילוי האוטומטי. |
dimension
|
המאפיין שבו צריך למלא את הנתונים. |
fillLength
|
מספר השורות או העמודות שבהן צריך למלא את הנתונים. מספרים חיוביים מתרחבים מעבר לשורה האחרונה או לעמודה האחרונה של המקור. מספרים שליליים מתרחבים לפני השורה הראשונה או העמודה הראשונה של המקור. |
CutPasteRequest
העברת נתונים מהמקור אל היעד.
ייצוג JSON |
---|
{ "source": { object ( |
שדות | |
---|---|
source
|
נתוני המקור לחיתוך. |
destination
|
הקואורדינטה הימנית העליונה שבה יש להדביק את הנתונים. |
pasteType
|
איזה סוג של נתונים להדביק. כל נתוני המקור ייגזרו, ללא קשר לנתונים שיודבקו. |
PasteType
איזה סוג נתונים צריך להדביק.
טיפוסים בני מנייה (enum) | |
---|---|
PASTE_NORMAL
|
מדביקים ערכים, נוסחאות, פורמטים ומיזוגים. |
PASTE_VALUES
|
מדביקים את הערכים רק ללא פורמטים, נוסחאות או מיזוגים. |
PASTE_FORMAT
|
מדביקים את הפורמט ואימות הנתונים בלבד. |
PASTE_NO_BORDERS
|
מוצא חן בעיניי
PASTE_NORMAL
אבל בלי גבולות.
|
PASTE_FORMULA
|
מדביקים את הנוסחאות בלבד. |
PASTE_DATA_VALIDATION
|
מדביקים את אימות הנתונים בלבד. |
PASTE_CONDITIONAL_FORMATTING
|
מדביקים את כללי העיצוב המותנה בלבד. |
CopyPasteRequest
העתקת נתונים מהמקור ליעד.
ייצוג JSON |
---|
{ "source": { object ( |
שדות | |
---|---|
source
|
טווח המקור להעתקה. |
destination
|
המיקום שאליו רוצים להדביק. אם הטווח כולל טווח שהוא כפולה מהגובה או הרוחב של המקור, הנתונים יחזרו על עצמם כדי למלא את טווח היעד. אם הטווח קטן מטווח המקור, כל נתוני המקור עדיין יועתקו (מעבר לסוף טווח היעד). |
pasteType
|
איזה סוג של נתונים להדביק. |
pasteOrientation
|
האופן שבו צריך להתייחס לנתונים במהלך ההדבקה. |
PasteOrientation
איך לבצע פעולת הדבקה.
טיפוסים בני מנייה (enum) | |
---|---|
NORMAL
|
מדביקים כרגיל. |
TRANSPOSE
|
מדביקים במהופך, כאשר כל השורות הופכות לעמודות, ולהפך. |
MergeCellsRequest
מיזוג כל התאים בטווח.
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
טווח התאים למיזוג. |
mergeType
|
איך התאים ממוזגים. |
MergeType
סוג המיזוג שרוצים ליצור.
טיפוסים בני מנייה (enum) | |
---|---|
MERGE_ALL
|
יצירת מיזוג יחיד מהטווח |
MERGE_COLUMNS
|
יצירת מיזוג לכל עמודה בטווח |
MERGE_ROWS
|
יצירת מיזוג לכל שורה בטווח |
UnmergeCellsRequest
ביטול המיזוג של התאים בטווח הנתון.
ייצוג JSON |
---|
{
"range": {
object (
|
שדות | |
---|---|
range
|
הטווח שבו יש לבטל את המיזוג של כל התאים. אם הטווח כולל כמה מיזוגים, המיזוג של כולם יבוטל. הטווח לא יכול להתפרס באופן חלקי על מיזוג כלשהו. |
UpdateBordersRequest
עדכון הגבולות של טווח. אם לא הוגדר שדה בבקשה, הגבול נשאר כפי שהוא. לדוגמה, עם שני UpdateBordersRequest לאחר מכן:
-
טווח: A1:A5
{ top: RED, bottom: WHITE }
-
טווח: A1:A5
{ left: BLUE }
כתוצאה מכך, ל-A1:A5 יהיו גבולות
{ top: RED, bottom: WHITE, left: BLUE }
אם רוצים להסיר גבול, הגדירו באופן מפורש את הסגנון כ-
NONE
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
הטווח שצריך לעדכן את הגבולות שלו. |
top
|
הגבול שיש להציב בחלק העליון של הטווח. |
bottom
|
הגבול שיש להציב בתחתית הטווח. |
left
|
הגבול שצריך להוסיף בצד שמאל של הטווח. |
right
|
הגבול שצריך להוסיף מימין לטווח. |
innerHorizontal
|
הגבול האופקי שיש לכלול בטווח. |
innerVertical
|
הגבול האנכי שיש לכלול בטווח. |
UpdateCellsRequest
עדכון כל התאים בטווח עם נתונים חדשים.
ייצוג JSON |
---|
{ "rows": [ { object ( |
שדות | |
---|---|
rows[]
|
הנתונים לכתיבה. |
fields
|
השדות ב-CellData שצריך לעדכן. יש לציין שדה אחד לפחות. השורש הוא CellData; 'row.values' אין לציין סינגל
|
שדה איחוד
area צריך לכתוב את נתוני המיקום. יש להגדיר ערך אחד בדיוק.
area
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
start
|
הקואורדינטה שבה מתחילים לכתוב נתונים. אפשר לכתוב כל מספר של שורות ועמודות (כולל מספר שונה של עמודות בכל שורה). |
range
|
הטווח שבו צריך לכתוב את הנתונים.
אם הנתונים בשורות אינם מכסים את כל הטווח המבוקש, השדות התואמים את אלו שמוגדרים
|
AddFilterViewRequest
הוספת תצוגה מסוננת.
ייצוג JSON |
---|
{
"filter": {
object (
|
שדות | |
---|---|
filter
|
המסנן להוספה.
|
AppendCellsRequest
הפונקציה מוסיפה תאים חדשים אחרי השורה האחרונה עם נתונים בגיליון, ומוסיפים שורות חדשות לגיליון לפי הצורך.
ייצוג JSON |
---|
{
"sheetId": integer,
"rows": [
{
object (
|
שדות | |
---|---|
sheetId
|
מזהה הגיליון שאליו רוצים להוסיף את הנתונים. |
rows[]
|
הנתונים שרוצים לצרף. |
fields
|
השדות ב-CellData שצריך לעדכן. יש לציין שדה אחד לפחות. השורש הוא CellData; 'row.values' אין לציין סינגל
|
ClearBasicFilterRequest
ניקוי המסנן הבסיסי, אם יש מסנן כזה בגיליון.
ייצוג JSON |
---|
{ "sheetId": integer } |
שדות | |
---|---|
sheetId
|
מזהה הגיליון שבו יש לנקות את המסנן הבסיסי. |
DeleteDimensionRequest
מחיקת המידות מהגיליון.
ייצוג JSON |
---|
{
"range": {
object (
|
שדות | |
---|---|
range
|
המימדים שצריך למחוק מהגיליון. |
DeleteEmbeddedObjectRequest
מחיקת האובייקט המוטמע עם המזהה הנתון.
ייצוג JSON |
---|
{ "objectId": integer } |
שדות | |
---|---|
objectId
|
המזהה של האובייקט המוטמע למחיקה. |
DeleteFilterViewRequest
מוחק תצוגה מסוננת מסוימת.
ייצוג JSON |
---|
{ "filterId": integer } |
שדות | |
---|---|
filterId
|
מזהה המסנן שרוצים למחוק. |
DuplicateFilterViewRequest
שכפול של תצוגת מסנן מסוימת.
ייצוג JSON |
---|
{ "filterId": integer } |
שדות | |
---|---|
filterId
|
מזהה המסנן המשוכפל. |
DuplicateSheetRequest
שכפול התוכן של גיליון.
ייצוג JSON |
---|
{ "sourceSheetId": integer, "insertSheetIndex": integer, "newSheetId": integer, "newSheetName": string } |
שדות | |
---|---|
sourceSheetId
|
הגיליון לשכפול.
אם גיליון המקור הוא
|
insertSheetIndex
|
אינדקס מבוסס אפס שאליו צריך להוסיף את הגיליון החדש. האינדקס של כל הגיליונות לאחר מכן גדל. |
newSheetId
|
אם מוגדר, המזהה של הגיליון החדש. אם המדיניות לא מוגדרת, ייבחר מזהה. אם מוגדר, המזהה לא יכול להתנגש עם מזהה גיליון קיים. אם השדה מוגדר, הוא חייב להיות לא שלילי. |
newSheetName
|
שם הגיליון החדש. אם השדה ריק, נבחר עבורך שם חדש. |
FindReplaceRequest
חיפוש והחלפה של נתונים בתאים בטווח, בגיליון או בכל הגיליונות
ייצוג JSON |
---|
{ "find": string, "replacement": string, "matchCase": boolean, "matchEntireCell": boolean, "searchByRegex": boolean, "includeFormulas": boolean, // Union field |
שדות | |
---|---|
find
|
הערך שצריך לחפש. |
replacement
|
הערך שבו יש להשתמש כתחליף. |
matchCase
|
הערך הוא True אם החיפוש תלוי אותיות רישיות. |
matchEntireCell
|
הערך הוא True אם הערך של החיפוש צריך להתאים לכל התא. |
searchByRegex
|
הערך הוא True אם הערך לחיפוש הוא ביטוי רגולרי (regex). הביטוי הרגולרי וההחלפה צריכים לעמוד בכללי הביטוי הרגולרי של Java
https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. המחרוזת החלופית יכולה להתייחס לקבוצות לתיעוד. לדוגמה, אם תא אחד מכיל את התוכן
|
includeFormulas
|
הערך הוא True אם החיפוש צריך לכלול תאים עם נוסחאות. False כדי לדלג על תאים עם נוסחאות. |
שדה איחוד
scope ההיקף שבו מאתרים או מחליפים אותו – יש להגדיר היקף אחד בלבד.
scope
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
range
|
הטווח לחיפוש/החלפה. |
sheetId
|
הגיליון לחיפוש/החלפה. |
allSheets
|
True כדי למצוא או להחליף בכל הגיליונות. |
InsertDimensionRequest
הוספת שורות או עמודות בגיליון באינדקס מסוים.
ייצוג JSON |
---|
{
"range": {
object (
|
שדות | |
---|---|
range
|
המאפיינים להוספה. גם אינדקס ההתחלה וגם אינדקס הסיום חייבים להיות מוגבלים. |
inheritFromBefore
|
האם צריך להרחיב את מאפייני המאפיין מהמאפיינים לפני או אחרי המאפיינים החדשים שנוספו. הערך הוא True כדי לרשת מהמאפיינים שלפני כן (במקרה כזה, אינדקס ההתחלה חייב להיות גדול מ-0), ו-FALSE כדי לרשת מהמאפיינים שלאחר מכן.
לדוגמה, אם אינדקס שורה 0 יש רקע אדום ואינדקס שורה 1 יש רקע ירוק, הוספת 2 שורות באינדקס 1 יכולה לרשת את הרקע הירוק או האדום. אם המיקום
|
InsertRangeRequest
הוספת תאים לטווח, תוך הזזה של התאים הקיימים או כלפי מטה.
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
הטווח שיש להוסיף אליו תאים חדשים. |
shiftDimension
|
המאפיין שיועבר כשמוסיפים תאים. אם המיקום
|
MoveDimensionRequest
מעבירה שורה אחת או עמודה אחת או יותר.
ייצוג JSON |
---|
{
"source": {
object (
|
שדות | |
---|---|
source
|
מאפייני המקור להעברה. |
destinationIndex
|
אינדקס ההתחלה מבוסס אפס, שאליו יועברו נתוני המקור, על סמך הקואורדינטות before נתוני המקור מוסרים מהרשת. הנתונים הקיימים יזיזו למטה או ימינה (בהתאם למאפיין) כדי לפנות מקום למאפיינים שהועברו. מאפייני המקור מוסרים מהרשת, כך שייתכן שהנתונים יופיעו באינדקס שונה מזה שצוין.
לדוגמה, בהינתן
|
UpdateEmbeddedObjectPositionRequest
עדכון המיקום של אובייקט מוטמע (למשל, שינוי המיקום של תרשים או תמונה או שינוי הגודל שלהם).
ייצוג JSON |
---|
{
"objectId": integer,
"newPosition": {
object (
|
שדות | |
---|---|
objectId
|
מזהה האובייקט שמיועד להעברה. |
newPosition
|
מיקום מפורש להעביר אליו את האובייקט המוטמע. אם המיקום
|
fields
|
השדות של
|
PasteDataRequest
מוסיפה נתונים לגיליון האלקטרוני החל מהקואורדינטה שצוינה.
ייצוג JSON |
---|
{ "coordinate": { object ( |
שדות | |
---|---|
coordinate
|
הקואורדינטה שבה צריך להתחיל להוסיף את הנתונים. |
data
|
הנתונים להוספה. |
type
|
איך מדביקים את הנתונים. |
שדה איחוד
kind איך לפרש את הנתונים – יש להגדיר ערך אחד בלבד.
kind
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
delimiter
|
התו המפריד בנתונים. |
html
|
הערך הוא True אם הנתונים הם HTML. |
TextToColumnsRequest
מפצלת עמודת טקסט לכמה עמודות על סמך תו מפריד בכל תא.
ייצוג JSON |
---|
{ "source": { object ( |
שדות | |
---|---|
source
|
טווח הנתונים של המקור. המודעה צריכה להתפרס על עמודה אחת בלבד. |
delimiter
|
התו המפריד שבו צריך להשתמש. בשימוש רק אם delimiterType הוא
|
delimiterType
|
סוג התו המפריד שבו צריך להשתמש. |
DelimiterType
התו המפריד שבו צריך לפצל.
טיפוסים בני מנייה (enum) | |
---|---|
DELIMITER_TYPE_UNSPECIFIED
|
ערך ברירת המחדל. אסור להשתמש בערך הזה. |
COMMA
|
"," |
SEMICOLON
|
"; |
PERIOD
|
"." |
SPACE
|
" " |
CUSTOM
|
ערך מותאם אישית כפי שמוגדר בתו המפריד. |
AUTODETECT
|
זיהוי עמודות באופן אוטומטי. |
UpdateFilterViewRequest
מעדכן את המאפיינים של תצוגת המסנן.
ייצוג JSON |
---|
{
"filter": {
object (
|
שדות | |
---|---|
filter
|
המאפיינים החדשים של תצוגת המסנן. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
DeleteRangeRequest
מחיקת טווח של תאים מעבירה תאים אחרים לאזור שנמחק.
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
טווח התאים למחיקה. |
shiftDimension
|
המאפיין שממנו תאים שנמחקו יוחלפו. אם המיקום
|
AppendDimensionRequest
מצרפת שורות או עמודות בסוף הגיליון.
ייצוג JSON |
---|
{
"sheetId": integer,
"dimension": enum (
|
שדות | |
---|---|
sheetId
|
הגיליון שאליו רוצים להוסיף שורות או עמודות. |
dimension
|
האם צריך לצרף שורות או עמודות. |
length
|
מספר השורות או העמודות שרוצים לצרף. |
AddConditionalFormatRuleRequest
הוספת כלל חדש של עיצוב מותנה באינדקס הנתון. כל הכללים הבאים והאינדקסים גדלים.
ייצוג JSON |
---|
{
"rule": {
object (
|
שדות | |
---|---|
rule
|
הכלל שצריך להוסיף. |
index
|
האינדקס מבוסס אפס שבו יש להוסיף את הכלל. |
UpdateConditionalFormatRuleRequest
מעדכנות כלל של עיצוב מותנה באינדקס הנתון, או מעבירה כלל של עיצוב מותנה לאינדקס אחר.
ייצוג JSON |
---|
{ "index": integer, "sheetId": integer, // Union field |
שדות | |
---|---|
index
|
האינדקס מבוסס אפס של הכלל שיש להחליף או להעביר. |
sheetId
|
הגיליון של הכלל שרוצים להעביר. נדרש אם
|
שדה איחוד
instruction סוג העדכון שצריך לבצע.
instruction
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
rule
|
הכלל שצריך להחליף את הכלל באינדקס הנתון. |
newIndex
|
האינדקס החדש שמבוסס על אפס שאליו הכלל אמור להגיע. |
DeleteConditionalFormatRuleRequest
מוחק כלל של עיצוב מותנה באינדקס הנתון. כל הכללים הבאים המערכת מקטינה את האינדקסים.
ייצוג JSON |
---|
{ "index": integer, "sheetId": integer } |
שדות | |
---|---|
index
|
האינדקס מבוסס על אפס של הכלל שיש למחוק. |
sheetId
|
הגיליון שממנו הכלל נמחק. |
SortRangeRequest
מיון נתונים בשורות לפי סדר מיון בכל עמודה.
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
הטווח למיון. |
sortSpecs[]
|
סדר המיון בכל עמודה. מפרטים מאוחרים יותר משמשים כשהערכים זהים במפרטים הקודמים. |
SetDataValidationRequest
מגדיר כלל לאימות נתונים לכל תא בטווח. כדי לנקות את האימות בטווח, צריך להפעיל את הפונקציה הזו בלי לציין כלל.
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
הטווח שכלל אימות הנתונים צריך לחול עליו. |
rule
|
הכלל לאימות נתונים שיש להגדיר בכל תא בטווח, או ריק כדי לנקות את אימות הנתונים בטווח. |
SetBasicFilterRequest
מגדיר את המסנן הבסיסי שמשויך לגיליון.
ייצוג JSON |
---|
{
"filter": {
object (
|
שדות | |
---|---|
filter
|
המסנן שצריך להגדיר. |
AddProtectedRangeRequest
הוספת טווח מוגן חדש.
ייצוג JSON |
---|
{
"protectedRange": {
object (
|
שדות | |
---|---|
protectedRange
|
טווח התאים המוגן שיש להוסיף.
|
UpdateProtectedRangeRequest
מעדכנות טווח מוגן קיים עם הערך שצוין
protectedRangeId
ייצוג JSON |
---|
{
"protectedRange": {
object (
|
שדות | |
---|---|
protectedRange
|
טווח התאים המוגן שצריך לעדכן במאפיינים החדשים. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
DeleteProtectedRangeRequest
מוחקת את הטווח המוגן עם המזהה הנתון.
ייצוג JSON |
---|
{ "protectedRangeId": integer } |
שדות | |
---|---|
protectedRangeId
|
המזהה של הטווח המוגן שצריך למחוק. |
AutoResizeDimensionsRequest
המערכת משנה באופן אוטומטי את הגודל של מאפיין אחד או יותר, על סמך תוכן התאים באותו מאפיין.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
dimension_range טווח המאפיינים.
dimension_range
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
dimensions
|
המאפיינים שיש לשנות את הגודל שלהם באופן אוטומטי. |
dataSourceSheetDimensions
|
שינוי אוטומטי של גודל המאפיינים בגיליון של מקור נתונים. |
AddChartRequest
הוספת תרשים לגיליון בגיליון האלקטרוני.
ייצוג JSON |
---|
{
"chart": {
object (
|
שדות | |
---|---|
chart
|
התרשים שצריך להוסיף לגיליון האלקטרוני, כולל המיקום שבו צריך למקם אותו.
|
UpdateChartSpecRequest
עדכון המפרט של התרשים. (הפעולה הזו לא גורמת להזזה או לשינוי הגודל של תרשים. כדי להזיז תרשים או לשנות את הגודל שלו, אפשר להשתמש
UpdateEmbeddedObjectPositionRequest
).
ייצוג JSON |
---|
{
"chartId": integer,
"spec": {
object (
|
שדות | |
---|---|
chartId
|
מזהה התרשים שצריך לעדכן. |
spec
|
המפרט שצריך להחיל על התרשים. |
UpdateBandingRequest
עדכון המאפיינים של טווח הטווח שצוין.
ייצוג JSON |
---|
{
"bandedRange": {
object (
|
שדות | |
---|---|
bandedRange
|
טווח הטווח שיש לעדכן במאפיינים החדשים. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
AddBandingRequest
הוספת טווח תחומי חדש לגיליון האלקטרוני.
ייצוג JSON |
---|
{
"bandedRange": {
object (
|
שדות | |
---|---|
bandedRange
|
טווח התחום שצריך להוסיף.
|
DeleteBandingRequest
מסירה מהגיליון האלקטרוני את טווח התאים עם המזהה הנתון.
ייצוג JSON |
---|
{ "bandedRangeId": integer } |
שדות | |
---|---|
bandedRangeId
|
המזהה של טווח התאים למחיקה. |
CreateDeveloperMetadataRequest
בקשה ליצירת מטא נתונים של מפתח.
ייצוג JSON |
---|
{
"developerMetadata": {
object (
|
שדות | |
---|---|
developerMetadata
|
המטא-נתונים של המפתח שצריך ליצור. |
UpdateDeveloperMetadataRequest
בקשה לעדכון מאפיינים של מטא-נתונים של מפתח. מעדכן את המאפיינים של המטא-נתונים של המפתח שנבחרו על ידי המסננים לערכים שצוינו
DeveloperMetadata
משאב. המתקשרים חייבים לציין את המאפיינים שהם רוצים לעדכן בפרמטר של השדות, וגם לציין לפחות אחד
DataFilter
שתואמים למטא-נתונים שהם רוצים לעדכן.
ייצוג JSON |
---|
{ "dataFilters": [ { object ( |
שדות | |
---|---|
dataFilters[]
|
המסננים שתואמים לרשומות של המטא-נתונים של המפתח שצריך לעדכן. |
developerMetadata
|
הערך שאליו יעודכנו כל המטא-נתונים שתואמים למסנני הנתונים. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
DeleteDeveloperMetadataRequest
בקשה למחיקת מטא-נתונים של מפתח.
ייצוג JSON |
---|
{
"dataFilter": {
object (
|
שדות | |
---|---|
dataFilter
|
מסנן הנתונים שמתאר את הקריטריונים שמשמשים לבחירת רשומת המטא-נתונים של המפתח שצריך למחוק. |
RandomizeRangeRequest
יוצרת באופן אקראי את הסדר של השורות בטווח.
ייצוג JSON |
---|
{
"range": {
object (
|
שדות | |
---|---|
range
|
הטווח שצריך להגדיר באקראי. |
AddDimensionGroupRequest
יצירת קבוצה בטווח שצוין.
אם הטווח המבוקש הוא קבוצת-על של הטווח של קבוצה קיימת G, אז העומק של G גדל והקבוצה החדשה G יש את העומק של הקבוצה הזו. לדוגמה, קבוצה [C:D, עומק 1] + [B:E] מובילה לקבוצות [B:E, עומק 1] ו-[C:D, עומק 2]. אם הטווח המבוקש הוא קבוצת משנה של קבוצה קיימת G, אז העומק של הקבוצה החדשה G הופך לאחד גדול מהעומק של G. לדוגמה, קבוצה [B:E, עומק 1] + [C:D] מובילה לקבוצות [B:E, עומק 1] ו-[C:D, עומק 2]. אם הטווח המבוקש מתחיל לפני ומסתיים אחרי הטווח של קבוצה קיימת G ומסתיים אחרי זה, הטווח של הקבוצה הקיימת G הופך לאיחוד של הטווחים והקבוצה החדשה G יש עומק אחד גדול מהעומק של G והטווח הוא חתך של הטווחים. לדוגמה, קבוצה [B:D, עומק 1] + [C:E] מובילה לקבוצות [B:E, עומק 1] ו-[C:D, עומק 2].
ייצוג JSON |
---|
{
"range": {
object (
|
שדות | |
---|---|
range
|
הטווח שבו צריך ליצור קבוצה. |
DeleteDimensionGroupRequest
מוחקת קבוצה מעל הטווח שצוין על ידי הקטנת העומק של המאפיינים בטווח.
לדוגמה, נניח שהגיליון כולל קבוצה של עומק 1 מעל B:E וקבוצת עומק-2 מעל C:D. מחיקת קבוצה על ידי D:E יוצאת מהגיליון עם קבוצה מסוג 'עומק 1' מעל B:D וקבוצת עומק 2 עבור C:C.
ייצוג JSON |
---|
{
"range": {
object (
|
שדות | |
---|---|
range
|
הטווח של הקבוצה שרוצים למחוק. |
UpdateDimensionGroupRequest
עדכון מצב הקבוצה שצוינה.
ייצוג JSON |
---|
{
"dimensionGroup": {
object (
|
שדות | |
---|---|
dimensionGroup
|
הקבוצה שאת המצב שלה צריך לעדכן. הטווח והעומק של הקבוצה צריכים לציין קבוצה חוקית בגיליון, וכל שאר השדות מעודכנים. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
TrimWhitespaceRequest
חיתוך של רווחים לבנים (כמו רווחים, כרטיסיות או שורות חדשות) בכל תא בטווח שצוין. הבקשה הזו מסירה את כל הרווחים הלבנים מההתחלה והסוף של הטקסט בכל תא, ומצמצמת את כל הרצף של התווים הלבן שנותרו לרווח אחד. אם הטקסט שנחתך שנוצר מתחיל ב-'+' או '=' , הטקסט נשאר כערך מחרוזת ולא מתפרש כנוסחה.
ייצוג JSON |
---|
{
"range": {
object (
|
שדות | |
---|---|
range
|
הטווח שאת התאים שלו צריך לחתוך. |
DeleteDuplicatesRequest
מסירה שורות בטווח הזה, שמכילות ערכים בעמודות שצוינו, שהם כפילויות של ערכים בכל שורה קודמת. שורות עם ערכים זהים אבל עם הבדלים באותיות, בעיצוב או בנוסחאות נחשבות לכפילויות.
הבקשה הזו גם מסירה שורות כפולות המוסתרות מהתצוגה (לדוגמה, עקב מסנן). כשמסירים כפילויות, המופע הראשון של כל סריקה של שורה כפולה מהחלק העליון כלפי מטה נשמר בטווח שמתקבל. לא מתבצעת הסרה של תוכן שנמצא מחוץ לטווח שצוין, ושורות שנחשבות לכפילויות לא חייבות להיות סמוך אחת לשנייה בטווח.
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
הטווח שממנו יש להסיר שורות כפולות. |
comparisonColumns[]
|
העמודות בטווח שצריך לנתח כדי לאתר ערכים כפולים. אם לא נבחרו עמודות, יתבצע ניתוח של כל העמודות לאיתור כפילויות. |
UpdateEmbeddedObjectBorderRequest
עדכון מאפיין הגבול של אובייקט מוטמע.
ייצוג JSON |
---|
{
"objectId": integer,
"border": {
object (
|
שדות | |
---|---|
objectId
|
המזהה של האובייקט המוטמע שצריך לעדכן. |
border
|
הגבול שחל על האובייקט המוטמע. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
AddSlicerRequest
הוספת כלי סינון לגיליון בגיליון האלקטרוני.
ייצוג JSON |
---|
{
"slicer": {
object (
|
שדות | |
---|---|
slicer
|
כלי הסינון שצריך להוסיף לגיליון האלקטרוני, כולל המיקום שבו צריך למקם אותו.
|
UpdateSlicerSpecRequest
מעדכן את המפרט של כלי הסינון. (הפעולה הזו לא גורמת להעברה של כלי הסינון או לשינוי הגודל שלו. כדי להזיז את כלי הסינון או לשנות את הגודל שלו
UpdateEmbeddedObjectPositionRequest
ייצוג JSON |
---|
{
"slicerId": integer,
"spec": {
object (
|
שדות | |
---|---|
slicerId
|
המזהה של כלי הסינון שצריך לעדכן. |
spec
|
המפרט שצריך להחיל על כלי הסינון. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
AddDataSourceRequest
הוספת מקור נתונים. אחרי שמקור הנתונים יתווסף בהצלחה,
DATA_SOURCE
הגיליון נוצר, ומתבצעת הפעלה של המערכת כדי לרענן את הגיליון כדי לקרוא נתונים ממקור הנתונים.
הבקשה מחייבת פרטים נוספים
bigquery.readonly
היקף הרשאות OAuth אם אתם מוסיפים מקור נתונים של BigQuery.
ייצוג JSON |
---|
{
"dataSource": {
object (
|
שדות | |
---|---|
dataSource
|
מקור הנתונים להוספה. |
UpdateDataSourceRequest
עדכון מקור נתונים. אחרי שמקור הנתונים מתעדכן בהצלחה, מופעלת הפעלה לרענון של
DATA_SOURCE
גיליון כדי לקרוא נתונים ממקור הנתונים המעודכן.
הבקשה מחייבת פרטים נוספים
bigquery.readonly
היקף הרשאות OAuth אם אתם מעדכנים מקור נתונים של BigQuery.
ייצוג JSON |
---|
{
"dataSource": {
object (
|
שדות | |
---|---|
dataSource
|
מקור הנתונים שצריך לעדכן. |
fields
|
השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root)
|
DeleteDataSourceRequest
מחיקת מקור נתונים. בנוסף, הבקשה מוחקת את הגיליון המשויך של מקור הנתונים, ומבטלת את הקישור של כל האובייקטים של מקור הנתונים המשויכים.
ייצוג JSON |
---|
{ "dataSourceId": string } |
שדות | |
---|---|
dataSourceId
|
המזהה של מקור הנתונים שרוצים למחוק. |
RefreshDataSourceRequest
מתבצע רענון של אובייקט אחד או יותר של מקור נתונים בגיליון האלקטרוני לפי ההפניות שצוינו.
הבקשה מחייבת פרטים נוספים
bigquery.readonly
היקף ההרשאות ב-OAuth אם אתם מרעננים מקור נתונים של BigQuery.
אם יש מספר בקשות רענון שמפנות לאותם אובייקטים של מקור נתונים באצווה אחת, רק בקשת הרענון האחרונה מעובדת וכל הבקשות האלה יקבלו את אותה תגובה בהתאם.
ייצוג JSON |
---|
{ "force": boolean, // Union field |
שדות | |
---|---|
force
|
רענון האובייקטים של מקור הנתונים ללא קשר למצב הנוכחי. אם המדיניות לא מוגדרת ואובייקט של מקור נתונים שיש אליו הפניה היה במצב שגיאה, הרענון ייכשל באופן מיידי. |
שדה איחוד
target קובעת מה לרענן.
target
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
references
|
הפניות לאובייקטים של מקור נתונים לרענון. |
dataSourceId
|
הפניה אל
|
isAll
|
רענון כל האובייקטים של מקור הנתונים הקיימים בגיליון האלקטרוני. |
DataSourceObjectReferences
רשימת הפניות לאובייקטים של מקור נתונים.
ייצוג JSON |
---|
{
"references": [
{
object (
|
שדות | |
---|---|
references[]
|
קובצי העזר. |
CancelDataSourceRefreshRequest
ביטול רענון אחד או יותר של אובייקטים של מקור נתונים בגיליון האלקטרוני לפי ההפניות שצוינו.
הבקשה מחייבת פרטים נוספים
bigquery.readonly
היקף OAuth אם מבטלים רענון במקור נתונים של BigQuery.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
target בעמודה הזו מציינים מה לבטל.
target
יכול להיות רק אחת מהאפשרויות הבאות:
|
|
references
|
הפניות לאובייקטים של מקור נתונים שיש לבטל את הרענון שלהם. |
dataSourceId
|
הפניה אל
|
isAll
|
ביטול כל הרענון הקיים של האובייקטים של מקור הנתונים לכל מקורות הנתונים בגיליון האלקטרוני. |