REST Resource: spreadsheets.values

משאב: ValueRange

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

ייצוג JSON
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
שדות
range

string

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

majorDimension

enum (Dimension)

המאפיין הראשי של הערכים.

לפלט, אם נתוני הגיליון האלקטרוני הם: A1=1,B1=2,A2=3,B2=4, אז בקשת range=A1:B2,majorDimension=ROWS תחזיר [[1,2],[3,4]], בעוד שבקשת range=A1:B2,majorDimension=COLUMNS תחזיר [[1,3],[2,4]].

לקלט, range=A1:B2,majorDimension=ROWS עם הערך [[1,2],[3,4]] יגדיר את A1=1,B1=2,A2=3,B2=4. עם range=A1:B2,majorDimension=COLUMNS, [[1,2],[3,4]] יגדיר את A1=1,B1=3,A2=2,B2=4.

בכתיבה, אם השדה הזה לא מוגדר, ברירת המחדל היא ROWS.

values[]

array (ListValue format)

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

לגבי פלט, לא ייכללו שורות ועמודות ריקות.

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

שיטות

append

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

batchClear

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

batchClearByDataFilter

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

batchGet

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

batchGetByDataFilter

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

batchUpdate

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

batchUpdateByDataFilter

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

clear

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

get

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

update

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