Method: spreadsheets.values.append

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
spreadsheetId

string

המזהה של הגיליון האלקטרוני שרוצים לעדכן.
range

string

סימון A1 של טווח לחיפוש טבלה לוגית של נתונים. הערכים מצורפים אחרי השורה האחרונה בטבלה.

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

פרמטרים
valueInputOption

enum (ValueInputOption)

איך צריך לפרש את נתוני הקלט.
insertDataOption

enum (InsertDataOption)

איך להוסיף את נתוני הקלט.
includeValuesInResponse

boolean

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

enum (ValueRenderOption)

קובעת את האופן שבו יש להציג את הערכים בתגובה. אפשרות העיבוד שמוגדרת כברירת מחדל היא FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

קובע איך יתבצע העיבוד של תאריכים, שעות ומרווחי זמן בתגובה. המערכת מתעלמת מהערך הזה אם responseValueRenderOption הוא FORMATTED_VALUE. אפשרות ברירת המחדל של עיבוד dateTime היא SERIAL_NUMBER.

גוף הבקשה

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

גוף התשובה

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

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
שדות
spreadsheetId

string

גיליון האלקטרוני שבו הוחלו העדכונים.
tableRange

string

הטווח (בסימן A1) של הטבלה שאליה מצורפים הערכים (לפני הוספת הערכים). הערך יהיה ריק אם לא נמצאה טבלה.
updates

object (UpdateValuesResponse)

מידע על העדכונים שהוחלו.

היקפי הרשאה

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

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

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

InsertDataOption

קובעת איך הנתונים הקיימים משתנים כשמזינים נתונים חדשים.

טיפוסים בני מנייה (enum)
OVERWRITE הנתונים החדשים מחליפים את הנתונים הקיימים באזורים שבהם הם נכתבים. (הערה: הוספת נתונים לסוף הגיליון עדיין תוסיף שורות או עמודות חדשות כדי שניתן יהיה לכתוב את הנתונים).
INSERT_ROWS המערכת תוסיף שורות לנתונים החדשים.