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

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

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

ריכזנו כאן רשימה של מונחים נפוצים שמופיעים ב-Sheets API:

גיליון אלקטרוני

האובייקט הראשי ב-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 של הגיליון האלקטרוני. מזהי הגיליונות לא משתנים, גם אם שם הגיליונות משתנה. דוגמה לכך מופיעה בקטע מזהה הגיליון האלקטרוני.
תא

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

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

הצגת דוגמאות

  • הערך Sheet1!A1:B2 מתייחס לכל התאים בשתי השורות והעמודות הראשונות של גיליון 1.
  • 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' מתייחס לכל התאים בגיליון 'הגיליון המותאם אישית שלי'.

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

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

הצגת דוגמאות

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

  • למידע נוסף על פיתוח באמצעות ממשקי Google Workspace API, כולל טיפול באימות ובהרשאה, אפשר לעיין במאמר פיתוח ב-Google Workspace.

  • במאמר תחילת השימוש ב-JavaScript מוסבר איך מגדירים אפליקציה של Sheets API ומריצים אותה.