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

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

InsertDataOption

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

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