מחזירה טווח ערכים מגיליון אלקטרוני. המתקשר חייב לציין את המזהה של הגיליון האלקטרוני ואת הטווח שלו.
בקשת HTTP
GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}
כתובת ה-URL כוללת תחביר של קידוד gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
spreadsheetId |
מזהה הגיליון האלקטרוני שממנו יש לאחזר את הנתונים. |
range |
סימון A1 או סימון R1C1 של הטווח שממנו יש לאחזר את הערכים. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
majorDimension |
המאפיין העיקרי שבו יש להשתמש בתוצאות. לדוגמה, אם נתוני הגיליון האלקטרוני בגיליון האלקטרוני הוא: |
valueRenderOption |
איך לייצג את הערכים בפלט. אפשרות הרינדור שמוגדרת כברירת המחדל היא |
dateTimeRenderOption |
האופן שבו תאריכים, שעות ומשכים צריכים להיות מיוצגים בפלט. המערכת תתעלם מהמדיניות הזו אם |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה בהצלחה, גוף התגובה מכיל מופע של 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
למידע נוסף, ניתן לעיין במדריך ההרשאה.