REST Resource: spreadsheets.values

{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}

string

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

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.

array (ListValue format)

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

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

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