בקשה
סוג אחד של עדכון שניתן להחיל על גיליון אלקטרוני.
ייצוג 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
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. מאפייני הבסיס של השורש הם משתמעים ואין לציין אותם. אפשר להשתמש בשדה
|
UpdateSheetPropertiesRequest
עדכון המאפיינים של הגיליון עם הערך שצוין בשדה sheetId
.
ייצוג JSON |
---|
{
"properties": {
object (
|
שדות | |
---|---|
properties
|
המאפיינים שצריך לעדכן. |
fields
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
UpdateDimensionPropertiesRequest
עדכון המאפיינים של מאפיינים בטווח שצוין.
ייצוג JSON |
---|
{ "properties": { object ( |
שדות | |
---|---|
properties
|
מאפיינים לעדכון. |
fields
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
שדה איחוד
dimension_range . טווח המאפיינים.
dimension_range
יכול להיות רק אחד מהבאים:
|
|
range
|
השורות או העמודות שצריך לעדכן. |
dataSourceSheetRange
|
העמודות בגיליון של מקור הנתונים שצריך לעדכן. |
DataSourceSheetDimensionRange
טווח לאורך מאפיין יחיד בגיליון
DATA_SOURCE
.
ייצוג JSON |
---|
{
"sheetId": integer,
"columnReferences": [
{
object (
|
שדות | |
---|---|
sheetId
|
המזהה של גיליון מקור הנתונים שבו נמצא הטווח. |
columnReferences[]
|
העמודות בגיליון של מקור הנתונים. |
UpdateNamedRangeRequest
מעדכנות את המאפיינים של הטווח בעל השם עם הערך שצוין בשדה
namedRangeId
.
ייצוג JSON |
---|
{
"namedRange": {
object (
|
שדות | |
---|---|
namedRange
|
הטווח בעל השם שיש לעדכן במאפיינים החדשים. |
fields
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
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
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
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 אם עלינו ליצור נתונים עם הסדרה החלופית. משך הזמן משתנה בהתאם לסוג ולכמות של נתוני המקור. |
שדה איחוד
area . האזור למילוי אוטומטי.
area
יכול להיות רק אחד מהבאים:
|
|
range
|
הטווח למילוי אוטומטי. הפעולה הזו תבדוק את הטווח ותזהה את המיקום שיש בו נתונים ותמלא את הנתונים האלה באופן אוטומטי בשאר הטווח. |
sourceAndDestination
|
אזורי המקור והיעד למילוי אוטומטי. השדה הזה מציין במפורש את מקור המילוי האוטומטי ואיפה להרחיב את הנתונים האלה. |
SourceAndDestination
שילוב של טווח מקור ואיך להרחיב את המקור.
ייצוג JSON |
---|
{ "source": { object ( |
שדות | |
---|---|
source
|
מיקום הנתונים שישמשו כמקור למילוי האוטומטי. |
dimension
|
המאפיין שבו צריך למלא את הנתונים. |
fillLength
|
מספר השורות או העמודות שבהן צריך למלא את הנתונים. מספרים חיוביים מתרחבים מעבר לשורה האחרונה או לעמודה האחרונה של המקור. מספרים שליליים מתרחבים לפני השורה הראשונה או העמודה הראשונה של המקור. |
CutPasteRequest
מעביר נתונים מהמקור ליעד.
ייצוג JSON |
---|
{ "source": { object ( |
שדות | |
---|---|
source
|
נתוני המקור לגזירה. |
destination
|
הקואורדינטה השמאלית העליונה שבה יש להדביק את הנתונים. |
pasteType
|
איזה סוג של נתונים להדביק. כל נתוני המקור ייחתכו, ללא קשר לנתונים שיודבקו. |
PasteType
אילו סוגי נתונים יש להדביק.
טיפוסים בני מנייה (enums) | |
---|---|
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
איך יש לבצע פעולת הדבקה.
טיפוסים בני מנייה (enums) | |
---|---|
NORMAL
|
מדביקים כרגיל. |
TRANSPOSE
|
הדבקה במהופך, כך שכל השורות הופכות לעמודות ולהפך. |
MergeCellsRequest
מיזוג כל התאים בטווח.
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
טווח התאים למיזוג. |
mergeType
|
האופן שבו צריך למזג את התאים. |
MergeType
סוג המיזוג שצריך ליצור.
טיפוסים בני מנייה (enums) | |
---|---|
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
|
אינדקס ההתחלה (אפס) שמייצג את המקום שאליו מעבירים את נתוני המקור, על סמך הקואורדינטות לפני הסרת נתוני המקור מהרשת. הנתונים הקיימים יזוזו למטה או ימינה (בהתאם למאפיין) כדי לפנות מקום למאפיינים שהועברו. מאפייני המקור מוסרים מהרשת, לכן ייתכן שהנתונים בסופו של דבר יהיו באינדקס שונה מזה שצוין.
לדוגמה, בהינתן
|
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
התו המפריד שבו יש לפצל.
טיפוסים בני מנייה (enums) | |
---|---|
DELIMITER_TYPE_UNSPECIFIED
|
ערך ברירת המחדל. אי אפשר להשתמש בערך הזה. |
COMMA
|
"," |
SEMICOLON
|
";" |
PERIOD
|
"." |
SPACE
|
" " |
CUSTOM
|
ערך מותאם אישית כפי שמוגדר בתו מפריד. |
AUTODETECT
|
זיהוי עמודות באופן אוטומטי. |
UpdateFilterViewRequest
המערכת מעדכנת את המאפיינים של תצוגת המסנן.
ייצוג JSON |
---|
{
"filter": {
object (
|
שדות | |
---|---|
filter
|
המאפיינים החדשים של תצוגת המסנן. |
fields
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
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
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
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
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
AddBandingRequest
הוספת טווח פסים חדש לגיליון האלקטרוני.
ייצוג JSON |
---|
{
"bandedRange": {
object (
|
שדות | |
---|---|
bandedRange
|
הטווח של פסים שצריך להוסיף. השדה
|
DeleteBandingRequest
מסירה מהגיליון האלקטרוני את הטווח המתוחם עם המזהה הנתון.
ייצוג JSON |
---|
{ "bandedRangeId": integer } |
שדות | |
---|---|
bandedRangeId
|
המזהה של הטווח הפסיבי למחיקה. |
CreateDeveloperMetadataRequest
בקשה ליצירת מטא נתונים של מפתח.
ייצוג JSON |
---|
{
"developerMetadata": {
object (
|
שדות | |
---|---|
developerMetadata
|
המטא נתונים של המפתח ליצירה. |
UpdateDeveloperMetadataRequest
בקשה לעדכון מאפיינים של מטא נתונים של מפתח. עדכון מאפייני המטא-נתונים של המפתח שנבחרו על ידי המסננים לערכים שצוינו
במשאב DeveloperMetadata
. הקוראים חייבים לציין את המאפיינים שהם רוצים לעדכן בפרמטר של השדות, וגם לציין לפחות
DataFilter
אחד שתואם למטא-נתונים שהם רוצים לעדכן.
ייצוג JSON |
---|
{ "dataFilters": [ { object ( |
שדות | |
---|---|
dataFilters[]
|
המסננים שתואמים לרשומות המטא-נתונים של המפתח שיש לעדכן. |
developerMetadata
|
הערך שכל המטא-נתונים שתואמים למסנני הנתונים יעודכנו. |
fields
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
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. לדוגמה, קבוצה [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
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
TrimWhitespaceRequest
חיתוך הרווחים הלבן (כגון רווחים, כרטיסיות או שורות חדשות) בכל תא בטווח שצוין. הבקשה הזו מסירה את כל הרווחים הלבנים מתחילת הטקסט של כל תא ומהסוף שלו, ומקטינה כל רצף של תווים לבנים שנותרו לרווח אחד. אם הטקסט הקטוע שמתקבל מתחיל בתו '+' או '=', הטקסט יישאר כערך מחרוזת ולא יפורש כנוסחה.
ייצוג JSON |
---|
{
"range": {
object (
|
שדות | |
---|---|
range
|
הטווח שיש לחתוך את התאים שלו. |
DeleteDuplicatesRequest
הפונקציה מסירה שורות בטווח הזה שמכילות ערכים מהעמודות שצוינו שהם כפילויות של ערכים בכל שורה קודמת. שורות עם ערכים זהים, אבל עם הבדלים באותיות רישיות, בעיצוב או בנוסחאות שונים, נחשבות לכפילויות.
כמו כן, הבקשה הזו מסירה שורות כפולות מוסתרות (לדוגמה, עקב מסנן). כשמסירים עותקים כפולים, המופע הראשון של כל סריקת שורה כפולה מלמעלה למטה נשמר בטווח שמתקבל. תוכן שנמצא מחוץ לטווח שצוין לא יוסר, ושורות שנחשבות ככפילויות לא חייבות להיות סמוכות זו לזו בטווח.
ייצוג JSON |
---|
{ "range": { object ( |
שדות | |
---|---|
range
|
הטווח שיש להסיר ממנו שורות כפולות. |
comparisonColumns[]
|
העמודות בטווח שיש לנתח לאיתור ערכים כפולים. אם לא בוחרים עמודות, מתבצע ניתוח של כל העמודות כדי לאתר כפילויות. |
UpdateEmbeddedObjectBorderRequest
עדכון מאפיין גבול של אובייקט מוטמע.
ייצוג JSON |
---|
{
"objectId": integer,
"border": {
object (
|
שדות | |
---|---|
objectId
|
המזהה של האובייקט המוטמע שיש לעדכן. |
border
|
הגבול שחל על האובייקט המוטמע. |
fields
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
AddSlicerRequest
הוספת כלי סינון לגיליון בגיליון האלקטרוני.
ייצוג JSON |
---|
{
"slicer": {
object (
|
שדות | |
---|---|
slicer
|
כלי הסינון שצריך להוסיף לגיליון האלקטרוני, כולל המיקום שבו צריך למקם אותו. השדה
|
UpdateSlicerSpecRequest
עדכון המפרטים של כלי הסינון. (פעולה זו לא מעבירה כלי סינון ולא משנה את הגודל שלו. כדי להזיז כלי סינון או לשנות את הגודל שלו, צריך להשתמש ב-UpdateEmbeddedObjectPositionRequest
.
ייצוג JSON |
---|
{
"slicerId": integer,
"spec": {
object (
|
שדות | |
---|---|
slicerId
|
המזהה של כלי הסינון שצריך לעדכן. |
spec
|
המפרט שצריך להחיל על כלי הסינון. |
fields
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
AddDataSourceRequest
הוספה של מקור נתונים. אחרי שמקור הנתונים נוסף בהצלחה, נוצר גיליון DATA_SOURCE
משויך ומופעלת הפעלה לרענון הגיליון כדי לקרוא נתונים ממקור הנתונים. לבקשה נדרש היקף OAuth נוסף של
bigquery.readonly
.
ייצוג JSON |
---|
{
"dataSource": {
object (
|
שדות | |
---|---|
dataSource
|
מקור הנתונים להוספה. |
UpdateDataSourceRequest
עדכון מקור נתונים. אחרי שמקור הנתונים יתעדכן, תופעל הפעלה לרענון הגיליון
DATA_SOURCE
המשויך
כדי לקרוא נתונים ממקור הנתונים המעודכן. לבקשה נדרש היקף OAuth נוסף של
bigquery.readonly
.
ייצוג JSON |
---|
{
"dataSource": {
object (
|
שדות | |
---|---|
dataSource
|
מקור הנתונים שצריך לעדכן. |
fields
|
השדות שצריך לעדכן. יש לציין לפחות שדה אחד. השורש |
DeleteDataSourceRequest
מחיקת מקור נתונים. כתוצאה מכך, הבקשה גם מוחקת את הגיליון המשויך של מקור הנתונים ומבטלת את הקישור של כל האובייקטים המשויכים למקור הנתונים.
ייצוג JSON |
---|
{ "dataSourceId": string } |
שדות | |
---|---|
dataSourceId
|
המזהה של מקור הנתונים למחיקה. |
RefreshDataSourceRequest
רענון של אובייקט מקור נתונים אחד או יותר בגיליון האלקטרוני לפי ההפניות שצוינו. לבקשה נדרש היקף OAuth נוסף של
bigquery.readonly
.
אם יש כמה בקשות רענון שמפנות לאותם אובייקטים של מקור נתונים באצווה אחת, רק בקשת הרענון האחרונה תעובד ולכל הבקשות האלה תקבל את אותה תגובה בהתאם.
ייצוג JSON |
---|
{ "force": boolean, // Union field |
שדות | |
---|---|
force
|
רענון האובייקטים של מקור הנתונים ללא קשר למצב הנוכחי. אם המדיניות לא מוגדרת, ואובייקט של מקור נתונים שיש אליו הפניה נמצא במצב שגיאה, הרענון ייכשל באופן מיידי. |
שדה איחוד
target . מציין מה לרענן.
target
יכול להיות רק אחד מהבאים:
|
|
references
|
הפניות לאובייקטים של מקור נתונים לרענון. |
dataSourceId
|
הפניה אל
|
isAll
|
רענון של כל האובייקטים הקיימים של מקור הנתונים בגיליון האלקטרוני. |
DataSourceObjectReferences
רשימת הפניות לאובייקטים של מקור נתונים.
ייצוג JSON |
---|
{
"references": [
{
object (
|
שדות | |
---|---|
references[]
|
ההפניות. |
DataSourceObjectReference
הפניה לאובייקט של מקור נתונים.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
value . סוג ההפניה.
value
יכול להיות רק אחד מהבאים:
|
|
sheetId
|
הפניות לגיליון |
chartId
|
הפניות לתרשים של מקור נתונים. |
dataSourceTableAnchorCell
|
הפניות אל |
dataSourcePivotTableAnchorCell
|
הפניות למקור נתונים
|
dataSourceFormulaCell
|
הפניות לתא שמכיל
|
CancelDataSourceRefreshRequest
מבטל רענון אחד או יותר של אובייקטים של מקור נתונים בגיליון האלקטרוני, לפי ההפניות שצוינו.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
target . מציין מה לבטל.
target
יכול להיות רק אחד מהבאים:
|
|
references
|
הפניות לאובייקטים של מקור נתונים שיש לבטל את הרענון שלהם. |
dataSourceId
|
הפניה אל
|
isAll
|
מבטל את כל הרענון של אובייקטים קיימים של מקור נתונים בכל מקורות הנתונים בגיליון האלקטרוני. |