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)

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

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

סוגי הערכים הנתמכים בקלט הם: bool,‏ string ו-double. המערכת תדלג על ערכי Null. כדי להגדיר תא לערך ריק, מגדירים את ערך המחרוזת כמחרוזת ריקה.

שיטות

append

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

batchClear

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

batchClearByDataFilter

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

batchGet

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

batchGetByDataFilter

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

batchUpdate

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

batchUpdateByDataFilter

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

clear

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

get

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

update

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