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

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