Method: spreadsheets.get

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

כברירת מחדל, המערכת לא מחזירה נתונים בתוך רשתות. אפשר לכלול נתוני רשת באחת משתי דרכים:

  • מציינים מסכת שדה עם פירוט השדות הרצויים באמצעות פרמטר כתובת ה-URL fields ב-HTTP

  • מגדירים את הפרמטר של כתובת ה-URL includeGridData לערך true. אם מוגדר מסכת שדה, המערכת מתעלמת מהפרמטר includeGridData

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

כדי לאחזר רק קבוצות משנה של נתוני הגיליון האלקטרוני, משתמשים בפרמטר ה-URL ranges. מציינים טווחים באמצעות סימון A1. אפשר להגדיר תא יחיד (לדוגמה, A1) או כמה תאים (לדוגמה, A1:D5). אפשר גם לקבל תאים מגיליונות אחרים באותו גיליון אלקטרוני (לדוגמה, Sheet2!A1:C4) או לאחזר כמה טווחים בו-זמנית (לדוגמה, ?ranges=A1:D5&ranges=Sheet2!A1:C4). הגבלת הטווח מחזירה רק את החלקים בגיליון האלקטרוני שמצטלבים עם הטווחים המבוקשים.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
spreadsheetId

string

הגיליון האלקטרוני שרוצים לבקש.

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

פרמטרים
ranges[]

string

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

boolean

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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