Method: spreadsheets.values.update

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתה
• גוף הבקשה
• גוף התשובה
• היקפי הרשאות
• רוצים לנסות?

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

בקשת HTTP

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

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

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

פרמטרים
spreadsheetId	string המזהה של הגיליון האלקטרוני לעדכון.
range	string סימון A1 של הערכים שיש לעדכן.

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

פרמטרים
valueInputOption	enum (ValueInputOption) איך לפרש את נתוני הקלט.
includeValuesInResponse	boolean קובעת אם תגובת העדכון צריכה לכלול את הערכים של התאים שעודכנו. כברירת מחדל, התשובות לא כוללות את הערכים המעודכנים. אם הטווח לכתיבה היה גדול מהטווח שכתוב בפועל, התשובה תכלול את כל הערכים שבטווח המבוקש (לא כולל שורות ועמודות ריקות).
responseValueRenderOption	enum (ValueRenderOption) היא קובעת את אופן הרינדור של הערכים בתגובה. אפשרות הרינדור שמוגדרת כברירת המחדל היא FORMATTED_VALUE.
responseDateTimeRenderOption	enum (DateTimeRenderOption) היא קובעת את אופן העיבוד של תאריכים, שעות ומשכי זמן בתגובה. המערכת תתעלם מהמדיניות הזו אם responseValueRenderOption הוא FORMATTED_VALUE. אפשרות העיבוד המוגדרת כברירת מחדל של תאריך ושעה היא SERIAL_NUMBER.

גוף הבקשה

גוף הבקשה מכיל מופע של ValueRange.

גוף התשובה

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

היקפי הרשאה

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

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

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