REST Resource: spreadsheets.values

משאב: ValueRange

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

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

string

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

enum (Dimension)

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

בתגובה להפעלה של range=A1:B2,majorDimension=ROWS, אם נתוני הגיליון האלקטרוני הם A1=1,B1=2,A2=3,B2=4, הפונקציה תחזיר את הערך [[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. כדי להגדיר תא לערך ריק, מגדירים את ערך המחרוזת כמחרוזת ריקה.

Methods

append

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

batchClear

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

batchClearByDataFilter

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

batchGet

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

batchGetByDataFilter

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

batchUpdate

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

batchUpdateByDataFilter

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

clear

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

get

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

update

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