Method: spreadsheets.values.append

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

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

בקשת HTTP

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

כתובת ה-URL כוללת תחביר של קידוד 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. אפשרות העיבוד המוגדרת כברירת מחדל של תאריך ושעה היא 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

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

אפשרות InsertData

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

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