Method: spreadsheets.get

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

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

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

  • מגדירים את הפרמטר includeGridData של כתובת האתר כ-True. אם מוגדרת אנונימיזציה של שדות, המערכת מתעלמת מהפרמטר includeGridData

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

כדי לאחזר רק קבוצות משנה של נתונים בגיליון אלקטרוני, אפשר להשתמש בפרמטר 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 נעשה שימוש בתחביר המרת קידוד של 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

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