- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- InsertDataOption
- רוצים לנסות?
מצרף ערכים לגיליון אלקטרוני. טווח הקלט משמש לחיפוש נתונים קיימים ולמציאת 'טבלה' בטווח הזה. הערכים יצורפו לשורה הבאה בטבלה, החל מהעמודה הראשונה של הטבלה. אפשר לעיין במדריך ובקוד לדוגמה כדי לקבל פרטים ספציפיים על אופן הזיהוי של טבלאות וצירוף הנתונים.
מבצע הקריאה החוזרת צריך לציין את המזהה, הטווח וvalueInputOption
של הגיליון האלקטרוני. valueInputOption
קובע רק איך נתוני הקלט יתווספו לגיליון (ברמת העמודה או השורה), ולא משפיע על התא שבו תתחיל כתיבת הנתונים.
בקשת HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
spreadsheetId |
מזהה הגיליון האלקטרוני שיש לעדכן. |
range |
סימון A1 של טווח לחיפוש טבלה לוגית של נתונים. הערכים מתווספים אחרי השורה האחרונה של הטבלה. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
valueInputOption |
האופן שבו יש לפרש את נתוני הקלט. |
insertDataOption |
האופן שבו יש להוסיף את נתוני הקלט. |
includeValuesInResponse |
המדיניות הזו קובעת אם תגובת העדכון תכלול את הערכים של התאים שצורפו. כברירת מחדל, התשובות לא כוללות את הערכים המעודכנים. |
responseValueRenderOption |
קביעת אופן העיבוד של הערכים בתשובה. אפשרות ברירת המחדל לעיבוד היא |
responseDateTimeRenderOption |
קובע את אופן העיבוד של תאריכים, שעות ומשכי זמן בתגובה. המערכת תתעלם מהמאפיין הזה אם הערך של |
גוף הבקשה
גוף הבקשה מכיל מופע של ValueRange
.
גוף התשובה
התגובה כשמעדכנים טווח ערכים בגיליון אלקטרוני.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
שדות | |
---|---|
spreadsheetId |
הגיליון האלקטרוני שעליו בוצעו העדכונים. |
tableRange |
הטווח (בסימון A1) של הטבלה שאליו מצורפים הערכים (לפני שהערכים נוספו). העמודה ריקה אם לא נמצאה טבלה. |
updates |
מידע על העדכונים שהוחלו. |
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של 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 |
עבור הנתונים החדשים יתווספו שורות. |