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