Method: spreadsheets.values.update

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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