Requests

בקשה

סוג עדכון אחד שצריך להחיל על גיליון אלקטרוני.

ייצוג JSON 
{

  // Union field kind can be only one of the following:
  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  }
  // End of list of possible types for union field kind.
}
שדות
שדה איחוד kind סוג העדכון. חובה למלא רק שדה אחד. kind יכול להיות רק אחת מהאפשרויות הבאות:
updateSpreadsheetProperties

object (UpdateSpreadsheetPropertiesRequest)

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

updateSheetProperties

object (UpdateSheetPropertiesRequest)

עדכון המאפיינים של גיליון.

updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

עדכון המאפיינים נכסים.

updateNamedRange

object (UpdateNamedRangeRequest)

עדכון טווח בעל שם.

repeatCell

object (RepeatCellRequest)

חוזרת על תא יחיד בטווח.

addNamedRange

object (AddNamedRangeRequest)

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

deleteNamedRange

object (DeleteNamedRangeRequest)

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

addSheet

object (AddSheetRequest)

הוספת גיליון.

deleteSheet

object (DeleteSheetRequest)

מוחקת גיליון.

autoFill

object (AutoFillRequest)

מילוי אוטומטי של נתונים נוספים על סמך נתונים קיימים.

cutPaste

object (CutPasteRequest)

גוזרים נתונים מאזור אחד ומדביקים אותם באזור אחר.

copyPaste

object (CopyPasteRequest)

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

mergeCells

object (MergeCellsRequest)

המערכת ממזגת תאים.

unmergeCells

object (UnmergeCellsRequest)

ביטול המיזוג של התאים שמוזגו.

updateBorders

object (UpdateBordersRequest)

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

updateCells

object (UpdateCellsRequest)

עדכון תאים רבים בבת אחת.

addFilterView

object (AddFilterViewRequest)

הוספת תצוגה מסוננת.

appendCells

object (AppendCellsRequest)

מצרפת תאים אחרי השורה האחרונה שמכילים נתונים בגיליון.

clearBasicFilter

object (ClearBasicFilterRequest)

ניקוי המסנן הבסיסי בגיליון.

deleteDimension

object (DeleteDimensionRequest)

מוחקת שורות או עמודות בגיליון.

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

מוחקת אובייקט מוטמע (למשל תרשים, תמונה) בגיליון.

deleteFilterView

object (DeleteFilterViewRequest)

מחיקה של תצוגת סינון מגיליון.

duplicateFilterView

object (DuplicateFilterViewRequest)

שכפול של תצוגת מסנן.

duplicateSheet

object (DuplicateSheetRequest)

משכפל גיליון.

findReplace

object (FindReplaceRequest)

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

insertDimension

object (InsertDimensionRequest)

הוספת שורות או עמודות חדשות בגיליון.

insertRange

object (InsertRangeRequest)

הוספת תאים חדשים לגיליון, הזזת התאים הקיימים.

moveDimension

object (MoveDimensionRequest)

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

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

מעדכנת את המיקום של אובייקט מוטמע (למשל, תרשים, תמונה).

pasteData

object (PasteDataRequest)

מדביק נתונים (HTML או קובץ מופרד) בגיליון.

textToColumns

object (TextToColumnsRequest)

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

updateFilterView

object (UpdateFilterViewRequest)

עדכון המאפיינים של תצוגת מסנן.

deleteRange

object (DeleteRangeRequest)

מחיקת טווח של תאים מגיליון והזזה של התאים הנותרים.

appendDimension

object (AppendDimensionRequest)

מצרפת את המידות לסוף הגיליון.

addConditionalFormatRule

object (AddConditionalFormatRuleRequest)

הוספת כלל חדש של עיצוב מותנה.

updateConditionalFormatRule

object (UpdateConditionalFormatRuleRequest)

עדכון כלל קיים של עיצוב מותנה.

deleteConditionalFormatRule

object (DeleteConditionalFormatRuleRequest)

מחיקת כלל קיים של עיצוב מותנה.

sortRange

object (SortRangeRequest)

מיון נתונים בטווח.

setDataValidation

object (SetDataValidationRequest)

מגדיר אימות נתונים לתא אחד או יותר.

setBasicFilter

object (SetBasicFilterRequest)

מגדיר את המסנן הבסיסי בגיליון.

addProtectedRange

object (AddProtectedRangeRequest)

הפונקציה מוסיפה טווח תאים מוגן.

updateProtectedRange

object (UpdateProtectedRangeRequest)

עדכון טווח מוגן.

deleteProtectedRange

object (DeleteProtectedRangeRequest)

מוחקת טווח תאים מוגן.

autoResizeDimensions

object (AutoResizeDimensionsRequest)

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

addChart

object (AddChartRequest)

הוספת תרשים.

updateChartSpec

object (UpdateChartSpecRequest)

עדכון המפרט של התרשים.

updateBanding

object (UpdateBandingRequest)

עדכון טווח עם טווח

addBanding

object (AddBandingRequest)

הוספת טווח תחומי חדש

deleteBanding

object (DeleteBandingRequest)

הסרת טווח עם תחום

createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

יצירת מטא-נתונים חדשים של מפתח

updateDeveloperMetadata

object (UpdateDeveloperMetadataRequest)

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

deleteDeveloperMetadata

object (DeleteDeveloperMetadataRequest)

מחיקת מטא-נתונים של המפתח

randomizeRange

object (RandomizeRangeRequest)

יוצרת באופן אקראי את הסדר של השורות בטווח.

addDimensionGroup

object (AddDimensionGroupRequest)

יצירת קבוצה בטווח שצוין.

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

מחיקת קבוצה בטווח שצוין.

updateDimensionGroup

object (UpdateDimensionGroupRequest)

עדכון מצב הקבוצה שצוינה.

trimWhitespace

object (TrimWhitespaceRequest)

חיתוך תאים של רווחים לבנים (כמו רווחים, כרטיסיות או שורות חדשות).

deleteDuplicates

object (DeleteDuplicatesRequest)

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

updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

עדכון הגבול של אובייקט מוטמע.

addSlicer

object (AddSlicerRequest)

הוספת כלי סינון.

updateSlicerSpec

object (UpdateSlicerSpecRequest)

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

addDataSource

object (AddDataSourceRequest)

הוספת מקור נתונים.

updateDataSource

object (UpdateDataSourceRequest)

עדכון מקור נתונים.

deleteDataSource

object (DeleteDataSourceRequest)

מחיקת מקור נתונים.

refreshDataSource

object (RefreshDataSourceRequest)

מתבצע רענון של מקור נתונים אחד או יותר ו-dbobjects משויכים.

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

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

UpdateSpreadsheetPropertiesRequest

עדכון מאפיינים של גיליון אלקטרוני.

ייצוג JSON 
{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}
שדות
properties

object (SpreadsheetProperties)

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

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. השורש 'properties' היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

UpdateSheetPropertiesRequest

מעדכן את המאפיינים של הגיליון עם הערכים שצוינו sheetId

ייצוג JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
שדות
properties

object (SheetProperties)

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

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) properties היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

UpdateDimensionPropertiesRequest

מעדכנות את המאפיינים של מאפיינים בטווח שצוין.

ייצוג JSON 
{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  // Union field dimension_range can be only one of the following:
  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
שדות
properties

object (DimensionProperties)

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

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) properties היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

שדה איחוד dimension_range טווח המאפיינים. dimension_range יכול להיות רק אחת מהאפשרויות הבאות:
range

object (DimensionRange)

השורות או העמודות שרוצים לעדכן.

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

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

DataSourceSheetDimensionRange

טווח לאורך מאפיין יחיד DATA_SOURCE גיליון.

ייצוג JSON 
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
שדות
sheetId

integer

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

columnReferences[]

object (DataSourceColumnReference)

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

UpdateNamedRangeRequest

עדכון המאפיינים של טווח התאים בעל השם שצוין namedRangeId

ייצוג JSON 
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
שדות
namedRange

object (NamedRange)

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

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) namedRange היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

RepeatCellRequest

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

אם כותבים תא עם נוסחה, הטווחים של הנוסחה יגדלו אוטומטית לכל שדה בטווח. לדוגמה, אם כותבים תא עם נוסחה =A1 בטווח B2:C4, B2 יהיה =A1, B3 יהיה =A2, B4 יהיה =A3, C2 יהיה =B1, C3 הוא =B2, C4 הוא =B3.

כדי שהטווחים של הנוסחה יהיו סטטיים, משתמשים בפונקציה $ סימן גרפי. לדוגמה, משתמשים בנוסחה =$A$1 כדי למנוע הגדלה של השורה והעמודה.

ייצוג JSON 
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
שדות
range

object (GridRange)

הטווח שבו יש לחזור על התא.

cell

object (CellData)

הנתונים לכתיבה.

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) cell היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

AddNamedRangeRequest

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

ייצוג JSON 
{
  "namedRange": {
    object (NamedRange)
  }
}
שדות
namedRange

object (NamedRange)

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

DeleteNamedRangeRequest

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

ייצוג JSON 
{
  "namedRangeId": string
}
שדות
namedRangeId

string

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

AddSheetRequest

הוספת גיליון חדש. כשגיליון נוסף באינדקס נתון, כל הגיליונות הבאים והאינדקסים גדלים. כדי להוסיף גיליון אובייקטים, צריך להשתמש ב- AddChartRequest במקום זאת, EmbeddedObjectPosition.sheetId או EmbeddedObjectPosition.newSheet.

ייצוג JSON 
{
  "properties": {
    object (SheetProperties)
  }
}
שדות
properties

object (SheetProperties)

המאפיינים שצריכים להיות לגיליון החדש. כל המאפיינים הם אופציונליים. sheetId השדה הוא אופציונלי. אם לא מגדירים מזהה, המזהה יופק באופן אקראי. (מדובר בשגיאה כשמציינים מזהה של גיליון שכבר קיים).

DeleteSheetRequest

מחיקת הגיליון המבוקש.

ייצוג JSON 
{
  "sheetId": integer
}
שדות
sheetId

integer

המזהה של הגיליון שרוצים למחוק.

אם הגיליון כולל DATA_SOURCE הסוג המשויך, DataSource נמחק גם הוא.

AutoFillRequest

מילוי יותר נתונים על סמך נתונים קיימים.

ייצוג JSON 
{
  "useAlternateSeries": boolean,

  // Union field area can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
  // End of list of possible types for union field area.
}
שדות
useAlternateSeries

boolean

True אם צריך ליצור נתונים עם הפונקציה "alternate" סדרות. הנתון הזה משתנה בהתאם לסוג ולכמות של נתוני המקור.

שדה איחוד area האזור למילוי האוטומטי. area יכול להיות רק אחת מהאפשרויות הבאות:
range

object (GridRange)

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

sourceAndDestination

object (SourceAndDestination)

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

SourceAndDestination

שילוב של טווח מקור ודרכים להרחיב את המקור הזה.

ייצוג JSON 
{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
שדות
source

object (GridRange)

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

dimension

enum (Dimension)

המאפיין שבו צריך למלא את הנתונים.

fillLength

integer

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

CutPasteRequest

העברת נתונים מהמקור אל היעד.

ייצוג JSON 
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
שדות
source

object (GridRange)

נתוני המקור לחיתוך.

destination

object (GridCoordinate)

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

pasteType

enum (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 (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
שדות
source

object (GridRange)

טווח המקור להעתקה.

destination

object (GridRange)

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

pasteType

enum (PasteType)

איזה סוג של נתונים להדביק.

pasteOrientation

enum (PasteOrientation)

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

PasteOrientation

איך לבצע פעולת הדבקה.

טיפוסים בני מנייה (enum)
NORMAL מדביקים כרגיל.
TRANSPOSE מדביקים במהופך, כאשר כל השורות הופכות לעמודות, ולהפך.

MergeCellsRequest

מיזוג כל התאים בטווח.

ייצוג JSON 
{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}
שדות
range

object (GridRange)

טווח התאים למיזוג.

mergeType

enum (MergeType)

איך התאים ממוזגים.

MergeType

סוג המיזוג שרוצים ליצור.

טיפוסים בני מנייה (enum)
MERGE_ALL יצירת מיזוג יחיד מהטווח
MERGE_COLUMNS יצירת מיזוג לכל עמודה בטווח
MERGE_ROWS יצירת מיזוג לכל שורה בטווח

UnmergeCellsRequest

ביטול המיזוג של התאים בטווח הנתון.

ייצוג JSON 
{
  "range": {
    object (GridRange)
  }
}
שדות
range

object (GridRange)

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

UpdateBordersRequest

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

  1. טווח: A1:A5 { top: RED, bottom: WHITE }
  2. טווח: A1:A5 { left: BLUE }

כתוצאה מכך, ל-A1:A5 יהיו גבולות { top: RED, bottom: WHITE, left: BLUE } אם רוצים להסיר גבול, הגדירו באופן מפורש את הסגנון כ- NONE

ייצוג JSON 
{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}
שדות
range

object (GridRange)

הטווח שצריך לעדכן את הגבולות שלו.

top

object (Border)

הגבול שיש להציב בחלק העליון של הטווח.

bottom

object (Border)

הגבול שיש להציב בתחתית הטווח.

left

object (Border)

הגבול שצריך להוסיף בצד שמאל של הטווח.

right

object (Border)

הגבול שצריך להוסיף מימין לטווח.

innerHorizontal

object (Border)

הגבול האופקי שיש לכלול בטווח.

innerVertical

object (Border)

הגבול האנכי שיש לכלול בטווח.

UpdateCellsRequest

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

ייצוג JSON 
{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field area.
}
שדות
rows[]

object (RowData)

הנתונים לכתיבה.

fields

string (FieldMask format)

השדות ב-CellData שצריך לעדכן. יש לציין שדה אחד לפחות. השורש הוא CellData; 'row.values' אין לציין סינגל "*" יכולים לשמש כקיצורים לכל שדה.

שדה איחוד area צריך לכתוב את נתוני המיקום. יש להגדיר ערך אחד בדיוק. area יכול להיות רק אחת מהאפשרויות הבאות:
start

object (GridCoordinate)

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

range

object (GridRange)

הטווח שבו צריך לכתוב את הנתונים.

אם הנתונים בשורות אינם מכסים את כל הטווח המבוקש, השדות התואמים את אלו שמוגדרים fields תימחק.

AddFilterViewRequest

הוספת תצוגה מסוננת.

ייצוג JSON 
{
  "filter": {
    object (FilterView)
  }
}
שדות
filter

object (FilterView)

המסנן להוספה. filterViewId השדה הוא אופציונלי. אם לא מגדירים מזהה, המזהה יופק באופן אקראי. (זו שגיאה לציין את המזהה של מסנן שכבר קיים).

AppendCellsRequest

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

ייצוג JSON 
{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string
}
שדות
sheetId

integer

מזהה הגיליון שאליו רוצים להוסיף את הנתונים.

rows[]

object (RowData)

הנתונים שרוצים לצרף.

fields

string (FieldMask format)

השדות ב-CellData שצריך לעדכן. יש לציין שדה אחד לפחות. השורש הוא CellData; 'row.values' אין לציין סינגל "*" יכולים לשמש כקיצורים לכל שדה.

ClearBasicFilterRequest

ניקוי המסנן הבסיסי, אם יש מסנן כזה בגיליון.

ייצוג JSON 
{
  "sheetId": integer
}
שדות
sheetId

integer

מזהה הגיליון שבו יש לנקות את המסנן הבסיסי.

DeleteDimensionRequest

מחיקת המידות מהגיליון.

ייצוג JSON 
{
  "range": {
    object (DimensionRange)
  }
}
שדות
range

object (DimensionRange)

המימדים שצריך למחוק מהגיליון.

DeleteEmbeddedObjectRequest

מחיקת האובייקט המוטמע עם המזהה הנתון.

ייצוג JSON 
{
  "objectId": integer
}
שדות
objectId

integer

המזהה של האובייקט המוטמע למחיקה.

DeleteFilterViewRequest

מוחק תצוגה מסוננת מסוימת.

ייצוג JSON 
{
  "filterId": integer
}
שדות
filterId

integer

מזהה המסנן שרוצים למחוק.

DuplicateFilterViewRequest

שכפול של תצוגת מסנן מסוימת.

ייצוג JSON 
{
  "filterId": integer
}
שדות
filterId

integer

מזהה המסנן המשוכפל.

DuplicateSheetRequest

שכפול התוכן של גיליון.

ייצוג JSON 
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
שדות
sourceSheetId

integer

הגיליון לשכפול.

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

insertSheetIndex

integer

אינדקס מבוסס אפס שאליו צריך להוסיף את הגיליון החדש. האינדקס של כל הגיליונות לאחר מכן גדל.

newSheetId

integer

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

newSheetName

string

שם הגיליון החדש. אם השדה ריק, נבחר עבורך שם חדש.

FindReplaceRequest

חיפוש והחלפה של נתונים בתאים בטווח, בגיליון או בכל הגיליונות

ייצוג JSON 
{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

  // Union field scope can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
  // End of list of possible types for union field scope.
}
שדות
find

string

הערך שצריך לחפש.

replacement

string

הערך שבו יש להשתמש כתחליף.

matchCase

boolean

הערך הוא True אם החיפוש תלוי אותיות רישיות.

matchEntireCell

boolean

הערך הוא True אם הערך של החיפוש צריך להתאים לכל התא.

searchByRegex

boolean

הערך הוא True אם הערך לחיפוש הוא ביטוי רגולרי (regex). הביטוי הרגולרי וההחלפה צריכים לעמוד בכללי הביטוי הרגולרי של Java https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. המחרוזת החלופית יכולה להתייחס לקבוצות לתיעוד. לדוגמה, אם תא אחד מכיל את התוכן "Google Sheets" ולשנייה יש "Google Docs", לאחר מכן מתבצע חיפוש של "o.* (.*)" עם החלפה של "$1 Rocks" ישנה את התוכן של התאים "GSheets Rocks" וגם "GDocs Rocks" בהתאמה.

includeFormulas

boolean

הערך הוא True אם החיפוש צריך לכלול תאים עם נוסחאות. הערך שגוי כדי לדלג על תאים עם נוסחאות.

שדה איחוד scope ההיקף שבו מאתרים או מחליפים אותו – יש להגדיר היקף אחד בלבד. scope יכול להיות רק אחת מהאפשרויות הבאות:
range

object (GridRange)

הטווח לחיפוש/החלפה.

sheetId

integer

הגיליון לחיפוש/החלפה.

allSheets

boolean

True כדי למצוא או להחליף בכל הגיליונות.

InsertDimensionRequest

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

ייצוג JSON 
{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}
שדות
range

object (DimensionRange)

המאפיינים להוספה. גם אינדקס ההתחלה וגם אינדקס הסיום חייבים להיות מוגבלים.

inheritFromBefore

boolean

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

לדוגמה, אם אינדקס שורה 0 יש רקע אדום ואינדקס שורה 1 יש רקע ירוק, הוספת 2 שורות באינדקס 1 יכולה לרשת את הרקע הירוק או האדום. אם המיקום inheritFromBefore True, שתי השורות החדשות יהיו אדומות (כי השורה שלפני נקודת ההזנה הייתה אדומה), ואילו אם inheritFromBefore הוא False, שתי השורות החדשות יהיו ירוקות (מכיוון שהשורה שאחרי נקודת ההזנה הייתה ירוקה).

InsertRangeRequest

הוספת תאים לטווח, תוך הזזה של התאים הקיימים או כלפי מטה.

ייצוג JSON 
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
שדות
range

object (GridRange)

הטווח שיש להוסיף אליו תאים חדשים.

shiftDimension

enum (Dimension)

המאפיין שיועבר כשמוסיפים תאים. אם המיקום ROWS, תאים קיימים יועברו למטה. אם המיקום COLUMNS, תאים קיימים יועברו ימינה.

MoveDimensionRequest

מעבירה שורה אחת או עמודה אחת או יותר.

ייצוג JSON 
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
שדות
source

object (DimensionRange)

מאפייני המקור להעברה.

destinationIndex

integer

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

לדוגמה, בהינתן A1..A5 מתוך 0, 1, 2, 3, 4 ורוצים לזוז "1" וגם "2" בין "3" וגם "4", המקור יהיה ROWS [1..3),ואינדקס היעד יהיה "4" (האינדקס שמבוסס על אפס בשורה 5). התוצאה הסופית תהיה A1..A5 מתוך 0, 3, 1, 2, 4.

UpdateEmbeddedObjectPositionRequest

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

ייצוג JSON 
{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}
שדות
objectId

integer

מזהה האובייקט שמיועד להעברה.

newPosition

object (EmbeddedObjectPosition)

מיקום מפורש להעביר אליו את האובייקט המוטמע. אם המיקום newPosition.sheetId מוגדר, ייווצר גיליון חדש עם המזהה הזה. אם המיקום newPosition.newSheet מוגדר כ-True, ייווצר גיליון חדש עם מזהה שייבחר עבורך.

fields

string (FieldMask format)

השדות של OverlayPosition שאמור להתעדכן כאשר מגדירים מיקום חדש. בשימוש רק אם newPosition.overlayPosition מוגדר, במקרה כזה יש לציין שדה אחד לפחות. הרמה הבסיסית (root) newPosition.overlayPosition היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

PasteDataRequest

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

ייצוג JSON 
{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

  // Union field kind can be only one of the following:
  "delimiter": string,
  "html": boolean
  // End of list of possible types for union field kind.
}
שדות
coordinate

object (GridCoordinate)

הקואורדינטה שבה צריך להתחיל להוסיף את הנתונים.

data

string

הנתונים להוספה.

type

enum (PasteType)

איך מדביקים את הנתונים.

שדה איחוד kind איך לפרש את הנתונים – יש להגדיר ערך אחד בלבד. kind יכול להיות רק אחת מהאפשרויות הבאות:
delimiter

string

התו המפריד בנתונים.

html

boolean

הערך יהיה True אם הנתונים הם HTML.

TextToColumnsRequest

מפצלת עמודת טקסט למספר עמודות על סמך תו מפריד בכל תא.

ייצוג JSON 
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
שדות
source

object (GridRange)

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

delimiter

string

התו המפריד שבו צריך להשתמש. משתמשים בו רק אם הערך של delimiterType הוא CUSTOM

delimiterType

enum (DelimiterType)

סוג התו המפריד שבו צריך להשתמש.

DelimiterType

התו המפריד שבו צריך לפצל.

טיפוסים בני מנייה (enum)
DELIMITER_TYPE_UNSPECIFIED ערך ברירת המחדל. אסור להשתמש בערך הזה.
COMMA ","
SEMICOLON ";
PERIOD "."
SPACE " "
CUSTOM ערך מותאם אישית כפי שמוגדר בתו המפריד.
AUTODETECT זיהוי עמודות באופן אוטומטי.

UpdateFilterViewRequest

מעדכן את המאפיינים של תצוגת המסנן.

ייצוג JSON 
{
  "filter": {
    object (FilterView)
  },
  "fields": string
}
שדות
filter

object (FilterView)

המאפיינים החדשים של תצוגת המסנן.

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) filter היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

DeleteRangeRequest

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

ייצוג JSON 
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
שדות
range

object (GridRange)

טווח התאים למחיקה.

shiftDimension

enum (Dimension)

המאפיין שממנו תאים שנמחקו יוחלפו. אם המיקום ROWS, תאים קיימים יועברו למעלה כדי להחליף את התאים שנמחקו. אם המיקום COLUMNS, תאים קיימים יועברו שמאלה כדי להחליף את התאים שנמחקו.

AppendDimensionRequest

מצרפת שורות או עמודות בסוף הגיליון.

ייצוג JSON 
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
שדות
sheetId

integer

הגיליון שאליו רוצים להוסיף שורות או עמודות.

dimension

enum (Dimension)

האם צריך לצרף שורות או עמודות.

length

integer

מספר השורות או העמודות שרוצים לצרף.

AddConditionalFormatRuleRequest

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

ייצוג JSON 
{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}
שדות
rule

object (ConditionalFormatRule)

הכלל שצריך להוסיף.

index

integer

האינדקס מבוסס אפס שבו יש להוסיף את הכלל.

UpdateConditionalFormatRuleRequest

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

ייצוג JSON 
{
  "index": integer,
  "sheetId": integer,

  // Union field instruction can be only one of the following:
  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
  // End of list of possible types for union field instruction.
}
שדות
index

integer

האינדקס מבוסס אפס של הכלל שיש להחליף או להעביר.

sheetId

integer

הגיליון של הכלל שרוצים להעביר. נדרש אם newIndex מוגדר, לא משמש אותו אחרת.

שדה איחוד instruction סוג העדכון שצריך לבצע. instruction יכול להיות רק אחת מהאפשרויות הבאות:
rule

object (ConditionalFormatRule)

הכלל שצריך להחליף את הכלל באינדקס הנתון.

newIndex

integer

האינדקס החדש שמבוסס על אפס שאליו הכלל אמור להגיע.

DeleteConditionalFormatRuleRequest

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

ייצוג JSON 
{
  "index": integer,
  "sheetId": integer
}
שדות
index

integer

האינדקס מבוסס על אפס של הכלל שיש למחוק.

sheetId

integer

הגיליון שממנו הכלל נמחק.

SortRangeRequest

מיון נתונים בשורות לפי סדר מיון בכל עמודה.

ייצוג JSON 
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
שדות
range

object (GridRange)

הטווח למיון.

sortSpecs[]

object (SortSpec)

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

SetDataValidationRequest

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

ייצוג JSON 
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  }
}
שדות
range

object (GridRange)

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

rule

object (DataValidationRule)

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

SetBasicFilterRequest

מגדיר את המסנן הבסיסי שמשויך לגיליון.

ייצוג JSON 
{
  "filter": {
    object (BasicFilter)
  }
}
שדות
filter

object (BasicFilter)

המסנן שצריך להגדיר.

AddProtectedRangeRequest

הוספת טווח מוגן חדש.

ייצוג JSON 
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
שדות
protectedRange

object (ProtectedRange)

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

UpdateProtectedRangeRequest

מעדכנות טווח מוגן קיים עם הערך שצוין protectedRangeId

ייצוג JSON 
{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}
שדות
protectedRange

object (ProtectedRange)

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

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) protectedRange היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

DeleteProtectedRangeRequest

מוחקת את הטווח המוגן עם המזהה הנתון.

ייצוג JSON 
{
  "protectedRangeId": integer
}
שדות
protectedRangeId

integer

המזהה של הטווח המוגן שצריך למחוק.

AutoResizeDimensionsRequest

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

ייצוג JSON 
{

  // Union field dimension_range can be only one of the following:
  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
שדות
שדה איחוד dimension_range טווח המאפיינים. dimension_range יכול להיות רק אחת מהאפשרויות הבאות:
dimensions

object (DimensionRange)

המאפיינים שיש לשנות את הגודל שלהם באופן אוטומטי.

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

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

AddChartRequest

הוספת תרשים לגיליון בגיליון האלקטרוני.

ייצוג JSON 
{
  "chart": {
    object (EmbeddedChart)
  }
}
שדות
chart

object (EmbeddedChart)

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

UpdateChartSpecRequest

עדכון המפרט של התרשים. (הפעולה הזו לא גורמת להזזה או לשינוי הגודל של תרשים. כדי להזיז תרשים או לשנות את הגודל שלו, אפשר להשתמש UpdateEmbeddedObjectPositionRequest).

ייצוג JSON 
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}
שדות
chartId

integer

מזהה התרשים שצריך לעדכן.

spec

object (ChartSpec)

המפרט שצריך להחיל על התרשים.

UpdateBandingRequest

עדכון המאפיינים של טווח הטווח שצוין.

ייצוג JSON 
{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}
שדות
bandedRange

object (BandedRange)

טווח הטווח שיש לעדכן במאפיינים החדשים.

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) bandedRange היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

AddBandingRequest

הוספת טווח תחומי חדש לגיליון האלקטרוני.

ייצוג JSON 
{
  "bandedRange": {
    object (BandedRange)
  }
}
שדות
bandedRange

object (BandedRange)

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

DeleteBandingRequest

מסירה מהגיליון האלקטרוני את טווח התאים עם המזהה הנתון.

ייצוג JSON 
{
  "bandedRangeId": integer
}
שדות
bandedRangeId

integer

המזהה של טווח התאים למחיקה.

CreateDeveloperMetadataRequest

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

ייצוג JSON 
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
שדות
developerMetadata

object (DeveloperMetadata)

המטא-נתונים של המפתח שצריך ליצור.

UpdateDeveloperMetadataRequest

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

ייצוג JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
שדות
dataFilters[]

object (DataFilter)

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

developerMetadata

object (DeveloperMetadata)

הערך שאליו יעודכנו כל המטא-נתונים שתואמים למסנני הנתונים.

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) developerMetadata היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

DeleteDeveloperMetadataRequest

בקשה למחיקת מטא-נתונים של מפתח.

ייצוג JSON 
{
  "dataFilter": {
    object (DataFilter)
  }
}
שדות
dataFilter

object (DataFilter)

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

RandomizeRangeRequest

יוצרת באופן אקראי את הסדר של השורות בטווח.

ייצוג JSON 
{
  "range": {
    object (GridRange)
  }
}
שדות
range

object (GridRange)

הטווח שצריך להגדיר באקראי.

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 (DimensionRange)
  }
}
שדות
range

object (DimensionRange)

הטווח שבו צריך ליצור קבוצה.

DeleteDimensionGroupRequest

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

לדוגמה, נניח שהגיליון כולל קבוצה של עומק 1 מעל B:E וקבוצת עומק-2 מעל C:D. מחיקת קבוצה על ידי D:E יוצאת מהגיליון עם קבוצה מסוג 'עומק 1' מעל B:D וקבוצת עומק 2 עבור C:C.

ייצוג JSON 
{
  "range": {
    object (DimensionRange)
  }
}
שדות
range

object (DimensionRange)

הטווח של הקבוצה שרוצים למחוק.

UpdateDimensionGroupRequest

עדכון מצב הקבוצה שצוינה.

ייצוג JSON 
{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}
שדות
dimensionGroup

object (DimensionGroup)

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

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) dimensionGroup היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

TrimWhitespaceRequest

חיתוך של רווחים לבנים (כמו רווחים, כרטיסיות או שורות חדשות) בכל תא בטווח שצוין. הבקשה הזו מסירה את כל הרווחים הלבנים מההתחלה והסוף של הטקסט בכל תא, ומצמצמת את כל הרצף של התווים הלבן שנותרו לרווח אחד. אם הטקסט החתוך שמתקבל מתחיל ב-'+' או '=' , הטקסט נשאר כערך מחרוזת ולא מתפרש כנוסחה.

ייצוג JSON 
{
  "range": {
    object (GridRange)
  }
}
שדות
range

object (GridRange)

הטווח שאת התאים שלו צריך לחתוך.

DeleteDuplicatesRequest

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

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

ייצוג JSON 
{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
שדות
range

object (GridRange)

הטווח שממנו יש להסיר שורות כפולות.

comparisonColumns[]

object (DimensionRange)

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

UpdateEmbeddedObjectBorderRequest

עדכון מאפיין הגבול של אובייקט מוטמע.

ייצוג JSON 
{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}
שדות
objectId

integer

המזהה של האובייקט המוטמע שצריך לעדכן.

border

object (EmbeddedObjectBorder)

הגבול שחל על האובייקט המוטמע.

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) border היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

AddSlicerRequest

הוספת כלי סינון לגיליון בגיליון האלקטרוני.

ייצוג JSON 
{
  "slicer": {
    object (Slicer)
  }
}
שדות
slicer

object (Slicer)

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

UpdateSlicerSpecRequest

מעדכן את המפרט של כלי הסינון. (הפעולה הזו לא גורמת להעברה של כלי הסינון או לשינוי הגודל שלו. כדי להזיז את כלי הסינון או לשנות את הגודל שלו UpdateEmbeddedObjectPositionRequest

ייצוג JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}
שדות
slicerId

integer

המזהה של כלי הסינון שצריך לעדכן.

spec

object (SlicerSpec)

המפרט שצריך להחיל על כלי הסינון.

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) SlicerSpec היא משתמעת ואין לציין אותה. אפשר להשתמש בסימן '*' יחיד בתור קיצור של כל שדה.

AddDataSourceRequest

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

הבקשה מחייבת פרטים נוספים bigquery.readonly היקף הרשאות OAuth, אם אתם מוסיפים מקור נתונים של BigQuery.

ייצוג JSON 
{
  "dataSource": {
    object (DataSource)
  }
}
שדות
dataSource

object (DataSource)

מקור הנתונים להוספה.

UpdateDataSourceRequest

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

הבקשה מחייבת פרטים נוספים bigquery.readonly היקף הרשאות OAuth אם אתם מעדכנים מקור נתונים של BigQuery.

ייצוג JSON 
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
שדות
dataSource

object (DataSource)

מקור הנתונים שצריך לעדכן.

fields

string (FieldMask format)

השדות שצריך לעדכן. יש לציין שדה אחד לפחות. הרמה הבסיסית (root) dataSource היא משתמעת ואין לציין אותה. סינגל "*" יכולים לשמש כקיצורים לכל שדה.

DeleteDataSourceRequest

מחיקת מקור נתונים. בנוסף, הבקשה מוחקת את הגיליון המשויך של מקור הנתונים, ומבטלת את הקישור של כל האובייקטים של מקור הנתונים המשויכים.

ייצוג JSON 
{
  "dataSourceId": string
}
שדות
dataSourceId

string

המזהה של מקור הנתונים שרוצים למחוק.

RefreshDataSourceRequest

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

הבקשה מחייבת פרטים נוספים bigquery.readonly היקף ההרשאות ב-OAuth אם אתם מרעננים מקור נתונים של BigQuery.

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

ייצוג JSON 
{
  "force": boolean,

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
שדות
force

boolean

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

שדה איחוד target קובעת מה לרענן. target יכול להיות רק אחת מהאפשרויות הבאות:
references

object (DataSourceObjectReferences)

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

dataSourceId

string

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

isAll

boolean

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

DataSourceObjectReferences

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

ייצוג JSON 
{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}
שדות
references[]

object (DataSourceObjectReference)

קובצי העזר.

CancelDataSourceRefreshRequest

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

הבקשה מחייבת פרטים נוספים bigquery.readonly היקף OAuth אם מבטלים רענון במקור נתונים של BigQuery.

ייצוג JSON 
{

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
שדות
שדה איחוד target בעמודה הזו מציינים מה לבטל. target יכול להיות רק אחת מהאפשרויות הבאות:
references

object (DataSourceObjectReferences)

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

dataSourceId

string

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

isAll

boolean

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