REST Resource: spreadsheets.values

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

string

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

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.

array (ListValue format)

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

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

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