סקירה כללית על 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 מתייחס לכל התאים בשתי השורות הראשונות של גיליון 1.
  • 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] מתייחס לתא שנמצא מתחת ל-3 שורות ועמודה אחת מימין לתא הנוכחי.
טווח תאים בעל שם
תא או טווח מוגדרים של תאים עם שם מותאם אישית, כדי לפשט את ההפניות בכל האפליקציה. משאב FilterView מייצג טווח בעל שם.
טווח מוגן
תא מוגדר או טווח של תאים שאי אפשר לשנות. המשאב ProtectedRange מייצג טווח תאים מוגן.
  • למידע נוסף על פיתוח באמצעות ממשקי Google Workspace API, כולל טיפול באימות והרשאה, אפשר לעיין במאמר פיתוח ב-Google Workspace.

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