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. אפשרות ברירת המחדל לרינדור 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

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

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