Method: spreadsheets.values.get

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

בקשת HTTP

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

כתובת ה-URL כוללת תחביר של קידוד gRPC.

פרמטרים של נתיב

פרמטרים
spreadsheetId

string

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

string

סימון A1 או סימון R1C1 של הטווח שממנו יש לאחזר את הערכים.

פרמטרים של שאילתה

פרמטרים
majorDimension

enum (Dimension)

המאפיין העיקרי שבו יש להשתמש בתוצאות.

לדוגמה, אם נתוני הגיליון האלקטרוני בגיליון האלקטרוני הוא: A1=1,B1=2,A2=3,B2=4, אז הבקשה range=Sheet1!A1:B2?majorDimension=ROWS מחזירה את הערך [[1,2],[3,4]], ואילו הבקשה range=Sheet1!A1:B2?majorDimension=COLUMNS מחזירה [[1,3],[2,4]].
valueRenderOption

enum (ValueRenderOption)

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

enum (DateTimeRenderOption)

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

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה בוצעה בהצלחה, גוף התגובה מכיל מופע של ValueRange.

היקפי הרשאה

מחייב אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

למידע נוסף, ניתן לעיין במדריך ההרשאה.