Method: spreadsheets.values.batchGet

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

בקשת HTTP

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

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

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

פרמטרים
spreadsheetId

string

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

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

פרמטרים
ranges[]

string

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

enum (Dimension)

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

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

enum (ValueRenderOption)

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

enum (DateTimeRenderOption)

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

גוף הבקשה

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

גוף התשובה

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

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
שדות
spreadsheetId

string

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

object (ValueRange)

הערכים המבוקשים. הסדר של ה-ValueRanges זהה לסדר של הטווחים המבוקשים.

היקפי ההרשאות

נדרש אחד מהיקפי ההרשאות הבאים של 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

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