- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- רוצים לנסות?
מגדיר ערכים בטווח אחד או יותר של גיליון אלקטרוני. מבצע הקריאה החוזרת צריך לציין את המזהה של הגיליון האלקטרוני, valueInputOption
ו-DataFilterValueRanges
אחד או יותר.
בקשת HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
spreadsheetId |
המזהה של הגיליון האלקטרוני שצריך לעדכן. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "valueInputOption": enum ( |
שדות | |
---|---|
valueInputOption |
איך צריך לפרש את נתוני הקלט. |
data[] |
הערכים החדשים שצריך להחיל על הגיליון האלקטרוני. אם הפרמטר |
includeValuesInResponse |
הפונקציה קובעת אם תגובת העדכון צריכה לכלול את הערכים של התאים שעודכנו. כברירת מחדל, התשובות לא כוללות את הערכים המעודכנים. השדה |
responseValueRenderOption |
ההגדרה הזו קובעת איך המערכת תעבד את הערכים בתשובה. אפשרות ברירת המחדל לעיבוד היא |
responseDateTimeRenderOption |
ההגדרה הזו קובעת איך להציג תאריכים, שעות ומשכי זמן בתשובה. המערכת תתעלם אם הערך של |
גוף התשובה
התגובה כשמעדכנים טווח ערכים בגיליון אלקטרוני.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
שדות | |
---|---|
spreadsheetId |
הגיליון האלקטרוני שעליו הוחלו העדכונים. |
totalUpdatedRows |
המספר הכולל של השורות שבהן עודכן תא אחד לפחות בשורה. |
totalUpdatedColumns |
המספר הכולל של העמודות שבהן עודכן תא אחד לפחות בעמודה. |
totalUpdatedCells |
המספר הכולל של התאים שעודכנו. |
totalUpdatedSheets |
המספר הכולל של גיליונות שבהם עודכן תא אחד לפחות בגיליון. |
responses[] |
התגובה לכל טווח מתעדכנת. |
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
מידע נוסף זמין במדריך להרשאות.
DataFilterValueRange
טווח ערכים שהמיקום שלהם מצוין על ידי DataFilter
.
ייצוג JSON |
---|
{ "dataFilter": { object ( |
שדות | |
---|---|
dataFilter |
מסנן הנתונים שמתאר את המיקום של הערכים בגיליון האלקטרוני. |
majorDimension |
המאפיין העיקרי של הערכים. |
values[] |
הנתונים לכתיבה. אם הערכים שסופקו חורגים מאחד מהטווחים שתואמים למסנן הנתונים, הבקשה תיכשל. אם הערכים שסופקו נמוכים מהטווחים התואמים, רק הערכים שצוינו נכתבים, הערכים הקיימים בטווחים התואמים לא יושפעו. |
UpdateValuesByDataFilterResponse
התגובה כשמעדכנים טווח ערכים באמצעות מסנן נתונים בגיליון אלקטרוני.
ייצוג JSON |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
שדות | |
---|---|
updatedRange |
הטווח (בסימון A1) שהעדכונים הוחלו עליו. |
updatedRows |
מספר השורות שבהן עודכן תא אחד לפחות בשורה. |
updatedColumns |
מספר העמודות שבהן עודכן תא אחד לפחות בעמודה. |
updatedCells |
מספר התאים שעודכנו. |
dataFilter |
מסנן הנתונים שבחר את הטווח המעודכן. |
updatedData |
ערכי התאים בטווח תואמים למסנן הנתונים אחרי שכל העדכונים הוחלו. אפשר לכלול את המידע הזה רק אם השדה |