סקירה כללית על Google Sheets API

‫Google Sheets API הוא ממשק RESTful שמאפשר לקרוא ולשנות נתונים בגיליון אלקטרוני. ‫Sheets API מאפשר לכם:

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

בהמשך מפורטת רשימה של מונחים נפוצים שקשורים ל-Sheets API:

Spreadsheet

האובייקט הראשי ב-Google Sheets. הוא יכול להכיל כמה תגי Sheets, כל אחד עם מידע מובנה שמופיע בתוך Cells. מקור המידע spreadsheets מייצג גיליון אלקטרוני. הוא מכיל ערך ייחודי של spreadsheetId.

מזהה הגיליון האלקטרוני
המזהה הייחודי של גיליון אלקטרוני. זו מחרוזת מסוימת שמכילה אותיות, מספרים ותווים מיוחדים מסוימים, שמפנה לגיליון אלקטרוני. אפשר להפיק אותה מכתובת ה-URL של הגיליון האלקטרוני. המזהים של הגיליונות האלקטרוניים הם קבועים, גם אם השם של הגיליון האלקטרוני משתנה.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
גיליון

דף או כרטיסייה בגיליון אלקטרוני. מקור המידע Sheets מייצג גיליון. הוא מכיל ערך מספרי ייחודי sheetId וגיליון title כחלק מהאובייקט SheetProperties.

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

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

שיטת הסימון A1
תחביר שמשמש להגדרת תא או טווח תאים באמצעות מחרוזת שמכילה את שם הגיליון בתוספת הקואורדינטות של תא ההתחלה ותא הסיום, תוך שימוש באותיות של העמודות ובמספרים של השורות. השיטה הזו היא הכי נפוצה ושימושית כשמפנים לטווח מוחלט של תאים.
  • ‫Sheet1!A1:B2 מתייחס לכל התאים בשתי השורות והעמודות הראשונות של Sheet1.
  • ‫Sheet1!A:A מתייחס לכל התאים בעמודה הראשונה של Sheet1.
  • ‫Sheet1!1:2 מתייחס לכל התאים בשתי השורות הראשונות של Sheet1.
  • ‫Sheet1!A5:A מתייחס לכל התאים בעמודה הראשונה של גיליון 1, משורה 5 ואילך.
  • ‫A1:B2 מתייחס לכל התאים בשתי השורות והעמודות הראשונות של הגיליון הראשון שגלוי.
  • ‫Sheet1 מתייחס לכל התאים בגיליון 1.
  • ‫'Jon's_Data'!A1:D5 מתייחס לכל התאים בחמש השורות הראשונות ובארבע העמודות הראשונות של גיליון בשם Jon's_Data.
  • ‫'My Custom Sheet'!A:A מתייחס לכל התאים בעמודה הראשונה של גיליון שנקרא My Custom Sheet.
  • ‫'My Custom Sheet' מתייחס לכל התאים בגיליון 'הגיליון המותאם אישית שלי'.

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

טיפ: אם אפשר, כדאי להשתמש בשמות שונים לאובייקטים בגיליונות האלקטרוניים. לדוגמה, A1 (ללא מרכאות) מתייחס לתא A1 בגיליון הראשון שגלוי. ‫'A1' מתייחס לגיליון בשם A1. באופן דומה, Sheet1 מתייחס לגיליון בשם Sheet1. אבל אם יש טווח תאים בעל שם שנקרא Sheet1, אז Sheet1 מתייחס לטווח התאים בעל השם ו-'Sheet1' מתייחס לגיליון.

שיטת הסימון R1C1
תחביר שמשמש להגדרת תא או טווח של תאים באמצעות מחרוזת שמכילה את שם הגיליון בתוספת הקואורדינטות של תא ההתחלה ותא הסיום, באמצעות מספרי שורות ומספרי עמודות. השיטה הזו פחות נפוצה מסימון A1, אבל היא יכולה להיות שימושית כשמפנים לטווח של תאים ביחס למיקום של תא נתון.
  • ‫Sheet1!R1C1:R2C2 מתייחס לשני התאים הראשונים בשתי השורות העליונות של Sheet1.
  • ‫R1C1:R2C2 מתייחס לשני התאים הראשונים בשתי השורות העליונות של הגיליון הראשון שמוצג.
  • ‫Sheet1!R[3]C[1] מתייחס לתא שנמצא שלוש שורות מתחת לתא הנוכחי ועמודה אחת מימין לו.
טווח תאים בעל שם
תא מוגדר או טווח תאים מוגדר עם שם מותאם אישית כדי לפשט את ההפניות באפליקציה. מקור מידע מסוג FilterView מייצג טווח עם שם.
טווח תאים מוגן
תא או טווח תאים מוגדרים שלא ניתן לשנות. מקור מידע מסוג A ProtectedRange מייצג טווח תאים מוגן.